From long-run-implement
Implements large tasks iteratively via TODO.md cycles: high-level decomposition, sequential execution by main agent, sub-agent reviews per chunk, dynamic TODO additions. For long-running, structured implementations without context loss.
npx claudepluginhub sean-sunagaku/claude-code-pluginThis skill uses the workspace's default tool permissions.
大きな実装タスクを **TODO ファイル駆動** で段階的に進め、
Executes large code implementation tasks via TODO-driven cycles: decompose high-level tasks, sequential implementation, sub-agent reviews per chunk, iterative TODO additions. For structured, long-running agent workflows.
Executes written implementation plans using fresh subagents per task with TDD cycles, mandatory code reviews, and quality gates before proceeding.
Share bugs, ideas, or general feedback.
大きな実装タスクを TODO ファイル駆動 で段階的に進め、 各段階をサブエージェントがレビューするスキル。
ユーザーのタスク
→ 高レベル TODO 作成(全体の見通し)
→ 高レベル TODO ごとに:
→ 細かい TODO に分解
→ 各 TODO を実装
→ 【レビューゲート】サブエージェントが検証
→ 問題・不足があれば TODO 追加
→ 全 TODO 完了 → 最終検証
team-plan/team-implement との違い:
.claude/long-run-implement/
├── todo.md ← メインの TODO ファイル
└── review-log.md ← レビュー結果の蓄積
ユーザーのタスクを分析し、高レベル TODO を作成する。 各高レベル TODO は「実装の大きな塊」を表す。
todo.md のフォーマット:
# TODO: {タスク名}
> 元のタスク: {ユーザーの指示原文}
## 進捗サマリー
- 総タスク数: X
- 完了: 0
- レビュー済み: 0
---
## 1. {高レベル TODO タイトル}
- **状態**: [ ] 未着手 / [~] 進行中 / [x] 完了 / [!] レビュー指摘あり
- **概要**: {何をするか}
- **対象ファイル**: {変更が予想されるファイル}
### 細かい TODO
<!-- 高レベル TODO に着手する時に分解する -->
---
## 2. {高レベル TODO タイトル}
...
高レベル TODO を作成したら、ユーザーに提示して確認を取る。 AskUserQuestion で「この TODO で進めてよいか」を確認する。
重要: ユーザーが「もっと細かく」「この部分が足りない」と言ったら修正する。 ユーザーが OK を出すまで実装を開始しない。
承認された高レベル TODO を上から順番に処理する。
高レベル TODO に着手する前に、まず対象ファイルを Read して現状を把握する。 その上で細かい TODO に分解する。
### 細かい TODO
- [ ] 1-1: {具体的な変更内容}({ファイルパス})
- [ ] 1-2: {具体的な変更内容}({ファイルパス})
- [ ] 1-3: {具体的な変更内容}({ファイルパス})
細かい TODO の粒度:
Edit で todo.md を更新し、細かい TODO を追記する。
高レベル TODO の状態を [~] 進行中 に変更する。
細かい TODO を上から順番に実装する。
[x] に更新[+] マーカーで「後から追加された」ことを示す[ ] 未着手
↓
[~] 作業中
↓
[x] 完了
↓ (レビュー指摘があれば)
[!] 要修正 → 修正 TODO を追加 → 修正後 [x]
[+] 後から追加された TODO(上記と同じ遷移をたどる)
### 細かい TODO
- [x] 1-1: UserType に newField を追加(src/types.ts)
- [x] 1-2: createUser 関数で newField を処理(src/services/user.ts)
- [~] 1-3: UserForm コンポーネントに入力欄を追加(src/components/UserForm.tsx)
- [ ] 1-4: バリデーションロジックの追加(src/utils/validation.ts)
- [+] 1-5: 既存テストの修正が必要と判明(src/__tests__/user.test.ts)
<!-- 1-2 実装中に既存テストが壊れることが分かった -->
高レベル TODO 内の全ての細かい TODO が完了したら、レビューゲートに入る。
Agent ツールを使ってレビューエージェントを起動する。
Agent(
subagent_type: "long-run-implement:reviewer"
prompt: "{レビュープロンプト}"
)
レビュープロンプトに含める情報:
レビューエージェントは agents/reviewer.md の指示に従い、以下を検証する:
レビューエージェントは結果を返す。結果は以下のいずれか:
PASS(問題なし):
[x] 完了 に更新FAIL(問題あり):
[!] マーカー)[!] レビュー指摘あり に更新### レビュー指摘 (2026-03-07)
- [!] 1-R1: createUser の型が UserType の新フィールドを反映していない(src/services/user.ts:45)
- [!] 1-R2: バリデーション関数に null チェックが必要(src/utils/validation.ts:12)
同じ高レベル TODO に対するレビューは 最大 3 回 まで。 3 回目でも FAIL の場合、ユーザーに状況を報告して判断を仰ぐ。
各高レベル TODO 完了後に todo.md の「進捗サマリー」を更新する。
## 進捗サマリー
- 総タスク数: 15 (+3 追加)
- 完了: 8
- レビュー済み: 2/4
- 現在: 3. API エンドポイントの実装
ユーザーに現在の進捗を簡潔に報告する(1〜2行)。
全ての高レベル TODO が完了・レビュー済みになったら:
CLAUDE.md やプロジェクト設定に検証コマンドがあれば実行する。
なければ一般的なコマンド(npm run build, npm test 等)を試す。
todo.md に最終セクションを追加:
---
## 完了レポート
### 変更ファイル一覧
| ファイル | 変更内容 |
|---------|---------|
| {パス} | {概要} |
### レビュー結果サマリー
- レビュー回数: N 回
- 指摘事項: M 件(全て解決済み)
### ビルド&テスト
- {結果}
### 注意事項
- {実装中に気づいた懸念点}
最終レポートの要約をユーザーに伝える。