ファイルを使った計画

Manus のように作業する: 永続的な markdown ファイルを「ディスク上の作業メモリ」として使用します。

重要: ファイルの保存場所

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

• テンプレートはスキルディレクトリの ${CLAUDE_PLUGIN_ROOT}/templates/ に保存されます
• 計画ファイル (task_plan.md, findings.md, progress.md) はプロジェクトディレクトリ — 作業しているフォルダに作成する必要があります

場所	内容
スキルディレクトリ (${CLAUDE_PLUGIN_ROOT}/)	テンプレート、スクリプト、参考資料
プロジェクトディレクトリ	task_plan.md, findings.md, progress.md

これにより、計画ファイルはコードと一緒に配置され、スキルのインストールフォルダに埋もれることはありません。

クイックスタート

複雑なタスク前に必ず:

1. プロジェクトに task_plan.md を作成 — templates/task_plan.md を参考に
2. プロジェクトに findings.md を作成 — templates/findings.md を参考に
3. プロジェクトに progress.md を作成 — templates/progress.md を参考に
4. 決定前に計画を再読 — アテンションウィンドウ内でゴールをリフレッシュ
5. 各フェーズ後に更新 — 完了をマーク、エラーをログ

注: 3 つの計画ファイルすべてを、スキルのインストールフォルダではなく、現在の作業ディレクトリ (プロジェクトルート) に作成する必要があります。

コアパターン

コンテキストウィンドウ = RAM (揮発性、容量限定)
ファイルシステム = ディスク (永続的、容量無制限)

→ 重要なものはすべてディスクに書き込む。

ファイルの目的

ファイル	目的	更新タイミング
task_plan.md	フェーズ、進捗、決定事項	各フェーズ後
findings.md	調査、発見	発見があるたび
progress.md	セッションログ、テスト結果	セッション全体

重要ルール

1. 最初に計画を作成

複雑なタスクは task_plan.md なしに始めない。絶対。

2. 2 アクションルール

「2 回のビュー/ブラウザ/検索操作のたびに、重要な発見をテキストファイルに即座に保存する。」

これにより、ビジュアル/マルチモーダル情報の喪失を防ぎます。

3. 決定前に読む

重要な決定前に、計画ファイルを読みます。これによりゴールがアテンションウィンドウに留まります。

4. 行動後に更新

フェーズ完了後:

• フェーズステータスをマーク: in_progress → complete
• 遭遇したエラーをログ
• 作成/修正されたファイルを記録

5. すべてのエラーをログ

すべてのエラーを計画ファイルに記録します。これは知識を構築し、繰り返しを防ぎます。

## 遭遇したエラー
| エラー | 試行 | 解決策 |
|-------|---------|------------|
| FileNotFoundError | 1 | デフォルト設定を作成 |
| API タイムアウト | 2 | リトライロジックを追加 |

6. 失敗を繰り返さない

if action_failed:
    next_action != same_action

試したことを追跡します。アプローチを変更します。

3 ストライクエラープロトコル

試行 1: 診断と修正
  → エラーをよく読む
  → 根本原因を特定
  → 対象を絞った修正を適用

試行 2: 代替アプローチ
  → 同じエラー? 別の方法を試す
  → 別のツール? 別のライブラリ?
  → 全く同じ失敗したアクションを繰り返さない

試行 3: より広い再考
  → 仮定に疑問を持つ
  → ソリューションを検索
  → 計画の更新を検討

3 回失敗後: ユーザーにエスカレート
  → 試したことを説明
  → 具体的なエラーを共有
  → ガイダンスを求める

読む vs 書く判断マトリックス

状況	アクション	理由
ファイルを書いたばかり	読まない	コンテンツはまだコンテキストにある
画像/PDF を見た	今すぐ発見を書く	マルチモーダル → テキスト (喪失前)
ブラウザがデータを返した	ファイルに書く	スクリーンショットは永続化されない
新フェーズを開始	計画/発見を読む	コンテキスト劣化時に再調整
エラーが発生	関連ファイルを読む	現在の状態を修正する必要がある
ギャップの後に再開	すべての計画ファイルを読む	状態を復元

5 つの質問リブートテスト

これらに答えられれば、コンテキスト管理は堅実です:

質問	回答ソース
どこにいるか?	task_plan.md の現在フェーズ
どこに向かっているか?	残りのフェーズ
ゴールは何か?	計画のゴールステートメント
何を学んだか?	findings.md
何をしたか?	progress.md

このパターンを使う時

使用する場合:

• マルチステップタスク (3 ステップ以上)
• リサーチタスク
• プロジェクトの構築/作成
• 多くのツールコールにまたがるタスク
• 整理が必要なもの

スキップする場合:

• シンプルな質問
• 単一ファイル編集
• クイック検索

テンプレート

開始するためにこれらのテンプレートをコピー:

• templates/task_plan.md — フェーズ追跡
• templates/findings.md — リサーチストレージ
• templates/progress.md — セッションログ

スクリプト

自動化用ヘルパースクリプト:

• scripts/init-session.sh — すべての計画ファイルを初期化
• scripts/check-complete.sh — すべてのフェーズが完了したか検証

高度なトピック

• Manus の原則: reference.md を参照
• 実例: examples.md を参照

アンチパターン

してはいけない	代わりにこうする
永続性に TodoWrite を使う	task_plan.md ファイルを作成
ゴールを一度述べて忘れる	決定前に計画を再読
エラーを隠して黙って再試行	エラーを計画ファイルにログ
すべてをコンテキストに詰め込む	大きなコンテンツはファイルに保存
すぐに実行を開始	計画ファイルを最初に作成
失敗したアクションを繰り返す	試行を追跡、アプローチを変更
ファイルをスキルディレクトリに作成	ファイルをプロジェクトに作成

制限事項

• このスキルは、タスクが上記で説明されたスコープと明確に合致する場合にのみ使用してください。
• 出力を環境固有の検証、テスト、または専門家レビューの代替と見なさないでください。
• 必要な入力、許可、セキュリティ境界、または成功基準が不足している場合は、停止して説明を求めてください。