todo-management

Todo Management

概要

todo-management は、スキル開発の全工程を通じて体系的なタスク追跡を提供します。タスクの状態を管理し、進捗をリアルタイムで更新し、阻害要因を特定して、最初から最後まで作業の勢いを維持します。

目的：進捗を体系的に追跡し、作業状況を可視化して、問題を早期に特定し、確実に完了させます。

価値：作業の失念を防ぎ、進捗を明確に可視化し、軌道修正を可能にして、完了まで勢いを維持します。

使用する場面：

• task-development で作業を分解した後
• スキルの実装中（継続的な追跡）
• 複数の並行タスクを調整する場合
• ステークホルダーに進捗を報告する場合
• すべての作業を確実に完了させる場合

前提条件

todo-management を使用する前に、以下を確認してください。

1. タスクリスト：task-development によるタスク分解を完了していること
2. 明確な目標：各タスクの「完了」の定義を理解していること
3. 定期的な更新：作業中にタスクの状態を更新すること

タスクベースの操作

操作 1：Todo リストを初期化する

使用する場面：スキル開発の開始時、タスク分解の完了後

手順：

1. task-development からタスクリストをインポートする
2. 初期状態を設定する：すべてのタスクを「pending」にする
3. メタデータを追加する：スキル名、開始日、見積もり
4. 完全性を確認する：すべてのタスクが含まれていること

出力：追跡を開始できる初期 Todo リスト

例：

# Todo List: my-skill
Started: 2025-11-06
Estimate: 12-15 hours

⬜ 1. Create directory (15 min)
⬜ 2. SKILL.md frontmatter (30 min)
⬜ 3. Write Overview (1h)
...

---

操作 2：タスクを開始する

使用する場面：特定のタスクに着手するとき

手順：

1. 依存関係を確認する：前提条件は完了しているか？
2. 状態を更新する：pending → in_progress
3. タイムスタンプを追加する：開始時刻を記録する
4. 集中する：一度に in_progress にできるタスクは 1 つだけ

出力：in_progress としてマークされたタスク

例：

Before: ⬜ 3. Write Overview (1h)
After:  🔄 3. Write Overview (1h) - Started 10:00 AM

重要なルール：in_progress のタスクは最大 1 つ（コンテキストの切り替えを防ぐため）

---

操作 3：タスクを完了する

使用する場面：タスクの完了直後

手順：

1. 完了を確認する：成果物があり、品質を確認済みであること
2. 状態を更新する：in_progress → completed
3. 実績時間を記録する：見積もりと比較する
4. 次のタスクを確認する：今すぐ着手できるものは何か？

出力：completed としてマークされたタスク

例：

Before: 🔄 3. Write Overview (1h) - Started 10:00 AM
After:  ✅ 3. Write Overview (1h) - Done 10:45 AM (45min actual)

ベストプラクティス：すぐに完了処理を行い、更新をまとめて後回しにしないでください

---

操作 4：進捗を報告する

使用する場面：毎日、マイルストーン到達時、または依頼されたとき

手順：

1. 指標を計算する：完了済み、進行中、残り
2. レポートを整える：状態、現在の作業、阻害要因
3. 共有する：チームに共有するか、文書に記録する

出力：指標を含む進捗レポート

例：

Progress Report: my-skill (2025-11-06 14:00)

Overall: 8/20 tasks (40%), 6h spent, ~9h remaining

Completed Today:
- ✅ Directory structure
- ✅ SKILL.md frontmatter
- ✅ Overview
- ✅ Prerequisites

Currently: 🔄 Step 1 (1.5h est, 30min elapsed)

Next Up:
- Step 2
- Step 3

Blockers: None
Status: On track (ahead 30min)

---

操作 5：阻害要因を特定する

使用する場面：タスクを進められない場合、または所要時間が見積もりを 20% 超えている場合

手順：

1. 阻害要因を認識する：タスクを開始または完了できない
2. 記録する：何がブロックされているか、阻害要因は何か、誰が解決できるか
3. 対応する：支援を依頼する、別のタスクに切り替える、エスカレーションする

出力：阻害要因を記録し、対処した状態

例：

BLOCKER: Task 7 - API integration guide
Issue: API documentation not available
Impact: 1 task blocked, 2 downstream affected (~5h work)
Action: Requested from API team, ETA Friday
Workaround: Working on independent tasks meanwhile

阻害要因の種類：

• ハード：まったく進められない
• ソフト：進められるが非効率
• 待機中：外部の依存関係

---

操作 6：見積もりを更新する

使用する場面：実際の所要時間が見積もりと大きく異なる場合（20% 超）

