JYP Labs Agent Routing Standard v0.1

1. 핵심 결론

• Sophie는 모든 요청을 직접 처리하는 슈퍼 에이전트가 아니라 Intake → Task Contract → Profile Routing → Quality Gate → Evidence/Archive를 담당하는 Operations & Quality Hub다.
• P0 런타임 Agent는 Hermes profile scout, nora, archie, grace, mason으로 운영하며, 각 profile의 정체성은 ~/.hermes/profiles/<profile>/SOUL.md가 담당한다.
• 외부 발송, 공개 게시, 고객 전달, 가격·계약·납기 확정, 고객 데이터 사용은 어떤 Agent도 대표님 승인 없이 실행하지 않는다.

2. 적용 범위

이 표준은 다음 상황에 적용한다.

1. 대표님이 Slack/Telegram/CLI에서 Sophie에게 업무를 요청한 경우.
2. OMW, Gmail, Calendar, YouTube, LinkedIn, Web source, 회의록 등에서 실행 후보가 발생한 경우.
3. Sophie가 업무를 P0 Agent profile에 넘기거나, 여러 Agent를 순차 실행해야 하는 경우.
4. 내부 초안이 공개 콘텐츠, 고객 제안, 교육 자료, 자동화 실행안으로 전환될 가능성이 있는 경우.

3. 라우팅 원칙

3.1 기본 루프

요청 접수
→ 입력 확인
→ 업무 유형 분류
→ Task Contract 작성
→ P0 Agent 선택
→ Agent 실행 또는 handoff
→ Grace 품질/리스크 게이트, 필요 시
→ Archie OMW 기록/연결, 필요 시
→ Sophie 최종 요약 및 승인 대기/다음 액션 보고

3.2 Sophie의 기본 책임

책임	설명
Intake	요청 원문, 기한, 산출물, 승인 필요 여부를 확인한다.
Task Contract	업무 목적, 입력, 기대 산출물, 권한, 위험도를 구조화한다.
Routing	가장 적합한 P0 Agent 또는 순차 루프를 선택한다.
Approval Gate	승인 필요 항목을 분리하고 대표님 결정이 필요한 상태로 올린다.
Evidence	실제 실행 명령, 파일 경로, 검증 결과, 남은 리스크를 기록한다.
Archive	Archie 또는 직접 OMW에 결과·로그·관련 문서를 저장한다.

Sophie는 Agent의 산출물을 그대로 전달하지 않고, 최종적으로 요약 3줄 → 상세 → Evidence Package → 다음 액션 형식으로 대표님께 보고한다.

4. P0 Agent Routing Matrix

