planning-with-files

ファイルを使った計画

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

クイックスタート

複雑なタスクを始める前に、必ず次の手順を実行します。

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 では、次の項目を紹介しています。

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