# Milestone: [advisor-01] Advisor와 Context Hook 확장 (2차)

## 위치

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

## 목표

advisor 역할과 여러 최적화·검증 기능을 실행 흐름에 연결할 수 있는 Context Hook 경계를 MVP 이후 2차 후보로 스케치한다.
이 Milestone은 별도 조언자 모델의 역할과 재사용 가능한 hook의 호출·실패·노출 경계만 다루며, 요청 컨텍스트를 선택·압축하는 알고리즘은 독립 Milestone으로 분리한다.

## 상태

[스케치]

## 승격 조건

- [ ] advisor가 planner/verifier와 다른 책임을 갖는지 결정한다.
- [ ] Context Hook을 advisor 전용 연결 지점으로 둘지 여러 기능이 사용하는 재사용 가능한 extension 경계로 둘지 결정한다.
- [ ] hook의 최소 호출 시점, 입력·출력 의미, 실패 격리와 관측 기준을 정리한다.
- [ ] advisor 또는 hook 실행 target을 선택할 때의 비용, 지연, 품질 기준을 정리한다.
- [ ] 사용자에게 advisor/context hook 결과를 노출할지 내부 정책으로 둘지 결정한다.

## 구현 잠금

- 상태: 잠금
- SDD: 불필요
- SDD 문서: 없음
- SDD 사유: 현재 Milestone은 Advisor 역할과 Context Hook 경계를 정리하는 스케치이며, hook runtime/API 계약으로 승격할 때 SDD 필요 여부를 재판정한다.
- 잠금 해제 조건: 아래 체크리스트
  - [ ] 승격 조건의 미정 항목이 사용자 검토로 해소되어 있다.
  - [ ] Advisor와 Context Hook의 구현 단위와 후속 Milestone이 분리되어 있다.
- 결정 필요: 아래 체크리스트
  - [ ] advisor를 별도 사용자 기능으로 노출할지 내부 최적화 역할로 둘지 결정한다.
  - [ ] Context Hook을 독립적인 재사용 extension lifecycle로 구현할지 advisor 통합 지점으로 한정할지 결정한다.
  - [ ] hook 실행에 local target을 우선할지 실행 라우팅 정책을 따르게 할지 결정한다.

## 범위

- Claude advisor류 기능을 IOP 실행 모드와 분리해서 검토
- advisor와 planner/verifier/reviewer의 역할 차이
- 요청 전후 또는 단계 전환에 기능을 연결하는 Context Hook의 호출·실패 격리·관측 후보
- advisor/context hook의 결과 노출과 운영 관측 후보
- 요청 컨텍스트 최적화, 장기 기억/RAG, output validation이 hook을 사용할 수 있으나 각 기능의 정책과 알고리즘은 소유하지 않는 경계

## 기능

### Epic: [advisor-hook] Advisor and Context Hook Boundary

MVP 이후 advisor 역할과 재사용 가능한 Context Hook 경계를 검토하기 위한 최소 산출물을 묶는다.

- [ ] [advisor-role] advisor와 planner/verifier의 책임 차이가 정리되어 있다.
- [ ] [hook-role] Context Hook이 advisor 전용 통합 지점인지 여러 기능이 사용하는 extension 경계인지 후보가 정리되어 있다.
- [ ] [hook-points] hook 호출 시점, 입력·출력 의미, 실패 격리와 제외 범위가 정리되어 있다.
- [ ] [quality-cost] advisor/hook 실행 비용, 지연, 품질과 관측 기준 후보가 정리되어 있다.
- [ ] [second-review] 사용자가 2차 advisor/context hook 범위와 우선순위를 검토했다.

## 완료 리뷰

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

## 범위 제외

- 1차 MVP 구현
- 특정 Agent Shell 전용 advisor UX
- hook runtime 상세 구현
- 요청 history, tool 결과, 검색/RAG 결과를 선택·정렬·압축하는 컨텍스트 최적화 알고리즘
- 장기 기억/RAG 저장소 구현

## 작업 컨텍스트

- 관련 경로: `apps/edge`, `apps/node`, `packages/go/policy`, `packages/go/jobs`, `proto/iop`
- 표준선(선택): Advisor와 Context Hook은 요청 컨텍스트 최적화의 알고리즘을 소유하지 않고, 필요할 때 해당 기능을 호출할 수 있는 역할·연결 경계만 다룬다.
- 선행 작업: [단계 호출과 검증 최적화 MVP](knowledge-tool-validation-optimization.md)
- 후속 작업: 품질 평가 feedback, advisor UX, generic hook runtime 구현
- 확인 필요: advisor 노출 방식, Context Hook 독립 lifecycle 여부, hook 호출·실패·관측 경계