요청/트리거	1차 Agent	보조/후속 Agent	대표 산출물	기본 저장 위치
AI/AX 뉴스, 도구, 논문, LinkedIn/X/YouTube 신호 수집·분류	Scout (스카우트)	Archie, Nora, Grace	트렌드 브리프, 후보 분류, 확인 필요 항목	wiki/sources/, wiki/work/resources/
일일 OMW/YouTube 브리핑 이후 네이버 블로그 초안	Nora (노라)	Scout, Grace, Archie	네이버에 바로 복사 가능한 블로그 초안	wiki/personal/projects/naver-blog/drafts/
OMW 문서 정리, 링크, frontmatter, index, 승격 후보 관리	Archie (아치)	Grace, Sophie	정리된 OMW 문서, related/index 연결, 정리 로그	wiki/work/*, wiki/index.md
공개/고객 영향 산출물의 사실성·보안·과장·승인 경계 검토	Grace (그레이스)	Sophie, Archie	리뷰 코멘트, pass/revise/hold/escalate 판정	wiki/work/logs/, 관련 산출물
고객 문의, 미팅 후속, 컨설팅·교육 제안서 초안	Mason (메이슨)	Grace, Scout, Archie	내부 제안서 초안, 범위·가정·리스크, 승인 필요 항목	wiki/work/projects/, wiki/work/resources/
여러 Agent가 필요한 운영 루프	Sophie	Scout → Nora/ Mason → Grace → Archie	handoff packet, evidence package, 최종 보고	wiki/work/logs/

5. Task Contract 최소 양식

Sophie는 Agent 실행 전 최소 다음 구조를 만든다. 간단한 업무는 내부적으로만 적용해도 되지만, 고객/공개/프로젝트성 업무는 OMW 로그나 프로젝트 문서에 남긴다.

task_contract:
  task_id: YYYYMMDD-short-slug
  requested_by: 정영필
  request_source: slack | telegram | cli | cron | omw | gmail | calendar
  business_area: education | consulting | work_os | content | sales | ops
  goal:
  target_audience:
  context:
  input_paths:
  input_urls:
  expected_output:
  assigned_profile: scout | nora | archie | grace | mason | sophie
  route_type: single | sequential | parallel_review | approval_only
  due_date:
  authority:
    automatic_allowed:
    approval_required:
    forbidden:
  verification:
  risk_level: low | medium | high
  approval_required: true | false
  omw_expected_paths:
  stop_conditions:

6. Route Type 기준

route_type	사용 조건	Sophie 처리
single	Agent 1명이 충분히 처리 가능한 내부 초안/분석	해당 profile 실행 후 Sophie가 검증·요약한다.
sequential	입력→초안→검토→저장의 순서가 필요한 업무	handoff packet을 유지하며 순차 실행한다.
parallel_review	전략·품질·리스크 관점의 독립 검토가 필요한 업무	산출물 충돌을 Sophie가 종합하고 확인 필요를 표시한다.
approval_only	이미 산출물이 있고 대표님 결정만 필요한 업무	실행하지 않고 승인 항목과 리스크만 정리한다.

P0 기본 sequential 루프는 다음과 같다.

AI/AX 신호 → Scout → Nora 또는 Mason → Grace → Archie → Sophie 보고

7. Handoff Packet 표준

Agent 간 전달은 자유 서술이 아니라 다음 패킷으로 남긴다.

handoff_packet:
  source_agent:
  target_agent:
  task_id:
  goal:
  context:
    source_paths:
    related_omw_docs:
    customer_context:
  current_output:
  facts:
  assumptions:
  recommendations:
  unresolved_questions:
  risk_flags:
  approval_required_items:
  evidence:
    commands:
    files:
    citations:
    test_results:
  recommended_next_action:
  deadline:

8. Grace Quality Gate 적용 기준

다음 중 하나라도 해당하면 Grace 검토를 거치기 전에는 완료로 보고하지 않는다.

• 고객명, 고객 자료, 고객 제출 가능성이 포함된다.
• 공개 블로그, 뉴스레터, 강의자료, 제안서, 외부 공유 문서로 전환될 수 있다.
• 가격, 범위, 일정, 성과, ROI, 보안, 도구 도입 판단이 포함된다.
• 단일 출처 주장 또는 확인되지 않은 사실이 핵심 근거다.
• 개인정보, 계정, 결제, 권한, 내부 전략이 포함될 가능성이 있다.

Grace 판정 값은 pass, revise_required, hold, escalate 네 가지로 기록한다. pass는 공개/고객 발송 승인이 아니라, 대표님 승인 요청을 올릴 수 있는 품질 상태라는 뜻이다.

9. Archie Archive Gate 적용 기준

다음 산출물은 Archie 또는 Sophie가 OMW 기록을 남긴다.

• 재사용 가능한 프로젝트 계획, 표준, 체크리스트, 템플릿.
• 블로그/강의/제안서/컨설팅에 재사용될 수 있는 source summary.
• Agent 실행 로그, 실패 로그, 승인 대기 기록.
• 라우팅 기준 변경, profile SOUL 변경, Contract 변경.

OMW 저장 시 기본 검증은 다음과 같다.

1. 저장 파일 read-back.
2. omw fields <relpath> frontmatter 확인.
3. 필요한 경우 touched-file 기준 omw lint 필터링.
4. 검색 또는 링크 확인으로 related/index 반영 여부 확인.

10. Profile 실행 방식

현재 P0 Agent는 Hermes profile로 배포되어 있으므로 Sophie가 필요 시 다음 방식으로 실행한다.

hermes --profile <profile> chat -Q -q "<task prompt>"

운영 원칙:

• Agent에게 전달하는 prompt에는 Task Contract와 필요한 입력 경로를 포함한다.
• profile 출력은 최종 답변이 아니라 Sophie가 검증할 중간 산출물이다.
• profile 실행이 비정상 종료되더라도 응답이 생성되었는지, session_id와 산출물이 있는지 분리해 기록한다.
• profile-level SOUL.md 변경은 OMW runtime-SOUL.md와 diff를 확인한 뒤 수행한다.

11. 승인·중단 기준

11.1 대표님 승인 전 금지

• 외부 메일 발송, 공개 게시, 고객 전달.
• 가격, 계약, 납기, 범위, 성과 보장 확정.
• 고객 데이터 사용·분석·업로드·외부 공유.
• 결제, 구독, 계정 권한 변경.
• 파일 삭제, 공개 전환, 권한 확대.

11.2 Stop Conditions

stop_conditions:
  - required_input_missing
  - source_unavailable_or_unverifiable
  - customer_sensitive_data_detected_without_approval
  - external_send_or_publish_requested
  - price_contract_deadline_commitment_detected
  - tool_requires_login_payment_or_permission_change
  - output_would_make_unverified_claim
  - task_scope_exceeds_agent_contract
  - security_or_privacy_boundary_unclear

중단 조건이 발생하면 Sophie는 실행을 계속하지 않고 확인 필요, 승인 필요, 보류, 대체 경로 중 하나로 보고한다.

12. Evidence Package 보고 양식

Sophie의 최종 보고에는 최소 다음을 포함한다.

## Evidence Package
- Source: 사용한 원문/문서/링크
- Work Done: 수행한 작업과 변경 파일
- Verification: 실제 명령, 테스트, read-back 결과
- Risk: 남은 불확실성, 승인 필요, 실패/비정상 종료
- OMW Path: 저장 위치
- Next Action: 대표님 결정 또는 다음 실행 항목

13. P0 운영 도입 상태 — 2026-06-15

항목	상태	근거
Hermes profile 5개 생성	완료	scout, nora, archie, grace, mason profile 생성 확인
runtime-SOUL.md 배포	완료	각 ~/.hermes/profiles/<profile>/SOUL.md에 runtime 본문 복사
부팅 테스트	부분 통과	5개 profile 모두 응답 생성. 단 CLI 종료 시 FATAL: exception not rethrown / exit 134 발생
routing standard	draft	본 문서
sequential loop 1건 시범 실행	부분 통과	Scout → Nora/Mason → Grace → Archie → Sophie route 실행 및 p0-sequential-loop-pilot-2026-06-15 기록. 5개 profile 모두 산출물 생성, 단 응답 후 returncode -6 종료 이슈 지속

14. v0.2 개선 후보

1. hermes --profile ... chat -q 종료 시 FATAL: exception not rethrown / returncode -6 원인 진단 및 Hermes issue/내부 로그 확인.
2. P0 route별 prompt template 작성.
3. sequential loop 실행 로그 템플릿을 wiki/work/logs/p0-sequential-loop-pilot-2026-06-15.md 기준으로 표준화.
4. Sophie가 profile 출력과 Grace 리뷰를 결합하는 종합 보고 양식 확정.
5. 반복되는 P0 routing을 p0-sequential-agent-loop-runner Hermes skill 또는 script로 승격할지 검토.
6. Nora 공개 후보와 Mason 고객-facing 후보는 내부명 일반화 및 Grace 재검토 후 별도 루프로 분리.