feature-planning

機能ワークフロー：実装計画の作成

現在、このスキルを読んでいます

停止してください。他のことをする前に、次の操作を行ってください。

1. ☐ TodoWrite チェックリストを作成します（下記参照）
2. ☐ ステップ 1 を in_progress に設定します
3. ☐ まず CLAUDE.md を読みます（存在する場合）

このスキルは、Z01 コンテキストを読み込み、superpowers:writing-plans を呼び出すラッパーです。

必須の最初の操作：TodoWrite を作成する

TodoWrite({
  todos: [
    {content: "Step 1: Load project context (CLAUDE.md if exists)", status: "in_progress", activeForm: "Reading CLAUDE.md"},
    {content: "Step 2: Verify Z01 files exist", status: "pending", activeForm: "Checking research"},
    {content: "Step 3: Read ALL Z01 files", status: "pending", activeForm: "Loading context"},
    {content: "Step 4: Invoke superpowers:writing-plans", status: "pending", activeForm: "Creating plan"},
    {content: "Step 5: Verify Z02 outputs", status: "pending", activeForm: "Validating output"}
  ]
})

各ステップの後： 完了としてマークし、次のステップを in_progress に設定します。

このラッパーを使う理由

• Z01 → Z02 のファイル管理を自動化します
• CLAUDE.md の制約を計画コンテキストに読み込みます
• feature-workflow の命名規則（Z02_{feature}_plan.md）を適用します
• clarification ワークフロー（Z02_CLARIFY）と連携します
• 一貫したファイル構造を維持します

このラッパーを使わない場合： Z01 ファイルを手動で読み込み、superpowers:writing-plans に渡し、Z02 の出力先を管理し、確認事項をチェックする必要があります。

ワークフローの手順

ステップ 1：プロジェクトコンテキストを読み込む（必須の最初の操作）

CLAUDE.md が存在する場合は読みます。

CLAUDE.md から以下を抽出します（存在する場合）。

• 必ず維持する必要がある必須のパターン
• 避けるべき禁止事項
• プロジェクトの規約（命名、構成など）
• リリースワークフローと制約

重要： CLAUDE.md が存在し、制約が記載されている場合は、プロジェクト標準を計画に反映できるよう、それらを superpowers:writing-plans に渡す必要があります。

---

ステップ 2：Z01 ファイルの存在を確認する

一般的な場所（docs/ai/ongoing、.ai/ongoing、docs/ongoing）にある既存の Z01 ファイルを検索します。

Z01 ファイルが見つかった場合：

• ONGOING_DIR の場所を記録します
• ファイル名から機能名を抽出します（例：Z01_metrics_research.md → "metrics"）
• 機能名は feature-research によって、すでにサニタイズされた snake_case になっているはずです

Z01 ファイルが見つからない場合：

• 先に feature-workflow:feature-researching を実行するか、ユーザーに確認します
• または、調査コンテキストなしで続行します（最適ではありません）

---

ステップ 3：すべての Z01 ファイルを読む

ONGOING_DIR 内のすべての Z01 ファイルを読みます。

• Z01_{feature}_research.md（必須）
• Z01_CLARIFY_{feature}_research.md（存在する場合）

続行を妨げるチェック — Z01_CLARIFY が存在する場合：

• ファイルを読みます
• "User response:" フィールドが空かどうか確認します
• 空のフィールドが1つでもある場合 → 停止して、次のように報告します。 "未回答の質問があるため、計画を作成できません。先に Z01_CLARIFY_{feature}_research.md のすべての質問に回答してください。"
• すべて回答済みの場合 → 続行します

以下を抽出します。

• 技術調査と統合箇所
• ファイルパスと行範囲
• 回答済みの確認事項
• セキュリティとテストの要件

---

ステップ 4：Superpowers Planning を呼び出す

重要： このスキルの主な役割は、Z01 のコンテキストを使って superpowers:writing-plans を呼び出すことです。この呼び出しを省略すると、このスキルは役に立ちません。

Skill ツールを使って superpowers:writing-plans を呼び出します。

次の指示を渡します。

"Z01_{feature}research.md の調査内容と Z01_CLARIFY{feature}_research.md の確認事項に基づいて、{feature} 機能の実装計画を作成してください。

CLAUDE.md に記載された必須の制約： [存在する場合は、CLAUDE.md の制約、パターン、禁止事項を記載してください]

重要：計画を {ONGOING_DIR}/Z02_{feature}_plan.md に保存してください（固定の docs/plans/ ではなく、検出したパスを使用してください）。

計画は、次の内容を含む指示書にしてください。

