# 아누 가이드 시스템 구축: Phase 3 — 파이프라인 통합 + 런타임 검증

## 참조 문서
- 아누 가이드: /home/jay/workspace/memory/specs/anu-guide.md (Section 1.6, 3.5 참조)
- 체크리스트: /home/jay/workspace/memory/plans/anu-guide-system/checklist.md
- Agent 미팅 기록: /home/jay/workspace/memory/meetings/2026-03-02-anu-guide-gap-analysis.md
- 야누스 인프라 분석 (미팅 기록 내 야누스 섹션 참조)

## 현재 구현 상태 (Phase 0+1 완료)
- UserPromptSubmit hook: 동작 중 (매뉴얼 자동 주입)
- PostToolUse hook: 동작 중 (Audit Trail → memory/logs/audit-trail.jsonl)
- skills: 3종 생성 완료 (agent-meeting, 3docs-create, nuclear-approval)
- 3문서 스키마: 확정됨 (memory/specs/3docs-schema.md)
- Phase 2 (QC 자동 트리거): 1팀이 병렬 구현 중 (Stop hook + team_prompts.py QC 강화)

## 구현 항목

### A. 런타임 검증 스크립트
파일: /home/jay/workspace/memory/health-check.sh

3계층 검증 (야누스 제안):
Level 1 — 프로세스 상태:
- pgrep -f로 cokacdir 프로세스 확인
- ss -tlnp로 포트 확인 (8000 등)

Level 2 — API 응답:
- curl -s --max-time 5 http://localhost:8000/api/status → 응답 확인
- curl -s --max-time 5 http://localhost:8000/dashboard/ → HTML 포함 확인

Level 3 — 데이터 정합성:
- task-timers.json의 active task 수 ↔ 실제 상태 비교
- organization-structure.json ↔ bot_settings.json 동기화 확인 (sync-check.py 호출)

출력 형식: JSON
{
  "timestamp": "...",
  "checks": [
    {"name": "cokacdir_process", "status": "ok|fail", "detail": "..."},
    ...
  ],
  "summary": {"total": N, "pass": N, "fail": N}
}

chmod +x 필수.

### B. 파이프라인 상태 추적
파일: /home/jay/workspace/memory/specs/pipeline-stages.md

6단계 파이프라인 정의 (아누 가이드 1.6):


각 Stage의 입력/출력/트리거 조건/실패 시 동작을 문서화.

### C. 파이프라인 대시보드 데이터 연동
파일: /home/jay/workspace/memory/pipeline-status.json

현재 파이프라인 상태를 JSON으로 기록하는 경량 시스템:
{
  "last_updated": "...",
  "active_tasks": [
    {
      "task_id": "task-XX.X",
      "team": "dev1-team",
      "stage": 2,
      "stage_name": "AI 작업 수행",
      "started_at": "..."
    }
  ],
  "last_health_check": { ... }
}

이 파일은 task-timer.py의 start/end 이벤트 + health-check.sh 결과로 자동 업데이트.
task-timer.py에 pipeline-status.json 업데이트 로직 추가 필요:
- start 시: active_tasks에 추가, stage=2
- end 시: active_tasks에서 제거
- health-check 후: last_health_check 업데이트

### D. 주기적 헬스체크 cron 등록 안내
health-check.sh를 cokacdir --cron으로 10분마다 실행하는 방법을 보고서에 기재.
(실제 cron 등록은 아누가 결정. 구현만 해놓을 것.)

### E. 테스트
1. health-check.sh 실행 → JSON 출력 확인
2. pipeline-status.json 생성/업데이트 확인
3. task-timer.py start/end 시 pipeline-status.json 동기화 확인
4. pipeline-stages.md 문서 완성도 확인

## 보고서
/home/jay/workspace/memory/reports/ 에 저장.