mcpField
P
planning-with-files

planning-with-files

github.com/yyh211エージェントワークフロー28447 回インストール24 週間前に更新
リポジトリ

planning-with-files について

Markdown ファイルを永続的な作業メモリとして使う、複雑なタスク向けのワークフロー技能です。計画を先に作成し、調査内容を記録して進捗を更新する手順を示し、複数段階の調査や成果物作成に適しています。

主な機能

  1. 01task_plan.md で段階を計画
  2. 02notes.md に調査結果を保存
  3. 03チェックボックスで進捗を記録
  4. 043 ファイル方式で作業を整理
  5. 05エラーを記録し判断前に計画を再確認

活用シーン

  1. 01複数段階の調査の整理
  2. 02プロジェクト作成や開発の進捗管理
  3. 03長いタスクでの発見やエラーの保存
  4. 04段階的な文書作成と納品

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yyh211/claude-meta-skill --skill planning-with-files

インストール後、Claude Code で/planning-with-filesを入力して読み込まれたか確認します。

同梱ファイルexamples.mdreference.md

詳細

ファイルを使った計画

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

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

コメント

Markdown 対応