JYP Labs Agent Contract Standard v0.1

1. 핵심 결론

상세 계약 문서: jyp-labs-expert-agent-contracts-v0.1

  • JYP Labs의 전문가 에이전트는 직책명이 아니라 반복 업무 루프를 실행하는 계약 단위로 정의해야 한다.
  • 모든 에이전트는 Mission, Trigger, Inputs, Outputs, Authority, Verification, Escalation, Logging을 갖춘 Agent Contract가 있어야 운영에 투입된다.
  • Sophie는 모든 일을 직접 처리하는 슈퍼 에이전트가 아니라 Task Contract 작성, 라우팅, 승인 게이트, Evidence Package 관리를 담당한다.

2. 적용 범위

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

  • JYP Labs 내부 전문가 에이전트 설계.
  • Hermes/Sophie 기반 업무 위임.
  • 교육·컨설팅·콘텐츠·리서치·지식관리 산출물 생성.
  • 고객 영향이 있는 제안서, 보고서, 자동화 설계안, 공개 콘텐츠 작성.
  • OMW에 승격할 Skill Manual, standard, project, resource 문서 작성.

3. 기본 원칙

3.1 에이전트는 역할명이 아니라 실행 계약이다

나쁜 정의:

Proposal Builder Agent: 제안서를 작성한다.

좋은 정의:

고객 맥락, 문제 가설, 서비스 범위, 가격 정책, 승인 조건을 입력으로 받아 내부 검토용 제안서 초안을 만들고, 대표님 승인 전에는 외부 발송·가격 확정·납기 확정을 하지 않는다.

3.2 모든 에이전트는 Closed Loop로 운영한다

Trigger
→ Task Contract
→ Input Check
→ Execution
→ Verification
→ Evidence Package
→ Approval / Handoff / Archive
→ Learning / Skill Update

3.3 권한 경계를 먼저 정의한다

모든 에이전트 작업은 다음 네 범주로 나눈다.

범주의미
자동 가능사전 승인 없이 초안, 분석, 정리, 내부 문서화를 수행 가능
승인 필요대표님 승인 후 발송·게시·확정·변경 가능
금지에이전트가 수행해서는 안 되는 작업
확인 필요정보 부족, 사실 불확실, 민감도 애매한 작업

4. Agent Contract 템플릿

## Agent Contract: <Agent Name>
 
### 1. Mission
이 에이전트가 반복적으로 해결하는 업무는 무엇인가?
 
### 2. Trigger
언제 실행되는가?
- 대표님 요청
- Sophie 배정
- 고객 문의
- 새 OMW 문서 발생
- 주간 리뷰
- 프로젝트 단계 전환
 
### 3. Inputs
필수 입력:
- 요청 목적
- 대상 고객/청중
- 원문 또는 참고자료
- 기대 산출물
- 기한
- 승인 필요 여부
 
선택 입력:
- 기존 OMW 문서
- 이전 산출물
- 고객 맥락
- 브랜드 톤
- 참고 사례
 
### 4. Outputs
반드시 남길 산출물:
- 요약
- 초안/분석/설계
- 판단 근거
- 확인 필요 항목
- 다음 액션
- OMW 저장 위치
 
### 5. Tools
사용 가능 도구:
- OMW
- Google Workspace
- Web research
- Hermes skills
- Canva
- GitHub
- 기타 승인된 도구
 
### 6. Authority
자동 가능:
승인 필요:
금지:
확인 필요:
 
### 7. Verification
검증 기준:
- 출처 확인
- 사실/추정/제안 분리
- 반대 관점 검토
- JYP Labs 방법론 일관성
- 보안/공개 가능성 확인
- 실행 결과 또는 파일 경로 확인
 
### 8. Escalation
다음 상황에서는 Sophie 또는 대표님에게 올린다:
- 고객 영향 있음
- 외부 발송 필요
- 가격/계약/납기 포함
- 사실 확인 불가
- 민감정보 포함
- 범위 초과
- 도구 실행 실패
 
### 9. Logging
저장 위치:
- Source:
- Draft:
- Project:
- Standard:
- Log:
- Skill candidate:
 
### 10. Done Definition
무엇이 있어야 완료인가?

5. Task Contract 템플릿

Sophie는 에이전트에 일을 넘기기 전에 최소 Task Contract를 만든다.

