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 ファイルを作成する
目標を一度述べただけで忘れる	判断の前に計画を読み返す
エラーを隠して再試行する	計画ファイルにエラーを記録する
すべてをコンテキストに詰め込む	大量の内容はファイルに保存する
すぐに作業を始める	まず計画ファイルを作成する

高度なパターン

注意を向けるためのテクニック、エラーからの復旧パターン、Manus のコンテキスト最適化については、reference.md を参照してください。

以下については、examples.md を参照してください。

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