Plan Writing

Source: obra/superpowers

概要

このスキルは、明確で実行可能なタスクに作業を分解し、検証基準を備えたフレームワークを提供します。

タスク分類の原則

1. 小さく、焦点を絞ったタスク

• 各タスクは2〜5分で完了すべき
• タスクごとに1つの明確な成果物
• 独立して検証可能

2. 明確な検証

• 完了をどのように知るか?
• 何をチェック・テストできるか?
• 期待される出力は何か?

3. 論理的な順序

• 依存関係を特定
• 並列実行可能な部分を活用
• クリティカルパスをハイライト
• フェーズX: 検証は常に最後

4. プロジェクトルートでの動的命名

• プランファイルはプロジェクトルートに {task-slug}.md として保存
• タスク由来の命名 (例: "add auth" → auth-feature.md)
• .claude/、docs/、または一時フォルダの中には決して置かない

計画原則 (テンプレートではなく!)

🔴 固定テンプレートなし。各計画はタスクに固有のもの。

原則 1: 簡潔に保つ

❌ 間違い	✅ 正解
サブサブタスク付きの50タスク	最大5～10個の明確なタスク
すべてのマイクロステップをリスト	実行可能な項目のみ
詳細な説明	タスクあたり1行

ルール: 計画が1ページを超える場合、長すぎます。簡潔にしてください。

---

原則 2: 具体的に、一般的でなく

❌ 間違い	✅ 正解
「プロジェクトをセットアップする」	「npx create-next-app を実行する」
「認証を追加する」	「next-auth をインストール、/api/auth/[...nextauth].ts を作成」
「UI をスタイルする」	「Header.tsx に Tailwind クラスを追加」

ルール: 各タスクは明確で検証可能な成果物を持つべき。

---

原則 3: プロジェクトタイプに基づく動的コンテンツ

新規プロジェクト:

• どのテックスタック? (まず決定)
• MVP は? (最小限の機能)
• ファイル構成は?

機能追加:

• どのファイルが影響を受けるか?
• どの依存関係が必要か?
• 動作を検証するには?

バグ修正:

• 根本原因は?
• どのファイル・行を変更するか?
• 修正をテストするには?

---

原則 4: スクリプトはプロジェクト固有

🔴 スクリプトコマンドをコピペしないこと。プロジェクトタイプに基づいて選択。

プロジェクトタイプ	関連スクリプト
Frontend/React	ux_audit.py, accessibility_checker.py
Backend/API	api_validator.py, security_scan.py
Mobile	mobile_audit.py
Database	schema_validator.py
Full-stack	何を変更したかに基づいた上記の組み合わせ

間違い: すべてのプランにすべてのスクリプトを追加 正解: このタスクに関連するスクリプトのみ

---

原則 5: 検証はシンプル

❌ 間違い	✅ 正解
「コンポーネントが正しく動作することを検証」	「npm run dev を実行、ボタンをクリック、トーストを確認」
「API をテスト」	「curl localhost:3000/api/users は 200 を返す」
「スタイルをチェック」	「ブラウザを開く、ダークモード切り替えが動作することを確認」

---

計画構造 (柔軟で固定でない!)

# [タスク名]

## ゴール
1文: 何を構築・修正するのか?

## タスク
- [ ] タスク 1: [具体的なアクション] → 検証: [チェック方法]
- [ ] タスク 2: [具体的なアクション] → 検証: [チェック方法]
- [ ] タスク 3: [具体的なアクション] → 検証: [チェック方法]

## 完了条件
- [ ] [メインの成功基準]

これだけ。 フェーズやサブセクションは本当に必要な場合のみ。 ミニマルに保つ。複雑さは必要な場合のみ追加。

注記

[重要な考慮事項]

---

## ベストプラクティス (クイックリファレンス)

1. **ゴールから始める** - 何を構築・修正するのか?
2. **最大10タスク** - それ以上の場合は複数の計画に分割
3. **各タスクは検証可能** - 明確な「完了」基準
4. **プロジェクト固有** - テンプレートのコピペなし
5. **進行に応じて更新** - 完了時に `[x]` をマーク

---

## 使用時期
- スクラッチからの新規プロジェクト
- 機能の追加
- バグ修正 (複雑な場合)
- 複数ファイルのリファクタリング

## 制限事項
- このスキルは、タスクが上記で説明されるスコープと明確に一致する場合のみ使用してください。
- 出力を環境固有の検証、テスト、または専門家の見直しの代わりにしないでください。
- 必要な入力、権限、安全境界、または成功基準が不明な場合は停止して確認を求めてください。