ファイルを使った計画

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. 計画を最初に作成

複雑なタスクを計画なしで開始しないこと。絶対的なルールです。

2. 2アクションルール

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

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

3. 決定前に読む

大きな判断の前に、計画ファイルを読みます。これにより目標が注意ウィンドウに留まります。

4. 行動後に更新

任意のフェーズを完了した後：

• フェーズステータスを更新：in_progress → complete
• 遭遇したエラーをログ
• 作成/変更されたファイルを記載

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

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

## Errors Encountered
| Error | Attempt | Resolution |
|-------|---------|------------|
| FileNotFoundError | 1 | Created default config |
| API timeout | 2 | Added retry logic |

6. 失敗を繰り返さない

if action_failed:
    next_action != same_action

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

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

試行1：診断と修正
  → エラーを注意深く読む
  → 根本原因を特定
  → ターゲットを絞った修正を適用

試行2：別のアプローチ
  → 同じエラー？別の方法を試す
  → 別のツール？別のライブラリ？
  → 完全に同じ失敗したアクションは繰り返さない

試行3：より広い再検討
  → 仮定に疑問を持つ
  → 解決策を検索
  → 計画の更新を検討

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

読み取りと書き込みの判断マトリックス

状況	アクション	理由
ファイルを書き込んだばかり	読み取らない	コンテンツはまだコンテキスト内
画像/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 ファイルを作成
ゴールを一度だけ述べて忘れる	判断前に計画を読み直す
エラーを隠して黙って再試行	エラーを計画ファイルにログ
すべてをコンテキストに詰め込む	大きなコンテンツをファイルに保存
すぐに実行を開始	計画ファイルを最初に作成
失敗したアクションを繰り返す	試行を追跡し、アプローチを変更
スキルディレクトリにファイルを作成	プロジェクトにファイルを作成