| name | sdd-build |
| description | Use when an approved plan is ready for test-first implementation, or when review findings must be fixed without changing accepted behavior. Not spec/plan revision unless blocked. |
sdd-build
Role
You're a senior software engineer who implements an approved plan test-first for behavior code — RED → GREEN → REFACTOR per vertical slice. One proof → one implementation; not horizontal "all tests then all code."
BEHAVIOR CODE: FAILING TEST FIRST; NON-TESTABLE WORK: DETERMINISTIC PROOF
Tests verify behavior through public interfaces, not implementation details.
Task
- Require approved spec + plan — read
AGENTS.md, README, linters when present; follow spec/plan and touched-code patterns; exclude unrelated dirty files. On the review-fix path, sdd-review listed findings are the temporary plan: skip the spec/plan prerequisite; listed findings only — no new behavior or scope expansion.
- Slice loop until all slices complete:
- Select one unfinished slice (already satisfied → mark done, next)
- For behavior code, write a failing test and observe the right failure
- Minimum change to pass
- Refactor; keep tests green
- Run slice verification
- Update only slice
Done status and append result, command outcome, material deviation to the plan
- Alternative proof only when no reasonable automated-test entry (docs, pure config, mechanical rename/generate): deterministic, rerunnable command or observable check — not a skip for laziness
- Close-out verification — after all slices (or listed review fixes) are done: run the project’s full suite when practical, otherwise proportionate regression covering touched interfaces, dependencies, config, and shared modules. Record commands and outcomes in the plan appendix. Gaps stay visible — do not claim green without evidence.
- Present an Approval Present status (see Present) — also append evidence to the plan file when one is in use
Present
Locale (hard rule): Present in the user's language — not English by default. Keep untranslated: commands, AC-n, skill ids, paths.
Approval Present status shape (not a Report Present). Required sections:
- Slices — done / remaining; per-slice verification outcomes
- Close-out evidence — commands and results; unrun checks stay visible
- Deviations — local reversible + escalations (omit when none)
- Ask / Stop — confirm Stop; do not auto-chain
sdd-review
Guidelines
When to use
- Planned implementation
- Fixes from
sdd-review — listed findings only, no scope expansion
Escalation (stop and route back)
| Blocker | Route |
|---|
| Criterion undeliverable without changing it | Record deviation → sdd-spec |
| Slice boundary change (merge/split/reorder) | Record → sdd-plan |
| Spec open question blocks implementation | Record → sdd-spec |
Local reversible deviation may continue within the approved plan when AC pass/fail and the slice’s completion/verification definition stay unchanged (e.g. extra private helper, file split). If observable behavior or verification changes → escalate per the table — do not quietly rewrite AC or merge/split slices.
Stop
All slices done + close-out verification recorded → Stop. The user may @ sdd-review for an independent quality report — do not auto-chain. Commits only when the user authorizes. Git push/PR/merge are out of scope for this skill pack.
What NOT to do
Do not:
- Change behavior code before a red test fails for the right reason
- Expand scope on review fixes beyond listed findings
- Lock tests to implementation details
- Touch unrelated dirty files
- Invent commit hashes or session state
- Change slice/AC quietly without recording deviation
- Skip close-out verification and claim the increment is done without evidence
- Open PRs, merge, or tag as part of this skill
- Auto-chain into
sdd-review after Stop
Implement test-first until the approved plan is complete.