From long-run-implement
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.
npx claudepluginhub sean-sunagaku/claude-code-plugin --plugin long-run-implementThis skill uses the workspace's default tool permissions.
大きな実装タスクを **TODO ファイル駆動** で段階的に進め、
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.
Executes tasks from PLAN.md sequentially with human oversight, handling task splitting, clarifying questions, tests, and learning persistence. Useful for deliberate progress on planned work.
Initiates tasks by interviewing user for requirements, setting up git-wt worktrees or branches, checking tools like direnv/dotenvx, and creating plans for review.
Share bugs, ideas, or general feedback.
大きな実装タスクを TODO ファイル駆動 で段階的に進め、 各段階をサブエージェントがレビューするスキル。
ユーザーのタスク
→ 高レベル TODO 作成（全体の見通し）
→ 高レベル TODO ごとに:
→ 細かい TODO に分解
→ 各 TODO を実装
→ 【レビューゲート】サブエージェントが検証
→ 問題・不足があれば TODO 追加
→ 全 TODO 完了 → 最終検証
team-plan/team-implement との違い:
親ディレクトリ名: {YYYY-MM-DD}-{タスク名のslug}（日付+タスク内容）
.claude/long-run-implement/{YYYY-MM-DD}-{task-slug}/
├── todo.md ← インデックス（全体進捗・タスク一覧）
├── review-log.md ← レビュー結果の蓄積
├── 01-{slug}/
│ └── tasks.md ← 高レベル TODO 1 の細かいタスク
├── 02-{slug}/
│ └── tasks.md ← 高レベル TODO 2 の細かいタスク
├── 03-{slug}/
│ └── tasks.md
...
ポイント:
{連番}-{内容のslug}（例: 01-scaffold, 02-schema）tasks.md に記載todo.md はインデックス（全体の俯瞰）のみ。詳細は各 tasks.md にユーザーのタスクを分析し、高レベル TODO を作成する。 各高レベル TODO は「実装の大きな塊」を表す。
# TODO: {タスク名}
> 元のタスク: {ユーザーの指示原文}
## 進捗サマリー
- 総タスク数: X
- 完了: 0
- レビュー済み: 0
## タスク一覧
| # | ディレクトリ | タスク | 状態 |
|---|------------|--------|------|
| 1 | `01-{slug}/` | {タスク名} | [ ] |
| 2 | `02-{slug}/` | {タスク名} | [ ] |
...
## 依存順序
{タスク間の依存関係を記載}
# {連番}: {高レベル TODO タイトル}
**状態**: [ ] 未着手
**概要**: {何をするか}
**依存**: {前提となるタスク}
## タスク
- [ ] {連番}-1: {具体的な変更内容}（{ファイルパス}）
- [ ] {連番}-2: {具体的な変更内容}（{ファイルパス}）
...
## 完了条件
- {このタスクが完了したと言える基準}
高レベル TODO を作成したら、ユーザーに提示して確認を取る。 AskUserQuestion で「この TODO で進めてよいか」を確認する。
重要: ユーザーが「もっと細かく」「この部分が足りない」と言ったら修正する。 ユーザーが OK を出すまで実装を開始しない。
承認された高レベル TODO を上から順番に処理する。
高レベル TODO に着手する前に、まず対象ファイルを Read して現状を把握する。
その上で該当ディレクトリの tasks.md に細かい TODO を記載する。
## タスク
- [ ] 1-1: {具体的な変更内容}（{ファイルパス}）
- [ ] 1-2: {具体的な変更内容}（{ファイルパス}）
- [ ] 1-3: {具体的な変更内容}（{ファイルパス}）
細かい TODO の粒度:
tasks.md に細かい TODO を書き込むtodo.md（インデックス）の該当タスクの状態を [~] に変更する細かい TODO を上から順番に実装する。
tasks.md を [x] に更新tasks.md に追加 TODO として書く。[+] マーカーで「後から追加された」ことを示すtasks.md にインラインコメントとして残す[ ] 未着手
↓
[~] 作業中
↓
[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: "{レビュープロンプト}"
)
レビュープロンプトに含める情報:
tasks.md の内容全体todo.md 冒頭の「元のタスク」）レビューエージェントは 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 件（全て解決済み）
### ビルド＆テスト
- {結果}
### 注意事項
- {実装中に気づいた懸念点}
最終レポートの要約をユーザーに伝える。
todo.md（インデックス）で俯瞰{NN}-{slug}/tasks.md に記録todo.md + 各 tasks.md を見れば分かる状態を維持するtasks.md を更新し忘れない。実装の前後で必ず更新する