kanban-dispatcher-stalled

---

name: kanban-dispatcher-stalled description: kanban dispatcher cron이 안 돌거나 dead worker reclaim 실패를 4가지 fail mode로 진단 title: Kanban Dispatcher Stalled — 진단 스킬 type: skill space: growth tags: [skill, kanban, dispatcher, cron, launchd, diagnostics] created: 2026-06-01 updated: 2026-06-01 links:

• "[[@memory/kanban/KANBAN_INDEX]]"
• "[[@memory/growth/kanban-stuck-task-recovery]]"
• "[[@action/gateway/{{AGENT_NAME_LOWER}}-architecture-dataflow]]"
• "[[@identity/brain/rules]]"---

Kanban Dispatcher Stalled — 진단 스킬

kanban dispatcher가 안 돌거나 dead worker를 못 reclaim할 때 빠르게 진단하는 스킬. 4가지 fail mode를 차례로 검증.

Trigger

다음 중 하나라도 해당되면 이 skill 사용:

• "kanban이 안 움직여" / "task가 in_progress에서 안 풀려"
• kanban DB의 in_progress task가 claim_expires past인데도 그대로
• jobs.json의 kanban-dispatcher last_run_at이 1시간+ stale
• cron output/{board}-dispatcher/ 디렉토리에 새 파일이 안 생김

4가지 Fail Mode

1. launchd 트리거 부재 (가장 흔함)

jobs.json 등록은 됐는데 launchd plist가 없거나 unload됨.

# 1a. launchd에 트리거 plist가 떠있는지
launchctl list | grep -i '{{AGENT_NAME_LOWER}}\|kanban\|cron'

# 기대: ai.{{AGENT_NAME_LOWER}}.gateway 또는 ai.{{AGENT_NAME_LOWER}}.cron-runner 같은 plist label
# (quartz / n8n / kanban-dashboard / fswatch / nas-mount는 무관 — 별개 service)

# 1b. plist 파일 자체 존재 확인
ls -la ~/Library/LaunchAgents/ai.{{AGENT_NAME_LOWER}}.*.plist 2>/dev/null
ls -la ~/Library/LaunchAgents/com.{{AGENT_NAME_LOWER}}.*.plist 2>/dev/null

# 1c. gateway plist 내용 확인
plutil -p ~/Library/LaunchAgents/ai.{{AGENT_NAME_LOWER}}.gateway.plist 2>/dev/null

Fix: plist 부재 → {{AGENT_NAME_LOWER}}-update-checker skill 또는 수동 작성 후 launchctl load. gateway plist가 cron runner 역할도 해야 함 (embedded design).

2. Script 부재 / Path mismatch

script 파일이 jobs.json의 command path와 일치하지 않음.

# 2a. script 존재 확인
ls -la ~/.{{AGENT_NAME_LOWER}}/scripts/dispatch_once_*.py

# 2b. jobs.json의 script path와 비교
python3 -c "
import json
with open('~/.{{AGENT_NAME_LOWER}}/cron/jobs.json') as f:
    jobs = json.load(f)
for j in jobs.get('jobs', []):
    if 'dispatcher' in j.get('name','').lower():
        print(f'  {j[\"name\"]:35} | script={j.get(\"script\",\"?\")} | state={j.get(\"state\",\"?\")}')
"