From 8b7df96369f8ada4b355459edbb8c425e7bb3ecf Mon Sep 17 00:00:00 2001 From: Stef Kariotidis Date: Thu, 27 Aug 2026 19:10:00 +0300 Subject: [PATCH 1/2] WIP: clarify agent skill activation prompt (checkpoint) --- README.md | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index e52cfee..aeeb7b3 100644 --- a/README.md +++ b/README.md @@ -68,16 +68,21 @@ environment, uv, and developer alternatives. Copy this prompt to a coding agent: -> Consult the official Agent Code Guard repository and documentation. Install -> the published distribution in an isolated supported way, preferably with -> pipx; verify `code-guard --version` and run `code-guard doctor`. Locate the -> installed version-matched skill with `code-guard --skill-path`, and use or -> export only that skill through the documented mechanism. Inspect this -> repository without creating a LOC baseline and use changed-work scope. Ask -> before exporting into a persistent skill directory, changing persistent -> agent or platform configuration, or configuring hooks. -> Never weaken thresholds, exclusions, configuration, or baselines merely to -> silence findings. +> Adopt Agent Code Guard for this repository using the official project and +> documentation at https://github.com/stef-k/agent-code-guard. This prompt +> authorizes installing the published distribution in an isolated supported +> way, preferably with `pipx install agent-code-guard`, and persistently +> activating or exporting its installed, version-matched skill for the current +> agent environment. Verify `code-guard --version` and run `code-guard doctor`, +> then locate the skill with `code-guard --skill-path` and follow the documented +> activation or export mechanism. Do not create a LOC baseline. After meaningful +> source or Markdown edits, run +> `code-guard . --changed-only --json --json-mode compact`; outside Git, pass the +> exact edited files. Inspect REVIEW and FAIL findings, make only genuine +> improvements, rerun the check, and report the result. Never weaken thresholds, +> exclusions, configuration, or baselines merely to silence findings. Code Guard +> does not install hooks; ask before configuring any hook or making unrelated +> persistent agent or platform changes. ## Five-minute start From 02d0eee42b5f075c6091527cc9aa761b506d2bca Mon Sep 17 00:00:00 2001 From: Stef Kariotidis Date: Thu, 27 Aug 2026 19:10:26 +0300 Subject: [PATCH 2/2] Clarify agent adoption prompt --- README.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index aeeb7b3..33652e7 100644 --- a/README.md +++ b/README.md @@ -74,15 +74,22 @@ Copy this prompt to a coding agent: > way, preferably with `pipx install agent-code-guard`, and persistently > activating or exporting its installed, version-matched skill for the current > agent environment. Verify `code-guard --version` and run `code-guard doctor`, -> then locate the skill with `code-guard --skill-path` and follow the documented -> activation or export mechanism. Do not create a LOC baseline. After meaningful -> source or Markdown edits, run +> then locate the skill with `code-guard --skill-path`. Follow the +> [skill activation guide](https://github.com/stef-k/agent-code-guard/blob/main/docs/skill-distribution.md): +> activate that installed path when the platform supports it, or export it with +> `code-guard --export-skill ` to the platform's documented +> skill directory. Do not guess a target or overwrite an existing export; verify +> that `.agent-code-guard-version` matches the installed distribution. Follow the +> [agent workflow](https://github.com/stef-k/agent-code-guard/blob/main/docs/agent-workflow.md) +> without creating a LOC baseline. After meaningful source or Markdown edits, run > `code-guard . --changed-only --json --json-mode compact`; outside Git, pass the > exact edited files. Inspect REVIEW and FAIL findings, make only genuine > improvements, rerun the check, and report the result. Never weaken thresholds, > exclusions, configuration, or baselines merely to silence findings. Code Guard -> does not install hooks; ask before configuring any hook or making unrelated -> persistent agent or platform changes. +> does not install or enable hooks by default. Ask before configuring a post-edit +> or post-turn hook, or making unrelated persistent agent or platform changes. +> Finish by reporting the installed version, doctor status, activated skill +> location, first analysis result, and any REVIEW findings you accepted. ## Five-minute start