Plan Management Skill

Multi-layer planning system for long-running agent sessions.

Plan Hierarchy Structure

roadmap (最上位)
  └── milestones
        └── playbooks (1 task = 1 playbook = 1 branch)
              └── phases

When to Use This Skill

• New task: Create playbook before starting work
• Phase transition: Update playbook status and state.md
• Session start: Read roadmap → playbook → understand context
• Task completion: Verify against done_criteria, call critic

Playbook Creation Flow

1. Determine task scope
2. Check existing playbooks in plan/
3. Create playbook using plan/template/playbook-format.md
4. Update state.md:
   - playbook.active: path/to/playbook
5. Commit playbook

Phase Transition Rules

状態遷移:
  pending → designing → implementing → [reviewing] → state_update → done

禁止遷移:
  - pending → implementing (設計スキップ禁止)
  - pending → done (全スキップ禁止)
  - * → done without critic (自己報酬詐欺防止)

Phase 完了条件:
  1. done_criteria の全項目に証拠がある
  2. validations（3点検証）が全て PASS である
  3. critic が PASS を返した

Three-Tuple Coherence

三つ組:
  - playbook.active (state.md)
  - playbook (plan/playbook-*.md)
  - branch (git)

整合性ルール:
  - playbook.branch == git current branch
  - playbook.active reflects current task

Session Start Checklist

必須 Read:
  1. state.md → playbook.active 確認
  2. playbook (if playbook.active is set)
  3. RUNBOOK.md (for procedures)

branch 確認:
  - main なら新ブランチ作成
  - playbook.branch と一致するか確認

playbook 確認:
  - null なら /playbook-init 実行
  - 存在するなら Read して in_progress phase 特定

Automatic Triggers

This skill activates when Claude detects:

• "計画を立てて" / "plan" / "playbook"
• "次のフェーズ" / "phase"
• "ロードマップ" / "roadmap" / "milestone"
• Session start with session=task

Integration with Hooks

session-start.sh:
  - Outputs required Read list
  - Warns if playbook=null

check-coherence.sh:
  - Validates four-tuple alignment
  - Blocks commits if misaligned

session-end.sh:
  - Updates session_tracking
  - Reminds about uncommitted changes

Best Practices

1. One task = One playbook = One branch
2. Read before write: Always read playbook before modifying
3. Evidence-based completion: No done without proof
4. Critic before done: Always call critic agent
5. Commit after each phase: Keep git in sync