手順：

1. 実績と見積もりを比較する：差異を計算する
2. パターンを特定する：すべてのタスクか、特定の種類か？
3. 残りの見積もりを調整する：補正係数を適用する
4. 共有する：完了予定を更新する

出力：実情を反映した改訂後の見積もり

例：

Original: 12-15h total
Actual (5 tasks): 7h vs 5.5h est (27% over)
Analysis: Writing tasks taking longer
Adjustment: 1.3x multiplier for remaining writing
Updated: 15-18h total (vs 12-15h)
New completion: Friday vs Thursday

---

操作 7：タスクの変更に対応する

使用する場面：スコープの変更、新しいタスクの発見、タスクが不要になった場合

手順：

1. 変更を記録する：内容、理由、影響
2. リストを更新する：タスクを追加・削除・変更する
3. 再計算する：新しい見積もり、クリティカルパス

出力：更新された Todo リスト

例 - タスクの追加：

Added: 8a. Create advanced-patterns.md (3h)
Reason: Users need advanced examples
Impact: +3h (now 15-18h total)

例 - タスクの削除：

Removed: 12. Create script (4h) - OBSOLETE
Reason: Manual process sufficient
Impact: -4h (now 8-11h total)

---

オペレーション 8：勢いを維持する

使用するタイミング：継続的に、特に行き詰まりを感じたとき

プロセス：

1. 進捗を確認する：毎日定期的に振り返ります
2. 停滞の原因を特定する：長時間かかるタスク、ブロッカー、タスクの切り替え、完璧主義
3. 戦略を実践する：すぐに終わらせられるタスク、タイムボックス、いったん飛ばして後で戻る
4. 達成を祝う：完了したタスクに印を付け、節目を認めます

勢いを維持するためのチェックリスト：

• セッションごとに 1 件以上のタスクを完了していますか？
• 毎日進捗がありますか？
• 2 日を超えて止まっているタスクはありませんか？
• ブロッカーに 1 日以内に対処していますか？
• 集中を維持できていますか（進行中のタスクは 1 件）？

行き詰まったとき：

1. 完了したタスクを振り返ります（進捗を確認します！）
2. 最も小さな未完了タスクを選びます（すぐに終わらせられます）
3. 15 分間休憩します
4. 助けを求めます
5. 別のタスクに切り替えます

圧倒されているとき：

1. 現在のタスクだけに集中します
2. タスクをさらに細かく分割します
3. 小さな節目を設定します（次の 1 時間）
4. MVP を思い出します

---

タスクの状態モデル

3 つの基本状態

pending（⬜）

• まだ着手していません
• 作業を開始できる状態です（または依存関係の完了を待っています）
• すべてのタスクの初期状態です

in_progress（🔄）

• 現在作業中です
• 重要：同時に 1 件だけにします
• 今まさに作業しています

completed（✅）

• 完了し、検証済みです
• 成果物があり、品質を確認済みです
• 終端状態です（これ以上変更しません）

状態の遷移

pending → in_progress (start work)
in_progress → completed (finish and verify)
in_progress → pending (blocker discovered)

特別な状態（任意）

blocked（🚫）：障害があり、先に進めません obsolete（⊗）：タスクが不要になりました deferred（⏸）：後のバージョンに延期されました

---

進捗の追跡形式

形式 1：シンプルなチェックリスト

# My Skill Todos

- [ ] Task 1 (30 min)
- [x] Task 2 (1h)
- [ ] Task 3 (2h)

Progress: 1/3 (33%)

メリット：シンプルで、持ち運びやすい デメリット：進行中の状態を表せません

---

形式 2：絵文字を使った拡張形式

# My Skill Todos

⬜ 1. Create directory (15 min)
✅ 2. SKILL.md frontmatter (30 min) - Done 10:30
🔄 3. Write Overview (1h) - Started 10:45
⬜ 4. Write Step 1 (1.5h)

Progress: 1/4 complete (25%), 1 in progress

メリット：状態が明確で、視覚的に分かりやすい デメリット：絵文字のサポートが必要です

---

形式 3：表形式

| # | Task | Est | Status | Actual | Notes |
|---|------|-----|--------|--------|-------|
| 1 | Create dir | 15m | ✅ | 15m | Done |
| 2 | Frontmatter | 30m | ✅ | 25m | Done |
| 3 | Overview | 1h | 🔄 | - | Working |
| 4 | Step 1 | 1.5h | ⬜ | - | Ready |

Progress: 2/4 (50%), Time: 40min / 3.25h

メリット：構造化されており、実績を追跡できます デメリット：冗長です

---

形式 4：フェーズごとにグループ化