• 調査で特定された正確なファイルパス
• 完全なコード例
• 各タスクの検証手順
• TDD の構成（テスト失敗-実装-成功-コミット）
• エンジニアがドメイン知識をほとんど持たないことを前提とする

計画中に、Z01_CLARIFY にまだ記載されていない新たな重大な質問が見つかった場合は、{ONGOING_DIR}/Z02_CLARIFY_{feature}_plan.md を作成してください。それ以外の場合は、Z02_CLARIFY ファイルを作成しないでください。

回答済みの質問を反映する場合： 回答済みの CLARIFY ファイルは削除するか、一部のみ回答済みの場合は、反映済みの質問と回答のペアを削除してください。"

---

Step 5: 出力を確認する

superpowers:writing-plans が完了したら：

構成を確認する：

• Z02_{feature}_plan.md が ONGOING_DIR に存在すること（メインの指示計画）
• Z02_CLARIFY_{feature}_plan.md は新しい質問がある場合にのみ存在すること

ユーザーに報告する：

• 「計画を作成しました：Z02_{feature}_plan.md」
• 確認事項がある場合：「Z02_CLARIFY_{feature}_plan.md にブロッキングとなる質問があります」
• 次のステップ：「確認事項を確認してから、feature-workflow:feature-implementing を使用してください」

---

失敗を示す兆候：

• Z01_CLARIFY の未回答の質問があるまま作業を進めた（ブロッキングです。必ず停止してください）
• 最初に CLAUDE.md を読まなかった（存在する場合）
• CLAUDE.md が存在するのに、制約を計画作成に引き継がなかった
• Z01 ファイルを確認しなかった*
• Z01 のコンテキストを読み込まずに superpowers:writing-plans を直接呼び出した
• 標準外の名前で計画ファイルを作成した（Z02_{feature}_plan.md 以外）
• 計画を誤ったディレクトリに保存した
• SlashCommand /superpowers:write-plan を使用した（Skill ツールを使用してください）
• writing-plans へのプロンプトで出力先のパスを明示しなかった
• Z01_CLARIFY を読まなかった（存在する場合）
• ハードコードされたパスを使用した（パターンを検出してください）

よくある自己正当化

言い訳	実際
「パスの検出は省略できます。docs/ai/ongoing だと分かっています」	いいえ。 標準外のリポジトリでは、パスの思い込みが問題になります。ONGOING_DIR を検出してください。
「Z01 ファイルがないので、確認は省略します」	いいえ。 調査コンテキストは質の高い計画に不可欠です。まず確認してください。
「Superpowers が出力構成を判断してくれます」	いいえ。 汎用的な計画では調査内容が適切に反映されません。Z02* に関する明確な指示を与えてください。
「Z01_research だけ読んで、Z01_CLARIFY は省略します」	いいえ。 コンテキストが不足し、計画が不完全になります。すべての Z01* ファイルを読んでください。
「質問がなくても Z02_CLARIFY を作成します」	いいえ。 空のファイルはディレクトリを散らかします。新しい質問がある場合にのみ作成してください。
「superpowers:writing-plans を直接呼び出せばよい」	いいえ。 このラッパーは Z01 のコンテキストを読み込みます。それが役割です。
「ラッパーのスキルだから、手順を追跡する必要はありません」	いいえ。 ラッパーには重要な手順（コンテキストの読み込み、呼び出し）があります。TodoWrite で追跡してください。
「TodoWrite は手間が増えるので、省略します」	いいえ。 TodoWrite はユーザーに進捗を示し、手順の抜けを防ぎます。必須です。

成功基準

次の条件を満たせば、ワークフローに従ったことになります：

• ✓ CLAUDE.md が存在する場合は読んだ
• ✓ CLAUDE.md の制約を superpowers:writing-plans に引き継いだ
• ✓ Z01* ファイルを確認した
• ✓ Z01* ファイルが存在する場合、すべて読んだ
• ✓ superpowers:writing-plans スキルを呼び出した（スラッシュコマンドではない）
• ✓ プロンプトで出力先のパスを明示的に指示した
• ✓ Z02_{feature}_plan.md が作成されたことを確認した
• ✓ 次のステップをユーザーに報告した

使用するタイミング

ワークフロー上の位置： feature-research（Z01 ファイル）の後、feature-implement の前

次の場合に使用します：

• Z01 の調査ファイルが存在する
• 実装計画を作成する必要がある
• Z01 → Z02 のワークフローを自動化したい

次の場合は使用しないでください：

• Z01 ファイルが存在しない → まず feature-research を使用してください
• すでに完全な計画がある
• 単純な単一ステップのタスク