# 자동화 오케스트레이터 아키텍처 통합 구현 계획

## 태스크 ID: task-901.1
## 한정위임: Lv.4 프로젝트 — 3문서 + 에이전트 미팅 만장일치까지
## 작업 레벨: Lv.4 (대규모 프로젝트)

## 목표
task-897.1(.done 자동 감지 설계)과 task-899.1(자동화 에이전트 설계)의 결과물을 통합하여,
**전체 자동화 아키텍처의 구현 로드맵**을 3문서 체계로 완성한다.

## 입력 자료 (반드시 전부 읽을 것)

### task-897.1 (.done 자동 감지) — 기반 인프라
- 설계서: `/home/jay/workspace/memory/specs/done-polling-spec.md`
- 미팅 기록: `/home/jay/workspace/memory/meetings/task-897.1-done-polling.md`
- 보고서: `/home/jay/workspace/memory/reports/task-897.1.md`
- 핵심: 2-Layer 하이브리드 (Telegram 직접 알림 + done-watcher fallback)

### task-899.1 (자동화 에이전트) — 상위 레이어
- 설계서: `/home/jay/workspace/memory/specs/automation-agent-spec.md`
- 미팅 기록: `/home/jay/workspace/memory/meetings/task-899.1-automation-agent.md`
- 보고서: `/home/jay/workspace/memory/reports/task-899.1.md`
- 핵심: auto_orch.py, 30초 systemd timer, YAML 파이프라인, 토큰 0 오케스트레이션

### 기존 시스템
- dispatch.py: `/home/jay/workspace/dispatch.py`
- chain_manager.py: `/home/jay/workspace/chain_manager.py` (있다면)
- done-watcher.sh: 위치 확인 필요
- notify-completion.py: 위치 확인 필요
- activity-watcher.py: 위치 확인 필요
- finish-task.sh: 위치 확인 필요

## 통합 설계 관점

### 레이어 구조
```
Layer 3: 자동화 에이전트 (auto_orch.py) — 파이프라인 실행
Layer 2: .done 감지 (notify-completion + done-watcher) — 이벤트 감지
Layer 1: 기존 시스템 (dispatch.py + chain.py) — 작업 위임/체이닝
Layer 0: cokacdir + Telegram — 통신 인프라
```

### 통합 시 검토 필수 사항
1. Layer 2와 Layer 3의 .done 처리 충돌 방지 (누가 먼저 .done을 소비하는가?)
2. auto_orch.py의 .done 감지와 done-watcher.sh의 역할 분리
3. 아누 수동 체이닝 vs auto_orch 자동 체이닝의 공존
4. activity-watcher.py 버그 수정(find_done_file, BOT_TEAM_MAP)을 auto_orch 설계에 반영
5. 토큰 회계 통합: task-timer + token_ledger
6. 보안: injection_guard + TeamLock + gates의 실제 구현 순서

## 3문서 산출물 (Lv.4 필수)

### 1. 계획서 (Plan)
- 전체 구현 Phase 로드맵 (Phase별 코딩 단계)
- 각 Phase의 산출물/검증 기준
- 팀 배정안 (어떤 팀이 어떤 Phase를 담당)
- 의존성 그래프

### 2. 맥락노트 (Context Note)
- 왜 이 설계를 선택했는지 근거
- 대안 방안과 기각 사유
- task-897.1, task-899.1 미팅에서의 핵심 결정과 그 배경
- 기존 시스템 코드 위치/구조 정리

### 3. 체크리스트 (Checklist)
- Phase별 완료 조건
- 테스트 항목
- 보안 검증 항목
- 통합 테스트 시나리오

## 에이전트 미팅 규칙

### 참석자 (필수)
- **오딘 (2팀장)** — 미팅 주관
- **로키 (보안팀장)** — DA, 보안/권한/충돌
- **펜리르 (보안팀원)** — DA 보조, 침투 시나리오
- **야누스 (DevOps센터)** — 인프라/systemd/데몬
- **헤르메스 (1팀장)** — task-897.1 설계자로서 .done 감지 관점 (필수 소집)
- 기타 필요 시 추가 소집 가능

### 미팅 사이클 (무제한)
- 3문서 초안 작성 → 미팅 검토 → 개선 → 재미팅 → 만장일치까지 반복
- 사이클 제한 없음

### 산출물 경로
- 계획서: `memory/specs/automation-impl-plan.md`
- 맥락노트: `memory/specs/automation-impl-context.md`
- 체크리스트: `memory/specs/automation-impl-checklist.md`
- 미팅 기록: `memory/meetings/task-901.1-automation-impl.md`
- 보고서: `memory/reports/task-901.1.md`

## 작업 후 처리
- task-timer end: `python3 /home/jay/workspace/memory/task-timer.py end task-901.1`
- .done: `touch /home/jay/workspace/memory/events/task-901.1.done`