Menu
Review an ai-sdd changeset against the feature plan and this repo's conventions, and emit a blocking verdict artifact.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | review-feature |
| description | Review an ai-sdd changeset against the feature plan and this repo's conventions, and emit a blocking verdict artifact. |
Read .ai-sdd/artifacts/feature-plan.v1.yaml, .ai-sdd/artifacts/changeset.v1.yaml, and
.ai-sdd/conventions/<stack>.md (this slice's vertical). Inspect the diff and the relevant
source/tests.
Write .ai-sdd/artifacts/review.v1.yaml with:
items: one entry for every plan acceptance id, each { id, verdict, notes } where verdict
is pass or fail. (The review.coverage gate enforces that every acceptance id appears here.)verdict: approve only when every item passes AND the conventions/boundary rules are
satisfied; otherwise reject.rework: required on reject, each entry naming the indicted input schema:
target: changeset.v1 for an implementation defect (routes to the implementer).target: feature-plan.v1 for a plan/acceptance-contract defect (routes to the planner).You must reject if any acceptance item is unmet or any boundary rule is violated — in particular:
contracts;TelemetrySource/VisionSource
interfaces;.ai-sdd/schemas/examples/*.json.Do not approve when an acceptance item is unjudged. review.structure is the blocking verdict gate:
all items pass + overall approve, or the engine routes rework to the producer you indict.
Update the ai-sdd framework binary + skills to the latest release — an apply-on-confirm wrapper that runs `ai-sdd update --check`, surfaces the current-to-latest version transition, and (only on explicit confirmation) runs `ai-sdd update` and lands a standalone reseed commit. Agent-agnostic (claude-code or codex). Use when a teammate wants to update / upgrade ai-sdd, sees the update-available notice, or invokes `/ai-sdd-update`.
Stand up (or refresh) an ai-sdd factory for a repository so any coding agent — claude-code, codex, … — can drive it. Discovers the repo's conventions, scaffolds the .ai-sdd/ home, authors worker skills + schemas, compiles the deterministic gates, and wires provider-neutral skill surfacing (AGENTS.md + per-agent symlinks). Use when onboarding a repo to ai-sdd or re-bootstrapping after the codebase/conventions drift.
Drive a software-factory run by dispatching a sub-agent per worker — the deterministic `ai-sdd` engine plans (next), a fresh sub-agent does each worker's work via its skill, the engine gates and advances (submit), and each completed slice is committed. Agent-agnostic (claude-code or codex). Use when asked to run, drive, continue, or advance a factory run / pipeline / orchestration, or when the user mentions `ai-sdd next` / `ai-sdd submit`.
Print the diagram-driven ai-sdd workflow cheatsheet — the canonical command sequence (bootstrap → plan → run, validate/next/submit/status) that travels with the binary. Use when a user forgets which command comes next, asks "how do I drive a run / what's the workflow", or needs the command reference without leaving the repo.
Turn a complete PROGRAM brief into a runnable master plan — a decision-closed program requirements doc and a master orchestration graph whose nodes are whole sub-features (kind:pipeline) sequenced by milestone validation gates with owners. The program tier above ai-sdd-plan. Requires a real program brief (refuses a one-liner) and human approval of the program requirements draft before emitting the graph. Use when planning a multi-feature, multi-person project in a bootstrapped repo (run ai-sdd-bootstrap first); each sub-feature is then planned with ai-sdd-plan. Re-run on an existing program to amend it in place (create-vs-amend is auto-detected from disk): append sub-features/milestones and rewire pending nodes; a started node (completed or in-flight) is immutable and corrected forward with a downstream `<node>-revert` node.
Turn a complete feature brief into a runnable plan for a bootstrapped repo — a decision-closed requirements doc and an orchestration graph (slices + depends_on) the engine executes. Requires a real brief (refuses a bare one-liner — asks for one) and human approval of the requirements draft before generating slices. The planning layer between an idea and ai-sdd-run. Use when starting a new feature in a repo that already has a .ai-sdd/ (run ai-sdd-bootstrap first). Re-run on an existing feature to amend it in place (create-vs-amend is auto-detected from disk): append slices and rewire pending ones; a started slice (completed or in-flight) is immutable and corrected forward with a downstream `<slice>-revert` slice.