# My Skill Todos

## Phase 1: Initialization ✅
- ✅ 1. Create directory (15 min)
- ✅ 2. SKILL.md frontmatter (30 min)

## Phase 2: Core Content 🔄
- ✅ 3. Write Overview (1h)
- 🔄 4. Write Step 1 (1.5h) - Working
- ⬜ 5. Write Step 2 (1h)
- ⬜ 6. Write Step 3 (1h)

## Phase 3: References ⬜
- ⬜ 7. Create ref-1.md (3h)
- ⬜ 8. Create ref-2.md (2h)

Progress: 3/8 (37.5%), Phase 1 complete

メリット：論理的にグループ化でき、節目を把握できます デメリット：構造が複雑になります

---

ベストプラクティス

Todo 管理のベストプラクティス

1. すぐに更新する

   • 完了したらすぐに完了の印を付けます
   • 更新をまとめて行わないでください
   • 1 日の終わりではなく、作業中に更新します

2. 進行中のタスクは 1 件にする

   • 1 つのタスクに集中します
   • コンテキストの切り替えを防げます
   • 次を始める前に完了させます

3. 次に進む前に完了させる

   • まず現在のタスクを終わらせます
   • 「完了」とは検証済みの状態であり、「ほぼ完了」ではありません
   • 90% 完了のままのタスクを避けます

4. 実績を記録する

   • 実際にかかった時間を記録します
   • 見積もりと比較します
   • より良い見積もりのために学びます

5. ブロッカーにすばやく対処する

   • ブロッカーを 1 日を超えて放置しないでください
   • 明確に記録します
   • すぐに行動を起こします

6. 進捗を祝う

   • 完了したタスクを認めます
   • 節目を目に見える形で示します
   • 成果を通じて勢いを維持します

よくある間違い

間違い 1：更新をまとめて行う

• 問題：1 日に 1 回だけ更新します
• 対処法：作業中にすぐ更新します

間違い 2：複数のタスクを進行中にする

• 問題：3～4 件のタスクを進行中としてマークします
• 対処法：進行中のタスクは最大 1 件にします

間違い 3：完了させない

• 問題：「ほぼ完了」の状態で次に進みます
• 対処法：次に進む前に現在のタスクを完了させます

間違い 4：ブロッカーを放置する

• 問題：ブロックされたタスクを何日も放置します
• 対処法：1 日以内に対処します

間違い 5：実績を追跡しない

• 問題：見積もりを改善できません
• 対処法：実績を記録し、見積もりと比較します

---

他のスキルとの連携

task-development との連携

フロー：task-development → todo-management

task-development がタスクリストを作成し、todo-management が進捗を追跡します

---

planning-architect との連携

フロー：planning-architect → task-development → todo-management

計画の見積もり → 見積もり付きのタスク → 完了まで追跡

---

momentum-keeper との連携

フロー：todo-management ← 監視 ← momentum-keeper

momentum-keeper が停滞しているタスクや進捗速度の低下を確認します

---

クイックスタート

5 分でセットアップ

ステップ 1：タスクリストを取得します（task-development から）

ステップ 2：初期 Todo を作成します

# Todo: my-skill
⬜ 1. Task one (30 min)
⬜ 2. Task two (1h)
⬜ 3. Task three (2h)

ステップ 3：最初のタスクを開始します

🔄 1. Task one (30 min) - Started
⬜ 2. Task two (1h)
⬜ 3. Task three (2h)

ステップ 4：完了させて次に進みます

✅ 1. Task one (30 min) - Done!
🔄 2. Task two (1h) - Started
⬜ 3. Task three (2h)

---

例

例 1：シンプルなスキル（5 タスク）

# Todo: calculator-skill

Started: 2025-11-06 09:00
Estimate: 3 hours

✅ 1. Create directory (15 min) - Done 09:15
✅ 2. SKILL.md frontmatter (20 min) - Done 09:35
🔄 3. Write operations (1.5h) - Started 09:35
⬜ 4. Write examples (45 min)
⬜ 5. Validate (15 min)

Progress: 2/5 (40%), 35min / 3h, On track

---

例 2：ブロッカーあり

# Todo: medical-integration

✅ 1-6: Completed (6h)
🚫 7. FHIR integration guide (3h) - BLOCKED
⬜ 8-15: Pending

Blocker: FHIR API docs not available
Impact: 3 tasks affected (~5h work)
Action: Requested docs, ETA Friday
Workaround: Working on tasks 8-11 (independent)

---

参考資料

各項目の詳細ガイド：

• 状態管理ガイド - タスクの状態、遷移、特殊な状態、検証ルールに関する包括的なガイド

