planning-with-files

ファイルを使った計画

「Manus のように作業する」— 計画、進捗管理、ナレッジの保存に永続的な Markdown ファイルを使用します。

説明

計画と進捗管理に永続的な Markdown ファイルを使用するワークフローに変えるスキルです。

問題点

Claude Code（およびほとんどの AI エージェント）には、次のような問題があります。

• 揮発性メモリ — コンテキストがリセットされると、TodoWrite ツールが消えてしまいます
• 目標のずれ — ツール呼び出しが多くなると、当初の目標が忘れられてしまいます
• エラーの隠蔽 — 失敗が記録されず、同じミスが繰り返されます
• コンテキストへの詰め込み — すべてを保存せずにコンテキストへ詰め込みます

解決策：3 ファイルパターン

複雑なタスクごとに、3 つのファイルを作成します。

task_plan.md      → Track phases and progress
notes.md          → Store research and findings
[deliverable].md  → Final output

ワークフローループ

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

使用するタイミング

次のような場合にこのパターンを使用します。

• 複数の手順があるタスク（3 手順以上）
• 調査タスク
• プロジェクトの構築や作成
• 多数のツール呼び出しにまたがるタスク
• 整理が必要なあらゆる作業

次のような場合は使用しません。

• 簡単な質問
• 単一ファイルの編集
• 手早い検索

インストール

このスキルは通常、~/.claude/skills/planning-with-files/ にグローバルインストールされます。

このリポジトリからインストールする場合：

ln -s /path/to/agent-playbook/skills/planning-with-files ~/.claude/skills/planning-with-files

スタンドアロンのワークフローを使用する場合は、「リンク」セクションにある上流リポジトリを参照してください。

Manus の原則

原則	実装
ファイルシステムをメモリとして使う	コンテキストではなく、ファイルに保存する
注意の操作	判断する前に計画を読み直す
エラーの永続化	計画ファイルに失敗を記録する
目標の追跡	チェックボックスで進捗を示す
コンテキストの追記専用化	履歴を変更しない

例

あなた：「TypeScript のメリットを調査して、概要を書いてください」

Claude が作成するもの：

# Task Plan: TypeScript Benefits Research

## Goal
Create a research summary on TypeScript benefits.

## Phases
- [x] Phase 1: Create plan ✓
- [ ] Phase 2: Research and gather sources (CURRENT)
- [ ] Phase 3: Synthesize findings
- [ ] Phase 4: Deliver summary

## Status
**Currently in Phase 2** - Searching for sources

リンク

• GitHub リポジトリ
• AI エージェントのためのコンテキストエンジニアリング