preparar-sprint0 について
Preparar Sprint 0は、プロジェクト初期化を範囲が明確で検証可能な計画にまとめるスキルです。開発者とテスター向けに`SPRINT0.md`を作成し、アプリケーションコードは作らずに終了します。
主な機能
- 01ADRを適用範囲別に分類
- 02パスの所有者を定義
- 03検証可能な完了条件を作成
- 04開発者とテスターの作業を計画
- 05未決事項を記録
活用シーン
- 01初期プロジェクト骨格の範囲決め
- 02テスターと開発者の役割調整
- 03基盤の決定と機能開発の切り分け
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ adminoryslabs/ armory --skill preparar-sprint0インストール後、Claude Code で/preparar-sprint0を入力して読み込まれたか確認します。
同梱ファイルassets/sprint0-template.md
詳細
Sprint 0 の準備
Goal
「プロジェクトを初期化する」を範囲が明確で検証可能な作業単位に変換します。ビジネスロジックを含まない、最小限のエンドツーエンドで動作する骨組みです。成果物は 1 つのドキュメント SPRINT0.md で、TESTER と DEV の両者が同じ内容を読みます。
このスキルでは何も構築しません。 準備と提案を行い、そこで停止します。
Input
TECH-DESIGN.mdとadrs/— 必須です。見つからない場合は停止して、提出を依頼します。- プロジェクトの
AGENTS.mdおよび/またはCLAUDE.md— 存在する場合は読み込み、後で更新します(手順 5)。 - HU — 構築のためには読みません。ストーリーに関する各 ADR がどのストーリーに属するかを確認する場合にのみ参照します。
Workflow
-
Tech Design とすべての ADR を読みます。
-
各 ADR を 3 つのカテゴリのいずれかに分類し、理由を 1 行で記します。
- 横断的 — プロジェクトを成立させるために必要です(スタック、構成、API スタイル、ORM、一般的な状態管理)。Sprint 0 で適用します。
- ストーリー固有 — 具体的な機能を実現します。Sprint 0 では適用しません。どの HU に属するかを記録します。
- 混在/要相談 — 横断的な部分とストーリー固有の部分があります。今適用する部分を説明し、人間による確認が必要であることを明記します。 判断の目安:「これはプロジェクトを成立させるために必要か、それとも具体的な機能のために必要か?」
-
実際のプロジェクトスタックに基づいて、ルートの所有範囲を定義します(想定したスタックに基づいてはいけません)。
- TESTER — 選択したテストフレームワークの規約に従ってテストが配置されるルート(およびそのフィクスチャやテストデータ)。
- DEV — アプリケーションのコード、その設定、マイグレーション、依存関係マニフェスト。
- LEAD/人間のみ — ハーネスのファイル:
AGENTS.md、CLAUDE.md、スキルおよびエージェント設定のフォルダー、SPRINT0.md、契約。 どの範囲にも明確に当てはまらないルートは、人間への質問として記します。
-
骨組みの Definition of Done を作成します。 各項目は検証可能で、検証方法(テストまたはコマンド)を記載する必要があります。最低限、次を含めます。
- アプリケーションをローカルで起動できる。
- 横断的な ADR に含まれる場合、主要な依存関係(例:データベース)に接続できる。
- 正確な名前を指定したヘルスチェック手段(例:ルートまたは health コマンド)が存在する。
- テストランナーがインストールおよび設定され、実行できる。
- 横断的な ADR に準拠している。
- ビジネスロジックが一切ない。 正確な名前(ルート、コマンド)を DoD に記載します。これは TESTER と DEV が互いに顔を合わせずに作業できるようにするための最小限の契約です。
-
assets/sprint0-template.mdを使って計画を記述します。DEV が作成するもの、TESTER が作成するもの、そして作成しないもの(ストーリー固有の ADR に属するすべてのもの)を記します。 -
プロジェクトのルートに
SPRINT0.mdを保存し、AGENTS.md(およびCLAUDE.mdも存在する場合はそちら)に、ルートの所有範囲マップを## ルートの所有範囲セクションとして追加します。 -
停止します。 ADR の分類、ルートマップ、DoD、計画、未解決の質問一覧を人間に提示します。誰にも依頼せず、アプリケーションファイルも作成しません。 人間から変更を求められた場合は、
SPRINT0.mdを修正して再提示します。
Constraints
- 些細に見える場合でも、ストーリー固有の ADR は実装しません。
- ADR で定まっていないスタックは選びません。決定が不足している場合は質問として扱います。
- 検証できない DoD 項目は DoD に含めません。
- 何も公開しません(main への push も deploy も行いません)。