| name | agentic-sdd |
| description | swbt-python の Agentic Spec-Driven Development を開始、継続するentry point skill。ユーザが Agentic SDD、次の作業単位、spec/initial からの実装、spec/wip の plan/tasks/implement/gate loop、Intent Delta、TDD と gate を含む進行を求めるときに使う。 |
Agentic SDD
AGENTS.md、spec/initial/*.md、対象の spec/wip を Constitution として読み、次の作業単位を 1 つだけ選んで進める。
Bootstrap
AGENTS.md を読む。
- 関連する
spec/initial/*.md を読む。
- 既存
spec/wip/unit_* と spec/complete/unit_* を確認する。
- 変更を伴う作業では branch と
git status --short を確認する。
- ユーザ入力から Intent Delta を抽出する。なければ
none。
- 実装済み範囲と既存 test を確認する。
- 次の作業単位を 1 つだけ選ぶ。
開始時は短く提示する。
Agentic SDD bootstrap:
- Constitution: AGENTS.md, spec/initial/*
- Git Context:
- Intent Delta:
- Selected Work:
- Non-goals:
- Gates:
- Hardware:
Work Selection
| 候補 | 選択条件 |
|---|
| roadmap milestone | spec/initial/roadmap.md の M0-M7 に沿う作業。 |
| spec TDD item | spec/wip の TDD Test List にある小さい振る舞い。 |
| source audit item | report bytes、subcommand、Bumble、driver 仮定の根拠が必要。 |
| hardware-gated item | Bumble adapter または Switch 実機が必要。 |
| public docs work | README、利用者向け docs、公開 API docstring、release notes の品質確認。 |
- 選択していない milestone、daemon、GUI、複数 controller、amiibo、NFC、IR camera は実装しない。
- 大きい作業は TDD item へ分割する。
- 実機や dongle を使う command は
hardware-harness の承認まで実行しない。
- protocol 値や driver 仮定は
source-audit を通す。
Implementation Loop
- 作業仕様がなければ
spec-format で spec/wip を作る。
- TDD が適する場合は
tdd-workflow を使う。公開文書だけの作業では docs-quality-review と文書検証計画を使う。
- red の理由が期待した失敗であることを確認する。
- green を作る。
- green 後に必要な構造変更だけ
tidy-first と refactor-after-green で分ける。
- gate 失敗時は、Spec、Plan、Tasks、Source audit、Implement のどこへ戻るか決める。
- 終了時は
agentic-self-review で gate と未検証リスクを整理する。
Git Context
- read-only 調査では branch 作成は不要。
- 作業 branch 上で clean ならそのまま進める。
- default branch 上で clean なら、変更前に作業 branch を作るかユーザ指示を確認する。
- dirty worktree では既存変更を読み、ユーザ変更を破棄しない。
- remote 未設定なら
pr-merge-cleanup は PR 作成前に止まる。