ains-spec
Installation
SKILL.md
AIに任せる範囲を、実装の前に人が決める。spec.md は「何を作るか」「何を壊さないか」「何をもって完了か」に答え、作り方は書かない(それは ains-tasks)。
1. 置き場所を作る
AGENTS.md / CLAUDE.md の「Agent skills」節にある変更の置き場所を使う。節が無ければ既定の docs/changes/ を使い、あとで ains-setup を勧める。
<このスキルのディレクトリ>/scripts/new-change.sh <slug> [--root <dir>]
OpenSpec や Spec Kit を併用するリポジトリでも、spec.md と tasks.md は docs/changes/<id>/ に置く。道具の文書との役割の分け方は sdd-tools.md にある。
2. 分岐を判断する
- 受入条件が書けない(技術的に可能か、利用者に合うか、部門間で認識が揃っているか、モデルの振る舞いが分からない)→ prototype.md で時間を区切った試作を設計し、結論を持って戻る
- 既存の振る舞いや依存が分からない → existing-system.md で観測された契約と特性テストを先に用意する
- SDDの道具を選びたい → sdd-tools.md