菜单
Runs the feature design stage: goal-sheet intake (/belt:goal) followed by a design document (architecture + key decisions) reviewed by belt:spec-reviewer. Use standalone for design-only work, or composed as the first stage of /belt:feature-dev. Task breakdown lives in the plan stage (/belt:plan), not here. --codex enables adversarial spec review.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Experimental (mattpocock/skills wayfinder port, MIT). Charts a foggy effort as a shared Linear decision map, resolves its decision tickets across bounded sessions, and hands one graduated effort to /belt:requirements. Upstream of /belt:feature-dev; one run graduates exactly one effort.
Runs the shared build stage: TDD implementation from the plan document's task list and two-agent code review with autonomous triage. Use standalone with an existing plan.md/fix-plan.md, or composed as the build stage of /belt:feature-dev and /belt:bug-fix. QA runs as its own stage (/belt:qa) after build; integration happens at the orchestrator's integrate phase.
Runs the bug diagnosis stage: root-cause analysis with a failing reproduction test and reproduction scenarios, fix planning, and adversarial plan review. Use standalone for diagnosis-only work, or composed as the upstream stage of /belt:bug-fix. --codex enables adversarial plan review.
Quality-gated feature pipeline from ticket to integration: goal-sheet intake, design document with spec review, implementation plan with QA scenarios, context-reset checkpoint, TDD implementation, autonomous code review, mandatory QA with human-readable evidence (screenshots / transcripts), and integration with evidence publishing. Accepts a Linear id, URL, free text, or a requirements.md path. --codex enables adversarial review.
Runs the implementation planning stage: writes plan.md (test strategy + task list) and scenarios.yml (QA replay scenarios) from an approved design.md, then reviews the plan via belt:spec-reviewer. Use standalone when a design already exists, or composed between the design and build stages of /belt:feature-dev. --codex enables adversarial plan review.
Interview-driven requirements definition. Resolves a Linear ticket, URL, or free-text request, investigates the codebase, asks only human-decidable questions in dependency-ordered rounds until the frontier is empty, and writes docs/requirements/<YYYY-MM-DD-topic>/requirements.md reviewed by belt:spec-reviewer. The result feeds /belt:feature-dev as input.
| name | design |
| description | Runs the feature design stage: goal-sheet intake (/belt:goal) followed by a design document (architecture + key decisions) reviewed by belt:spec-reviewer. Use standalone for design-only work, or composed as the first stage of /belt:feature-dev. Task breakdown lives in the plan stage (/belt:plan), not here. --codex enables adversarial spec review. |
| user-invocable | true |
| argument-hint | <linear-id | url | free-text> [--codex] |
Belt pipeline for the design stage. Structure, gates, and done criteria
live in pipeline.yml; this file defines how to execute each phase.
The invoke is declared in pipeline.yml. Pass the user's original
input (ticket id, URL, free text, or a requirements.md path) verbatim
as the skill argument. The skill writes goal-sheet.md and evidence.md.
This phase has no invoke — execute these steps directly:
belt-agent status,
artifact goal_sheet).belt-agent:explorer subagents (focus: flow or patterns) only if
the area is unfamiliar AND spans 10+ files.docs/features/<topic>/design.md with exactly these sections:
## Architecture — approach, components, data flow## Key Decisions — each decision with a one-line rationale;
rejected alternatives in one line each
No task list and no test strategy here — both live in plan.md
(/belt:plan).plugins/belt-agent/references/authoring-principles.md).The invoke is declared in pipeline.yml; pass the design.md path as
the review target. Complete the review's batched triage, then append
the design-review entry to evidence.md.
docs/features/<topic>/ after a phase
completes (breaks the phase-start mtime filter)../references/path-convention.md — docs/features/<YYYY-MM-DD-topic>/ naming rules (SSOT)plugins/belt-agent/references/authoring-principles.md — evidence entry format