diff --git a/AGENTS.md b/AGENTS.md index 674d322..9e876c9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -56,7 +56,7 @@ claude plugin install colgrep-mcp-dev@cracking-shells # from CrackingShells/Ne | `server/tests/` | pytest suite against `fake_colgrep.py`; `test_manifests.py`, `test_version.py`, `test_changelog.py`, `test_readme.py`, `test_dev_plugin.py` are drift guards; `e2e/run_e2e.py` drives the real binary (not collected by pytest) | implementers | | `server/pyproject.toml` | the only version source, dependencies, `[tool.commitizen]`, `[tool.ruff]`, pytest config | `cz bump` for the version; humans/agents for the rest | | `plugin.json`, `mcp.json`, `.claude-plugin/`, `.agents/` | product plugin manifests for the three ecosystems; Codex reads the root `plugin.json` and its `extensions["com.openai"]` block rather than a directory of its own; each MCP config (`.claude-plugin/mcp.json`, `mcp.json`) launches `uvx colgrep-mcp==`; `version` fields and the pins are written by `cz bump` only | launcher/packaging changes | -| `colgrep-mcp.spec.json` | the spec the manifests above are regenerated from, by the playbook's `spawning-agent-plugins` generator. Declares hub mode (`marketplace.hub` names `CrackingShells/Nest`), so regenerating writes no marketplace file here. Must stay byte-identical to the playbook's `assets/examples/colgrep-mcp.spec.json`: that copy is what the playbook's regeneration guard measures against this repo, so a divergence leaves the guard green while measuring a spec nobody uses | maintainers, in lockstep with the playbook's copy | +| `colgrep-mcp.spec.json` | the spec the manifests above are regenerated from, by Pinion's `spawning-agent-plugins` generator (the skill moved there from the playbook). Declares hub mode (`marketplace.hub` names `CrackingShells/Nest`), so regenerating writes no marketplace file here. Must stay byte-identical to Pinion's `skills/spawning-agent-plugins/assets/examples/colgrep-mcp.spec.json`: that copy is what the skill's regeneration guard measures against this repo, so a divergence leaves the guard green while measuring a spec nobody uses | maintainers, in lockstep with the playbook's copy | | `skills/colgrep-search/SKILL.md` | the end-user skill that teaches agents when to use the tools | when tool semantics change | | `hooks/` | the plugin hooks: `hooks.json` (events every hook-capable harness knows), one `.json` per event not every harness knows (`worktree-remove.json`), `colgrep_policy.py` (one stdlib script serving all events); pinned by `server/tests/test_hooks.py` | when the search policy or the harness wiring changes | | `dev/` | the `colgrep-mcp-dev` plugin: `skills//` (SKILL.md, `references/`, `scripts/`), `evals/-triggers/case.yaml`; versioned by `cz bump` with the product | maintainers, when a cycle learns something |