iop/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/advisor-context-hook-second-wave.md

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

위치

• Roadmap: agent-roadmap/ROADMAP.md
• Phase: agent-roadmap/phase/knowledge-tool-optimization-extension/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 선택 기준