post-loop

POST_LOOP - playbook 完了後の後処理

トリガー

pending-guard.sh によるブロック（Edit/Write が BLOCK された時）

🚨 post-loop 未実行 - Edit/Write ブロック中
  必須アクション:
    Skill(skill='post-loop') を呼び出してください。

前提条件

archive-playbook.sh（PostToolUse:Edit フック）が以下を自動実行済み:

• 自動コミット（最終 Phase 分）
• Push & PR 作成
• playbook アーカイブ（plan/archive/ へ移動）
• state.md 更新（playbook.active = null）
• PR マージ & main 同期
• pending ファイル作成（.claude/session-state/post-loop-pending）

行動

1. ブロック解除（必須・最初に実行）:
   - handlers/complete.sh を実行
   - pending ファイルを削除
   - Edit/Write が再び使用可能になる

2. /clear アナウンス:
   - playbook 完了時にユーザーに以下を案内:
     ```
     [playbook 完了]
     playbook-{name} が全 Phase 完了しました。

     コンテキスト使用率を確認し、必要に応じて /clear を実行してください。
     /context で確認 → /clear で リセット可能です。
     ```

3. 次タスクの導出（計画の連鎖）★pm 経由必須:
   - pm SubAgent を呼び出す
   - pm がユーザー要求を確認
   - pm が新 playbook を作成

4. 残タスクあり:
   - ブランチ作成: `git checkout -b feat/{next-task}`
   - pm が playbook 作成: plan/playbook-{next-task}.md
   - pm が state.md 更新: playbook.active を更新
   - 即座に LOOP に入る

5. 残タスクなし:
   - 「全タスク完了。次の指示を待ちます。」

実行方法

# Step 1: complete.sh を実行（ブロック解除）
bash .claude/skills/post-loop/handlers/complete.sh

# Step 2: 次タスク導出（pm SubAgent 経由）
# pending ステータスに応じて:
#   success: 直接 pm 呼び出し
#   partial: 手動確認後に pm 呼び出し

自動化フロー（archive-playbook.sh 担当）

# PostToolUse:Edit で archive-playbook.sh が以下を自動実行:
Phase 完了検出:
  - playbook 解析（全 Phase が done か判定）

自動コミット:
  - git status --porcelain で未コミット変更を確認
  - 変更あり → git add -A && git commit -m "feat: {playbook 名} 完了"

自動プッシュ & PR 作成:
  - git push origin {branch}
  - create-pr.sh を実行

自動アーカイブ:
  - mkdir -p plan/archive && mv plan/playbook-*.md plan/archive/
  - state.md の playbook.active を null に更新

自動マージ & 同期:
  - merge-pr.sh を実行
  - git checkout main && git pull

pending ファイル作成:
  - .claude/session-state/post-loop-pending を作成
  - ステータス（success/partial）を記録

pending ファイル

location: .claude/session-state/post-loop-pending
purpose: Edit/Write ブロック制御

content_example:
  status: success  # または partial
  playbook: playbook-example.md
  timestamp: 2025-12-25T10:00:00Z

lifecycle:
  created_by: archive-playbook.sh
  detected_by: pending-guard.sh
  deleted_by: complete.sh

禁止

- 「報告して待つ」パターン（残タスクがあるのに止まる）
- ユーザーに「次は何をしますか？」と聞く
- complete.sh を実行せずに次タスクに進む