chore: add role agent definitions with pinned models (refs #248)
Deploy to Staging / Build Images (pull_request) Successful in 4m33s
Deploy to Staging / Deploy to Staging (pull_request) Successful in 45s
Deploy to Staging / Verify Staging (pull_request) Successful in 3s
Deploy to Staging / Notify Staging Failure (pull_request) Skipped
Deploy to Staging / Notify Staging Ready (pull_request) Successful in 3s

Adds five role agents under .claude/agents/, each pinned to a model in
frontmatter (sonnet for developer/debugger/operator/tech-writer, opus
for quality-reviewer) and directed to read the relevant mvp-* skills
before acting. Replaces the model enforcement lost when c239bb9 deleted
enforce-agent-model.sh. Updates .claude/CLAUDE.md and root CLAUDE.md
indexes.

Co-Authored-By: Claude Fable 5 <[email protected]>
This commit is contained in:
Eric Gullickson
2026-08-22 17:54:50 -05:00
co-authored by Claude Fable 5
parent 59fdb85e4e
commit b601dcd5ce
7 changed files with 167 additions and 1 deletions
+13
View File
@@ -4,10 +4,23 @@
| Directory | What | When to read |
| --------- | ---- | ------------ |
| `agents/` | Role subagent definitions with pinned models (see Agents table below) | Delegating work to a subagent; changing a model pin |
| `skills/` | 16 `mvp-*` reusable knowledge skills, one directory each (see Skills table below) | Loading project-specific knowledge before a task |
| `output-styles/` | Output formatting templates (`direct.md`) | Customizing response style |
| `tdd-guard/` | TDD-guard tool state (test/modification tracking data) | Debugging TDD-guard behavior |
## Agents (`agents/`)
Each agent is `agents/{name}.md`; frontmatter pins its model. Agents are role executors - each one's prompt directs it to read the relevant `skills/` SKILL.md files before acting, so skills stay the single source of domain knowledge.
| Agent | Model | Role | Primary skills read |
| ----- | ----- | ---- | ------------------- |
| `developer` | sonnet | Implement scoped code changes, self-gate lint/type-check/tests | mvp-architecture-contract, mvp-change-control |
| `debugger` | sonnet | Root-cause a symptom with evidence; no fixes unless asked | mvp-debugging-playbook, mvp-failure-archaeology |
| `quality-reviewer` | opus | RULE 0/1/2 merge-gate review; read-only toolset | mvp-change-control, mvp-validation-and-qa |
| `operator` | sonnet | Deploys, rollbacks, backups, CI workflow changes | mvp-run-and-operate, mvp-deploy-safety-campaign |
| `tech-writer` | sonnet | Doc-sync and new docs under house style | mvp-docs-and-writing, mvp-launch-readiness |
## Skills (`skills/`)
Each skill is `skills/{name}/SKILL.md`; its frontmatter `description` states exactly when to load it — this table is a condensed pointer, not a substitute for reading it.