• 進捗報告ガイド - 報告形式、指標の計算、可視化手法、コミュニケーション戦略

---

自動化

todo 管理スクリプトを使用します：

# Initialize from task list
python scripts/update-todos.py --init task-list.md

# Start task
python scripts/update-todos.py --start 5

# Complete task
python scripts/update-todos.py --complete 5

# Progress report
python scripts/update-todos.py --report

# Mark blocker
python scripts/update-todos.py --blocker 7 "Waiting for docs"

---

成功基準

効果的な todo 管理：

✅ 定期的な更新 - タスクをすぐに更新します ✅ 明確な可視性 - 進捗を一目で確認できます ✅ 勢いの維持 - セッションごとに 1 つ以上のタスクを完了します ✅ 現実的な追跡 - 実績に基づいて見積もりを更新します ✅ 完了の達成 - すべてのタスクを最終的に完了します

---

クイックリファレンス

8 つの Todo 操作

操作	目的	使用するタイミング	時間
初期化	タスクから todo リストを作成する	プロジェクト開始時	10-20m
タスクを開始	タスクを進行中にする	タスクに取りかかるとき	1-2m
タスクを完了	タスクを完了済みにする	タスクを終えたとき	1-2m
進捗を報告	進捗レポートを生成する	状況報告、チェックイン	5-10m
ブロッカーを特定	ブロックされたタスクをマークする	タスクが行き詰まったとき	2-5m
見積もりを更新	時間の見積もりを調整する	実績から学んだとき	10-15m
変更を処理	タスクを追加／削除／変更する	要件が変わったとき	5-15m
勢いを維持	継続的な進捗を確保する	作業を進め続けるため	継続的

すべての操作は独立しています - 開発中、必要に応じて使用してください

タスクの状態

状態	記号	意味	遷移先
pending	⬜	まだ開始していません	in_progress
in_progress	🔄	現在作業中です	completed
completed	✅	正常に完了しました	-
blocked	🚫	行き詰まり、対応待ちです	in_progress（ブロック解除時）
deferred	⏸	延期されています	pending または in_progress
obsolete	⊗	不要になりました	-

重要なルール：一度に in_progress にできるタスクは 1 つだけ です（コンテキスト切り替えを防ぎます）

よく使うコマンド（スクリプト）

# Initialize from task list
python scripts/update-todos.py --init task-list.md

# Start task #5
python scripts/update-todos.py --start 5

# Complete task #5
python scripts/update-todos.py --complete 5

# Mark task #7 as blocked
python scripts/update-todos.py --blocker 7 "Waiting for API docs"

# Generate progress report
python scripts/update-todos.py --report

# Update estimate for task #3
python scripts/update-todos.py --update-estimate 3 "2h"

# Add new task
python scripts/update-todos.py --add "Validate new feature" "1h" "Phase 4"

進捗指標

完了率：完了済み / 合計 × 100%

速度：完了したタスク数 / 経過時間

残りの推定時間：残りのタスクの見積もりの合計

消化率：費やした時間 / 見積もり時間の合計 × 100%

予定どおりですか？：消化率 ≈ 完了率（±10%）

ベストプラクティスのクイックリスト

1. ✅ すぐに更新する（まとめて更新しない）
2. ✅ in_progress は 1 つだけ（コンテキストを切り替えない）
3. ✅ ブロッカーをマークする（問題を可視化する）
4. ✅ 新しい作業の前に完了する（まず現在のタスクを終える）
5. ✅ 見積もりを更新する（学んで改善する）
6. ✅ 定期的に報告する（進捗を追跡する）
7. ✅ 変更に対応する（新しい要件に適応する）
8. ✅ 勢いを維持する（セッションごとに 1 つ以上完了する）

状態遷移図

pending ──start──> in_progress ──complete──> completed
   ↑                    ↓
   └────────────────blocked
                        ↓
                    deferred

トラブルシューティングのクイック対応

問題	クイック対応
in_progress が複数ある	1 つを除き、すべて完了するか延期します
進捗が停滞している	ブロッカーを特定し、助けを求めます
見積もりが大きく外れている	残りの見積もりを更新します
タスクが多すぎる	優先度の低いタスクを延期します
勢いを失っている	すぐに完了できるタスクを終えます

詳細情報

• 状態管理：references/state-management-guide.md
• 進捗報告：references/progress-reporting-guide.md
• 自動化：scripts/update-todos.py --help

---

todo-management は、タスクリストから完成したスキルに至るまで進捗を維持するために欠かせません。成果を上げるため、開発を通して一貫して使用してください。