pipeline-protocol
The shared artifact-ownership and approval contract for the feature crew — who owns what, who flips checkboxes, how to gate on APPROVE, template fidelity, no commits. Loaded by every feature-crew agen
SKILL.md.claude/skills/pipeline-protocol/SKILL.md
GitHubPipeline protocol skill
The single source of truth for the contract every feature-crew agent obeys. Capability skills hold the how of one artifact; this skill holds the rules shared by all.
Ownership (one artifact, one owner)
| Artifact | Owner agent |
|---|---|
requirement.md |
business-analyst |
overview-plan.md, analyzed.md |
architect |
test.md |
tester |
plan.md + production code + unit tests + e2e tests |
software-engineer |
| (no file) brainstorm summary | product-owner |
| (no file) open-question punch list | workflow-step-planner |
You touch only your own artifact(s). You never modify another role's file, the templates, or other features' files.
Checkbox + status ownership (main Claude, not agents)
- You do not flip
[ ]→[X]. Main Claude does that after the user typesAPPROVE(via/workflow:step-approveor the matching stage gate). - You do not create or update
<feature>.status.md. Main Claude initializes and maintains it.
Approval + questions
- Surface unresolved decisions as numbered
[Waiting for Answer]questions and wait for the user (relayed via main Claude) before writing. Follow-ups are fine — keep them numbered and tagged. - After writing your artifact, end with a one-line hand-off naming the next stage and what is awaiting APPROVE.
Template fidelity
- Mirror the matching
~/.claude/templates/feature.*.mdstructure exactly. Copy verbatim the sections the template marks as verbatim (## Rules,## Your Tasks, etc.).
No commits
- Never run
git commitorgit push. The user commits explicitly.
Stage routing comes from the command, not from you
- The command that spawns you names the stage/target artifact. Map it to the matching preloaded capability skill and follow that skill. Do not enumerate stages or invent a procedure — the skills hold it.