planning-with-files

ファイルを使った計画

Manus のように、ディスク上の永続的な Markdown ファイルを作業メモリとして使います。

これは単なる任意の計画スタイルではありません。複雑な Codex 作業では、これをデフォルトの永続化レイヤーにしてください。

次のような場合は、積極的に活用してください。

• タスクの完了までに複数回のツール呼び出しが必要になりそうな場合
• 複数のフェーズにわたって進捗を追跡する必要がある場合
• 作業中に調査結果や証拠を保存する必要がある場合
• タスクが分岐したり、一時停止したり、後で再開したりする可能性がある場合
• チャットのコンテキストだけに頼るのが不確かな場合

クイックスタート

複雑なタスクに取りかかる前に、必ず次の手順を実行してください。

1. 作業ディレクトリに task_plan.md を作成します
2. チェックボックス付きでフェーズを定義します
3. 各フェーズの後に更新し、完了した項目を [x] にしてステータスを変更します
4. 判断を下す前に読み返し、目標を注意の範囲内に保ちます

3 ファイルのパターン

重要度の高いタスクでは、次の 3 つのファイルを作成します。

ファイル	目的	更新するタイミング
task_plan.md	フェーズと進捗を追跡する	各フェーズの後
notes.md	調査結果や知見を保存する	調査中
[deliverable].md	最終成果物	完了時

基本的なワークフロー

Loop 1: Create task_plan.md with goal and phases
Loop 2: Research → save to notes.md → update task_plan.md
Loop 3: Read notes.md → create deliverable → update task_plan.md
Loop 4: Deliver final output

ループの詳細

主な作業の前に：

Read task_plan.md  # Refresh goals in attention window

各フェーズの後に：

Edit task_plan.md  # Mark [x], update status

情報を保存するとき：

Write notes.md     # Don't stuff context, store in file

task_plan.md のテンプレート

複雑なタスクでは、最初にこのファイルを作成します。

# Task Plan: [Brief Description]

## Goal
[One sentence describing the end state]

## Phases
- [ ] Phase 1: Plan and setup
- [ ] Phase 2: Research/gather information
- [ ] Phase 3: Execute/build
- [ ] Phase 4: Review and deliver

## Key Questions
1. [Question to answer]
2. [Question to answer]

## Decisions Made
- [Decision]: [Rationale]

## Errors Encountered
- [Error]: [Resolution]

## Status
**Currently in Phase X** - [What I'm doing now]

notes.md のテンプレート

調査結果や知見をまとめるために使用します。

# Notes: [Topic]

## Sources

### Source 1: [Name]
- URL: [link]
- Key points:
  - [Finding]
  - [Finding]

## Synthesized Findings

### [Category]
- [Finding]
- [Finding]

重要なルール

1. 必ず最初に計画を作成する

task_plan.md なしで複雑なタスクに着手してはいけません。これは必須です。

2. 判断の前に読み返す

重要な判断を下す前に、計画ファイルを読んでください。これにより、目標を注意の範囲内に保てます。

3. 作業後に更新する

フェーズを完了したら、すぐに計画ファイルを更新してください。

• 完了したフェーズを [x] にします
• ステータスのセクションを更新します
• 発生したエラーを記録します

4. 詰め込まず、保存する

大量の出力はコンテキストではなく、ファイルに保存します。作業メモリにはパスだけを残してください。

5. すべてのエラーを記録する

すべてのエラーを「発生したエラー」セクションに記録します。これにより、今後のタスクに役立つ知見が蓄積されます。

このパターンを使う場面

3 ファイルのパターンを使う場面：

• 複数の手順が必要なタスク（3 手順以上）
• 調査タスク
• 何かを構築または作成するタスク
• 複数回のツール呼び出しにまたがるタスク
• 整理が必要なあらゆるタスク

使わない場面：

• 簡単な質問
• 1 つのファイルだけを編集する場合
• 簡単な情報検索

避けるべきアンチパターン

しないこと	代わりにすること
TodoWrite を永続化に使う	task_plan.md ファイルを作成する
目標を一度だけ述べて忘れる	判断の前に計画を読み返す
エラーを隠して再試行する	計画ファイルにエラーを記録する
すべてをコンテキストに詰め込む	大量の内容はファイルに保存する
すぐに作業を始める	最初に計画ファイルを作成する

高度なパターン

reference.md では、次の内容を確認できます。

• 注意を誘導するテクニック
• エラーからの回復パターン
• Manus によるコンテキスト最適化

examples.md では、次の内容を確認できます。

• 実際のタスク例
• 複雑なワークフローのパターン