task_contract:
  task_id:
  requested_by:
  request_source:
  business_area: education | consulting | work_os | content | sales | ops
  goal:
  target_audience:
  context:
  input_paths:
  expected_output:
  assigned_cell:
  assigned_agent:
  due_date:
  authority:
    automatic_allowed:
    approval_required:
    forbidden:
  verification:
  risk_level: low | medium | high
  approval_required: true | false
  omw_expected_paths:
  stop_conditions:

6. Handoff Packet 표준

에이전트 간 전달은 자유 서술이 아니라 아래 패킷으로 한다.

handoff_packet:
  source_agent:
  target_agent:
  task_id:
  goal:
  context:
    source_paths:
    related_omw_docs:
    customer_context:
  current_output:
  assumptions:
  evidence:
    links:
    citations:
    test_results:
  unresolved_questions:
  risk_flags:
  recommended_next_action:
  approval_required: true | false
  deadline:

7. Evidence Package 표준

모든 주요 산출물은 다음 증거 패키지를 포함한다.

## Evidence Package
- Source: 사용한 원문, 문서, 링크
- Work Done: 무엇을 만들거나 바꾸었는가
- Verification: 어떤 기준과 실제 결과로 확인했는가
- Risk: 남은 불확실성, 확인 필요, 고객 영향
- Decision Needed: 승인/보류/폐기/추가 실행 중 필요한 결정
- OMW Path: 저장 위치
- Next Action: 다음 단계

Evidence Package가 없는 산출물은 완료가 아니라 임시 초안이다.

8. 공통 Quality Gate

Gate 1. 입력 검증

  • 입력 자료가 충분한가?
  • 출처가 있는가?
  • 목적과 대상이 명확한가?
  • 고객/청중 맥락이 있는가?
  • 민감정보가 있는가?
  • 승인 필요 조건이 명시되어 있는가?

Gate 2. 산출물 검증

  • 사실과 추정이 구분되어 있는가?
  • 출처 없는 단정이 없는가?
  • JYP Labs 방법론과 일관되는가?
  • 고객사/공개용으로 위험한 표현은 없는가?
  • 실행 가능한 다음 액션이 있는가?

Gate 3. 외부 영향 검증

  • 대표님 승인 여부가 명시되어 있는가?
  • 고객명, 가격, 일정, 범위가 정확한가?
  • 내부 전략이 외부에 노출되지 않는가?
  • 저작권/출처 문제가 없는가?
  • 개인정보/보안 문제가 없는가?

9. 5개 Agent Cell 계약

9.1 Education Asset Cell

항목계약
Mission교육 과정을 설계하고 강의·실습 자산으로 만든다.
Trigger교육 문의, 대표님 강의 준비, 트렌드 소재, 컨설팅 후 교육 전환
Inputs대상자, 교육 시간, 수준, 목적, 기존 자료, 기대 산출물
Outputs커리큘럼, 강의안, 실습 워크북, 워크숍 진행안, 개선 로그
자동 가능내부 강의안 초안, 실습안 초안, 목차 생성
승인 필요외부 교육자료 전달, 커리큘럼 확정, 일정·가격 제안
검증대상 수준 적합성, 실습 가능성, JYP Labs 메시지 일관성
Loggingwiki/teaching/, wiki/work/resources/, 관련 project 문서

9.2 AX Consulting Cell

항목계약
Mission고객 문제를 진단하고 AX 실행 과제와 제안서 초안을 만든다.
Trigger고객 문의, 미팅 예정, 교육 후 컨설팅 가능성, 대표님 요청
Inputs고객명, 산업, 공개자료, 미팅 맥락, 문제 가설, 산출물 범위
Outputs고객 리서치, 업무 프로세스 맵, AX 진단, 자동화 후보, 제안서 초안
자동 가능공개자료 기반 리서치, 내부 제안서 초안, 질문 리스트
승인 필요고객 전달, 가격·납기·범위 확정, 고객 데이터 사용
검증사실/추정 분리, 고객 확인 필요 항목, 실행 가능성, 보안
Loggingwiki/work/projects/, wiki/work/resources/, wiki/work/logs/

9.3 AI Work OS / Methodology Cell

항목계약
Mission반복 업무를 Closed Loop, Skill Manual, 검증 기준으로 표준화한다.
Trigger반복 업무 발견, 실패 로그, 컨설팅 산출물, 운영 병목 발견
Inputs업무 절차, 입력/출력, 승인 경계, 실패 사례, 기존 표준
OutputsAgent Contract, Skill Manual, Loop 설계서, 검증 체크리스트
자동 가능내부 표준 초안, 루프 설계, 체크리스트 작성
승인 필요회사 표준 확정, 고객사 적용 가이드 외부 전달
검증Trigger/Input/Steps/Verification/Pitfalls/Approval 포함 여부
Loggingwiki/work/standards/, Hermes skills, wiki/work/logs/

