# Milestone: Advisor와 Context Hook 최적화 (2차)

## 위치

- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
- Phase: [PHASE.md](../PHASE.md)

## 목표

advisor 역할과 로컬 LLM hook 기반 context compression 최적화를 MVP 이후 2차 후보로 스케치한다.
이 Milestone은 별도 조언자 모델, 작업 전후 hook, context 압축 정책의 방향만 잡고, 실제 hook runtime과 UI/UX는 후속 검토 전까지 확정하지 않는다.

## 상태

[스케치]

## 승격 조건

- [ ] advisor가 planner/verifier와 다른 책임을 갖는지 결정한다.
- [ ] context compression hook을 어느 실행 지점에 붙일지 결정한다.
- [ ] local LLM을 hook에 사용할 때의 비용, 지연, 품질 기준을 정리한다.
- [ ] 사용자에게 advisor/context hook 결과를 노출할지 내부 정책으로 둘지 결정한다.

## 구현 잠금

- 상태: 잠금
- 결정 필요: 아래 체크리스트
  - [ ] advisor를 별도 사용자 기능으로 노출할지 내부 최적화 역할로 둘지 결정한다.
  - [ ] context compression hook을 prompt 구성 전, 단계 전환, stream 종료 후 중 어디에 둘지 결정한다.
  - [ ] hook 실행에 local LLM을 우선할지 provider 선택 정책을 따르게 할지 결정한다.

## 범위

- Claude advisor류 기능을 IOP 실행 모드와 분리해서 검토
- local LLM hook 기반 context compression 최적화 후보
- advisor/context hook의 결과 노출과 운영 관측 후보
- 장기 기억/RAG와 충돌하지 않는 context 처리 경계

## 기능

### Epic: [advisor-hook] Advisor and Context Hooks

MVP 이후 advisor/context hook 라인을 검토하기 위한 최소 산출물을 묶는다.

- [ ] [advisor-role] advisor와 planner/verifier의 책임 차이가 정리되어 있다.
- [ ] [hook-points] context compression hook 후보 지점과 제외 범위가 정리되어 있다.
- [ ] [quality-cost] hook 실행 비용, 지연, 품질 기준 후보가 정리되어 있다.
- [ ] [second-review] 사용자가 2차 advisor/context hook 범위와 우선순위를 검토했다.

## 완료 리뷰

- 상태: 없음
- 요청일: 없음
- 완료 근거: 스케치 Milestone이며 기능 Task가 아직 충족되지 않았다.
- 리뷰 필요:
  - [ ] 사용자가 완료 결과를 확인했다
  - [ ] archive 이동을 승인했다
- 리뷰 코멘트: 없음

## 범위 제외

- 1차 MVP 구현
- 특정 Agent Shell 전용 advisor UX
- hook runtime 상세 구현
- 장기 기억/RAG 저장소 구현

## 작업 컨텍스트

- 관련 경로: `apps/edge`, `apps/node`, `packages/go/policy`, `packages/go/jobs`, `proto/iop`
- 표준선(선택): advisor/context hook은 단계 호출 MVP와 RAG 장기 기억 라인 뒤에서 별도 2차 최적화로 검토한다.
- 선행 작업: 단계 호출과 검증 최적화 MVP, 장기 기억과 RAG 업데이트 사이클 (2차)
- 후속 작업: 품질 평가 feedback, context/policy 운영 관측
- 확인 필요: advisor 노출 방식, hook 지점, local LLM/provider 선택 기준