You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Skill files are located under `skills/` and are written so coding agents such as Codex and Claude Code
39
39
can use them as slash-command style workflows.
@@ -120,3 +120,24 @@ CGO_ENABLED=1 go test -tags "fts5" ./... -count=1
120
120
121
121
For documentation-only changes, prioritize regenerating docs with `ccg docs` and running `ccg lint`.
122
122
Code tests may be skipped depending on the change scope.
123
+
124
+
## Skill Routing
125
+
126
+
- When writing, modifying, or reviewing code, apply `coding-quality-guardrails` as the quality gate.
127
+
- When debugging bugs, regressions, flaky behavior, or failing tests, use `diagnosing-bugs` before changing behavior.
128
+
- Before implementing new logic with branching, side effects, resource lifecycles, or ordering constraints, use `flow-design` and keep the design note in the task workspace.
129
+
- When designing module boundaries, refactoring, or shaping interfaces, use `codebase-design`.
130
+
- When aligning terminology or modeling the domain, use `domain-modeling`.
131
+
- When a plan is fuzzy, high-impact, or lacks testable acceptance criteria, use `planning-grill` to sharpen scope, acceptance, and failure modes before decomposing it.
132
+
- For multi-step or multi-agent work, use `decompose-and-dispatch` to split the work into bounded units. Use `execute-dispatch-unit` only for a clearly assigned unit with scope, dependencies, and verification.
133
+
- When preparing context for human or AI code review, use `ready-code-review`; do not use it to perform the review itself.
134
+
- To record a session, distill completed work into a replayable recipe, or replay a `recipe.yaml`, use `session-recipe`.
135
+
136
+
## agent-team Routing
137
+
138
+
agent-team bundles its own skills; restrict them as follows so methodology stays single-sourced:
139
+
140
+
- Use only agent-team's CLI operation skills (the `agent-team-*` prefix: run/task/message/inbox/sync/event commands), and load `agent-team-shared` before any command-specific one — it defines the state directory, global flags, and error handling they all assume. Never use its `recipe-*` and `persona-*` skills — the skills routed above own all methodology, even where an excluded skill looks like a closer match (worker checkpoints → `execute-dispatch-unit`'s Ledger Checkpoints; plan sharpening / `recipe-agent-team-planning-grill` → `planning-grill`; decomposition → `decompose-and-dispatch`; architecture → `codebase-design`; terminology → `domain-modeling`).
141
+
- When executing an assigned unit, follow `execute-dispatch-unit` for scope, verification, and reporting; its Ledger Checkpoints section defines which `agent-team-*` calls to make.
142
+
- When planning, `decompose-and-dispatch` owns decomposition and executor mapping, and its Durable Ledger section defines the run/task registration calls.
143
+
- Do not route by the word "recipe": here it means a replayable session recipe (`session-recipe`, `recipe.yaml`); agent-team's `recipe-*` skills are excluded above.
0 commit comments