Todoワークフロー

更新（2025年1月）: より高機能なタスクシステムがClaude Codeに同梱されるようになり、依存関係、ブロッカー、マルチセッションのハンドオフが含まれている。このページの基本的な考え方は引き続き有効だ。高度なパターンについては新しいガイドを参照してほしい。

問題: ステップが順不同で実行されるか、ステップがまるごと抜け落ち、そもそもブリーフが明確だったのかを疑い始める。

素早い解決策: 複雑なタスクの末尾にこれを追加する:

claude "add user authentication - create a todo list first, then implement each step"

Claudeはターミナル内にチェックリストとしてプランを書く。コードが1行も出荷される前に、読み違いが表面に出てくる。

AIコーディングでの痛みはバグではない。痛みはClaudeがリクエストを実際に理解したかどうか分からないことだ。Claude Codeには組み込みのTodoWriteツールが付属していて、すべてのタスクをターミナルUIのチェックリストに変換する。

Todoリストをclaudeが聞いた内容を繰り返すバージョンとして扱おう。チェックリストは作業が進む間もライブで更新され、完了した項目、現在のフォーカス、まだキューに残っているものをフラグ立てする。整合性は指示が明確だったことを意味する。乖離はコミュニケーションのギャップを意味し、早期に発見される。

よくあるTodoの乖離パターン

順序の誤り: AからBの順を依頼したのに、リストがBからAで返ってくる。欠落したステップ: ブリーフにはテストがあったのに、todoがそれを忘れた。

詳細の誤り: 依頼は高レベルの「ドキュメントを更新して」だったのに、Claudeがファイルごとのエントリに分解する。誤解: 「変更をレビューして」と言ったのに、Claudeが「変更をコミットする」と計画する。

リストはフィードバックを与えると即座に再描画もされる。これが複雑な作業中の本物のステアリングホイールになる。実行途中に「やっぱりボタンを青ではなく緑にして」と言うと、保留中のtodoが更新され、完了した項目はすべてそのまま残る。

具体的なTodoを得る

「ナビゲーションバーをスタイリング」というtodoは問題全体を1行に凝縮している。代わりに具体的な詳細を求める。

悪いアプローチ:

- [ ] Style the navigation bar

良いアプローチ:

- [ ] Change navbar height from 60px to 80px
- [ ] Reduce padding from 16px to 12px
- [ ] Update background to rgba(255,255,255,0.95)

フェーズベースの依存関係

関連する作業をフェーズにグループ化し、各フェーズが何を待つかを明記する:

Phase 1: Setup database schema, create user model
Phase 2: Build registration and login (needs Phase 1)
Phase 3: Add validation and styling (needs Phase 2)

クオリティチェックポイント

すべてのtodoリストを4つのクイックチェックで確認する:

1. 順序: 論理的な順番か？
2. 完全性: すべてのステップが含まれているか？
3. 適切な詳細: 適切な粒度か？
4. 明確さ: 別の開発者がついてこられるか？

うまくいかないとき

Claudeがtodoをスキップする: 「各ステップを開始する前にtodoリストを確認する」をCLAUDE.mdに追加する。

Todoが漠然としすぎる: 指示を与えた後、「具体的で測定可能なステップに分解して」と言う。

優先順位が間違っている: 順序が重要なときは、箇条書きではなく番号付きリストを使う:

1. First, backup the database
2. Then run migrations
3. Finally, restart services

習慣にする

最良のtodoワークフローは自動操縦で動く。この5ステップのループを日課に組み込む:

1. Claudeにタスクの指示を与える
2. 「詳細なtodoリストを作って」と依頼する
3. 自分の意図との整合性を確認する
4. Todoが乖離していたら指示を精緻化する
5. 自信を持って進める

ClaudeのチェックリストがあなたがHEADの中に持っているものと一致するとき、指示は明確だった。それがすべてのバーだ。まずtodoを求め、注意深く読み、残りのセッションはレールの上を走る。

次のステップ:

• Todoドリブンなコミットのためのgit連携
• Todoの品質を改善するフィードバックループ
• 安全な実行のためのパーミッション管理
• 構造化されたtodo作成のためのプランニングモード
• Todo履歴を保持するためのコンテキスト管理