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 Update3.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 메시지 일관성 |
| Logging | wiki/teaching/, wiki/work/resources/, 관련 project 문서 |
9.2 AX Consulting Cell
| 항목 | 계약 |
|---|---|
| Mission | 고객 문제를 진단하고 AX 실행 과제와 제안서 초안을 만든다. |
| Trigger | 고객 문의, 미팅 예정, 교육 후 컨설팅 가능성, 대표님 요청 |
| Inputs | 고객명, 산업, 공개자료, 미팅 맥락, 문제 가설, 산출물 범위 |
| Outputs | 고객 리서치, 업무 프로세스 맵, AX 진단, 자동화 후보, 제안서 초안 |
| 자동 가능 | 공개자료 기반 리서치, 내부 제안서 초안, 질문 리스트 |
| 승인 필요 | 고객 전달, 가격·납기·범위 확정, 고객 데이터 사용 |
| 검증 | 사실/추정 분리, 고객 확인 필요 항목, 실행 가능성, 보안 |
| Logging | wiki/work/projects/, wiki/work/resources/, wiki/work/logs/ |
9.3 AI Work OS / Methodology Cell
| 항목 | 계약 |
|---|---|
| Mission | 반복 업무를 Closed Loop, Skill Manual, 검증 기준으로 표준화한다. |
| Trigger | 반복 업무 발견, 실패 로그, 컨설팅 산출물, 운영 병목 발견 |
| Inputs | 업무 절차, 입력/출력, 승인 경계, 실패 사례, 기존 표준 |
| Outputs | Agent Contract, Skill Manual, Loop 설계서, 검증 체크리스트 |
| 자동 가능 | 내부 표준 초안, 루프 설계, 체크리스트 작성 |
| 승인 필요 | 회사 표준 확정, 고객사 적용 가이드 외부 전달 |
| 검증 | Trigger/Input/Steps/Verification/Pitfalls/Approval 포함 여부 |
| Logging | wiki/work/standards/, Hermes skills, wiki/work/logs/ |
9.4 Intelligence & Content Cell
| 항목 | 계약 |
|---|---|
| Mission | 외부 AI/AX 신호를 교육·컨설팅·콘텐츠·자동화 후보로 변환한다. |
| Trigger | 일일/주간 브리핑, 새 source 수집, 대표님 관심 주제, 뉴스 이벤트 |
| Inputs | 원문 URL/파일, 출처, 주제, 대상 독자, 공개 가능성 |
| Outputs | 트렌드 브리핑, 블로그 초안, 강의 후보, 컨설팅 시사점, OMW 노트 |
| 자동 가능 | 내부 요약, 후보 분류, 블로그 초안 작성 |
| 승인 필요 | 공개 게시, 외부 뉴스레터 발송, 단정적 시장 주장 |
| 검증 | 출처 보존, 단일 출처 주장 표시, 내부 정보 제거 |
| Logging | wiki/sources/, wiki/personal/projects/naver-blog/drafts/, wiki/teaching/ |
9.5 Operations & Quality Cell
| 항목 | 계약 |
|---|---|
| Mission | 요청 접수, 라우팅, 승인 대기, 품질 게이트, Evidence Package를 관리한다. |
| Trigger | 모든 대표님 요청, 메일/일정/고객/OMW 신호, 프로젝트 단계 변경 |
| Inputs | 요청 원문, 업무 유형, 기한, 승인 필요 여부, 관련 문서 |
| Outputs | Task Contract, 진행상황 보드, 승인 대기 목록, Evidence Package |
| 자동 가능 | 내부 라우팅, 진행상황 정리, 검증 체크리스트 적용 |
| 승인 필요 | 외부 영향이 있는 모든 실행, 일정 변경, 고객 전달 |
| 검증 | 누락 업무, 승인 대기, OMW 경로, 실패 로그 확인 |
| Logging | wiki/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
- 5개 Agent Cell에 본 표준을 적용한다.
- Sophie Task Contract 양식을 일일 운영에 사용한다.
- 외부 영향 작업은 Approval Gate로 분리한다.
- 모든 주요 산출물에 Evidence Package를 붙인다.
P1
- 15개 개별 에이전트별 상세 Contract를 작성한다.
- 교육/컨설팅/콘텐츠/Work OS 업무별 Handoff Packet 예시를 만든다.
- 실패 로그를 주간 리뷰에 반영한다.
P2
- 반복 업무 5개를 Hermes skill로 승격한다.
- 자동화 가능한 루프를 cron 또는 script로 전환한다.
- 에이전트별 성과가 아니라 루프별 성과를 측정한다.
13. 현행화 원칙
- 에이전트 이름이 추가되어도 Contract가 없으면 운영 투입하지 않는다.
- 실제 운영 중 실패한 항목은 이 문서의 Verification, Escalation, 금지 작업에 반영한다.
- 기술 구현 프레임워크가 바뀌어도 본 문서의 핵심은 실행 계약, 권한 경계, 검증 루프다.
- 실제 코드 에이전트를 구축할 경우 Pydantic AI 등 프레임워크는 Agent Contract를 YAML/구조화 출력으로 구현하는 수단으로만 사용한다.
대표님 승인 기록
| 날짜 | 승인 내용 | 후속 조치 |
|---|---|---|
| 2026-06-15 | 대표님이 본 문서의 방향을 승인 | 15개 전문가 에이전트 상세 Contract 작성 및 전문가 리뷰 진행 |