implement-plan-preflight

Plan の事前確認を実施する

/itp:go ワークフローの事前確認フェーズを実行します。適切な相互リンクと検証を備えた ADR と設計仕様の成果物を作成します。

自己進化型スキル：このスキルは使用を通じて改善されます。手順に誤りがある、パラメーターがずれている、または回避策が必要だった場合は、先送りせず、すぐにこのファイルを修正してください。実際に再現可能な問題がある場合にのみ更新してください。

このスキルを使用する場合

• 事前確認フェーズ中に /itp:go コマンドから呼び出された場合
• ユーザーが機能の ADR 作成を依頼した場合
• ユーザーが「設計仕様」または「MADR 形式」に言及した場合
• 手動での事前確認が必要な場合

事前確認ワークフローの概要

P.1: Create Feature Branch (if -b flag)
         │
         ▼
P.2: Create ADR File (MADR 4.0)
         │
         ▼
P.3: Create Design Spec (from global plan)
         │
         ▼
P.4: Verify Checkpoint (MANDATORY)

重要：事前確認のすべての手順が完了し、検証されるまで、フェーズ 1 の実装に進まないでください。

---

クイックリファレンス

ADR ID の形式

YYYY-MM-DD-slug

例：2025-12-01-clickhouse-aws-ohlcv-ingestion

ファイルの場所

成果物	パス
ADR	/docs/adr/$ADR_ID.md
設計仕様	/docs/design/$ADR_ID/spec.md
グローバルプラン	~/.claude/plans/<adj-verb-noun>.md

相互リンク（必須）

ADR ヘッダー内：

**Design Spec**: [Implementation Spec](/docs/design/YYYY-MM-DD-slug/spec.md)

spec.md ヘッダー内：

**ADR**: [Feature Name ADR](/docs/adr/YYYY-MM-DD-slug.md)

---

実行手順

ステップ P.1：機能ブランチを作成する（任意）

-b フラグが指定されている場合にのみ実行します。詳細はワークフローの手順を参照してください。

ステップ P.2：ADR ファイルを作成する

1. /docs/adr/$ADR_ID.md を作成します
2. ADR テンプレートのテンプレートを使用します
3. セッションのコンテキストからフロントマターを入力します
4. 視点の分類体系から視点を選択します

ステップ P.3：設計仕様を作成する

1. フォルダーを作成します：mkdir -p docs/design/$ADR_ID
2. グローバルプランをコピーします：cp ~/.claude/plans/<adj-verb-noun>.md docs/design/$ADR_ID/spec.md
3. spec ヘッダーに ADR へのバックリンクを追加します

ステップ P.4：チェックポイントを検証する

バリデーターまたは手動チェックリストを実行します：

uv run scripts/preflight_validator.py $ADR_ID

チェックリスト（すべて満たす必要があります）：

• ADR ファイルが /docs/adr/$ADR_ID.md に存在する
• ADR に必須の 7 フィールドをすべて含む YAML フロントマターがある
• ADR のヘッダーに **Design Spec**: リンクがある
• 図のチェック 1：ADR に変更前／変更後の図がある（コンテキストセクション）
• 図のチェック 2：ADR にアーキテクチャ図がある（アーキテクチャセクション）
• 設計仕様が /docs/design/$ADR_ID/spec.md に存在する
• 設計仕様のヘッダーに **ADR**: バックリンクがある

項目が不足している場合：今すぐ作成してください。フェーズ 1 に進まないでください。

---

YAML フロントマターのクイックリファレンス

---
status: proposed
date: YYYY-MM-DD
decision-maker: [User Name]
consulted: [Agent-1, Agent-2]
research-method: single-agent
clarification-iterations: N
perspectives: [Perspective1, Perspective2]
---

各フィールドの詳細な説明はADR テンプレートを参照してください。

---

図の要件（図が 2 つ必要）

⛔ 必須：すべての ADR には、必ず 2 つの図のみを含めてください。

図	場所	目的
変更前／変更後	コンテキストセクション	システム状態の変化を示す
アーキテクチャ	アーキテクチャセクション	コンポーネント間の関係を示す

進行を阻止するゲート：両方の図を ADR に埋め込むまで、設計仕様に進まないでください。

---

参考ドキュメント

• ADR テンプレート - MADR 4.0 の完全なテンプレート
• 視点の分類体系 - 11 種類の視点
• ワークフローの手順 - 詳細な手順ガイド

---

検証スクリプト

# Verify preflight artifacts
uv run scripts/preflight_validator.py <adr-id>

# Example
uv run scripts/preflight_validator.py 2025-12-01-my-feature

---

トラブルシューティング

問題	原因	解決策
バリデーターが失敗する	ADR または仕様書がない	バリデーターを実行する前に両方のファイルを作成する
フロントマターが無効	必須フィールドがない	ADR の 7 つのフィールドと仕様書の 5 つのフィールドをすべて確認する
仕様書のフェーズが一致しない	フェーズの値が間違っている	preflight、phase-1、phase-2、または phase-3 を使用する
ADR のステータスが間違っている	ステータスを手動で編集した	ステータスの遷移はワークフローに任せる
デザインフォルダーがない	パス構造が間違っている	docs/design/YYYY-MM-DD-slug/spec.md を使用する

実行後の振り返り

このスキルの実行完了後、終了する前に次の点を確認してください。

1. コマンドは成功しましたか？ — 成功しなかった場合は、失敗の原因となった指示またはエラーテーブルを修正してください。
2. パラメーターや出力に変更はありましたか？ — 基盤となるツールのインターフェースに変更があった場合は、それに合わせて使用例とパラメーターテーブルを更新してください。
3. 回避策が必要でしたか？ — 即興で対応した場合（別のフラグや追加の手順など）は、次回同じ回避策が必要にならないように、この SKILL.md を更新してください。

問題が実際に発生し、再現可能な場合にのみ更新してください。推測に基づく問題は対象外です。