9.4 Intelligence & Content Cell

항목계약
Mission외부 AI/AX 신호를 교육·컨설팅·콘텐츠·자동화 후보로 변환한다.
Trigger일일/주간 브리핑, 새 source 수집, 대표님 관심 주제, 뉴스 이벤트
Inputs원문 URL/파일, 출처, 주제, 대상 독자, 공개 가능성
Outputs트렌드 브리핑, 블로그 초안, 강의 후보, 컨설팅 시사점, OMW 노트
자동 가능내부 요약, 후보 분류, 블로그 초안 작성
승인 필요공개 게시, 외부 뉴스레터 발송, 단정적 시장 주장
검증출처 보존, 단일 출처 주장 표시, 내부 정보 제거
Loggingwiki/sources/, wiki/personal/projects/naver-blog/drafts/, wiki/teaching/

9.5 Operations & Quality Cell

항목계약
Mission요청 접수, 라우팅, 승인 대기, 품질 게이트, Evidence Package를 관리한다.
Trigger모든 대표님 요청, 메일/일정/고객/OMW 신호, 프로젝트 단계 변경
Inputs요청 원문, 업무 유형, 기한, 승인 필요 여부, 관련 문서
OutputsTask Contract, 진행상황 보드, 승인 대기 목록, Evidence Package
자동 가능내부 라우팅, 진행상황 정리, 검증 체크리스트 적용
승인 필요외부 영향이 있는 모든 실행, 일정 변경, 고객 전달
검증누락 업무, 승인 대기, OMW 경로, 실패 로그 확인
Loggingwiki/work/logs/, wiki/work/projects/, Slack/Telegram 브리핑

10. 금지 작업

에이전트는 대표님 명시 승인 없이 다음을 수행하지 않는다.

  • 외부 메일 발송.
  • 고객사 자료 외부 공유.
  • 공개 블로그/뉴스레터 게시.
  • 가격, 계약, 납기, 범위 확정.
  • 결제, 구독, 계정 권한 변경.
  • 고객 데이터 사용·분석·저장.
  • 파일 삭제, 공개 배포, 권한 확대.
  • 확인되지 않은 사실을 JYP Labs 성과처럼 표현.

11. OMW 저장 규칙

산출물기본 저장 위치
외부 원문/요약wiki/sources/
실행 계획/고객 프로젝트wiki/work/projects/
표준/계약/검증 기준wiki/work/standards/
템플릿/체크리스트/서비스 메뉴wiki/work/resources/
강의안/커리큘럼/워크숍wiki/teaching/
블로그 초안wiki/personal/projects/naver-blog/drafts/
실행/실패 로그wiki/work/logs/

12. 운영 도입 순서

P0

  1. 5개 Agent Cell에 본 표준을 적용한다.
  2. Sophie Task Contract 양식을 일일 운영에 사용한다.
  3. 외부 영향 작업은 Approval Gate로 분리한다.
  4. 모든 주요 산출물에 Evidence Package를 붙인다.

P1

  1. 15개 개별 에이전트별 상세 Contract를 작성한다.
  2. 교육/컨설팅/콘텐츠/Work OS 업무별 Handoff Packet 예시를 만든다.
  3. 실패 로그를 주간 리뷰에 반영한다.

P2

  1. 반복 업무 5개를 Hermes skill로 승격한다.
  2. 자동화 가능한 루프를 cron 또는 script로 전환한다.
  3. 에이전트별 성과가 아니라 루프별 성과를 측정한다.

13. 현행화 원칙

  • 에이전트 이름이 추가되어도 Contract가 없으면 운영 투입하지 않는다.
  • 실제 운영 중 실패한 항목은 이 문서의 Verification, Escalation, 금지 작업에 반영한다.
  • 기술 구현 프레임워크가 바뀌어도 본 문서의 핵심은 실행 계약, 권한 경계, 검증 루프다.
  • 실제 코드 에이전트를 구축할 경우 Pydantic AI 등 프레임워크는 Agent Contract를 YAML/구조화 출력으로 구현하는 수단으로만 사용한다.

대표님 승인 기록

날짜승인 내용후속 조치
2026-06-15대표님이 본 문서의 방향을 승인15개 전문가 에이전트 상세 Contract 작성 및 전문가 리뷰 진행