{{AGENT_NAME_LOWER}}-runtime-checkup

{{AGENT_NAME}} Runtime Checkup

{{AGENT_NAME}} 코어 시스템의 "기본기"를 점검할 때 사용하는 표준 절차. 핵심 철학: "docs에서 Done이라고 한 것 ≠ 실제 구현". 항상 filesystem ground truth 로 verify.

When to Use

• "기본기 점검해줘", "코어 시스템 확인", "이거 진짜 작동해?" 류 요청
• P0/P1 review 문서가 "✅ Done"이라 한 항목 의심될 때
• Cron job / dispatcher / worker 가 silent failure 중인지 확인할 때
• Major refactor 후 회귀 점검
• 새 모델 / 새 환경에서 {{AGENT_NAME}} 설치 직후 sanity check

6-Phase Checkup (in order)

Workdir 주의

터미널 workdir 는 turn 사이에서 휘발됨. 모든 명령은 cd ~/.{{AGENT_NAME_LOWER}}/source/{{AGENT_NAME_LOWER}}-agent && prefix 필수. 절대 workdir 에 의존하지 말 것.

Phase 1 — Core Imports (1분)

AIAgent, signal_processor, context_compressor, brain_signals, event_bus 모두 import. import 실패 = P0 즉시 보고.

cd ~/.{{AGENT_NAME_LOWER}}/source/{{AGENT_NAME_LOWER}}-agent && source .venv/bin/activate
python3 -c "
from run_agent import AIAgent
from agent.signal_processor import get_signal_processor
from agent.context_compressor import ContextCompressor
from agent.brain_signals import get_signal_emitter
print('OK')
"

Phase 2 — Persistent State Health (1분)

SQLite DB 무결성. FK ON. Status 분포.

python3 -c "
import sqlite3
conn = sqlite3.connect('P2-hippocampus/kanban/state/{{AGENT_NAME_LOWER}}_tasks.db')
conn.execute('PRAGMA foreign_keys = ON')
for r in conn.execute('SELECT status, COUNT(*) FROM tasks GROUP BY status'):
    print(r)
print('integrity:', conn.execute('PRAGMA integrity_check').fetchone())
"

기대값: FK violations 0, status 7종 (todo/ready/in_progress/blocked/completed/cancelled).

Phase 3 — Brain Signal Accumulation (1분)

signal_processor 인스턴스 state 확인.

python3 -c "
from agent.signal_processor import get_signal_processor
sp = get_signal_processor()
print('violations:', len(sp._violation_history))
print('dangerous_ops:', len(sp._dangerous_ops_history))
print('workflows:', len(sp._workflow_history))
"

기대값: violation ≥ 1, dangerous_ops ≥ 0 (사용 패턴에 따라 다름). 0/0/0이면 signal event bus wiring 끊긴 것.

Phase 4 — Dispatcher End-to-End (1분)

Cron이 1분마다 도는 dispatcher 직접 실행. ready task 없으면 0/0/0/0 정상.