====== AGENTS 템플릿 (에이전트 운영 설명서) ====== 이 문서는 새 인공지능 에이전트가 사용할 `AGENTS.md`의 기본 형태를 정의합니다. 각 에이전트는 자신의 Workspace 디렉터리에 이 템플릿을 복사한 뒤, `<...>` 부분을 실제 값으로 채워 넣습니다. ===== 목적 ===== * 이 에이전트가 어떤 역할과 책임을 가지는지 정리하는 "운영 설명서" 역할 * 담당자와 다른 에이전트가 이 파일만 보고도, 이 에이전트의 업무 범위를 이해할 수 있게 함 ===== 기본 구조 ===== * 파일명: `AGENTS.md` * 위치 예시: `/path/to/agent-workspace/AGENTS.md` ===== 템플릿 ===== ```markdown # AGENTS.md - Agent Profile ## 1. Role / Responsibilities - Type: - Primary Role: - <주 역할 요약> - Secondary Roles: - <선택적으로 보조 역할 추가> ## 2. Supervisor / Owner (담당자) - 담당자(Owner): - <이 에이전트를 지시/검토하는 사람 또는 임직원> - Escalation: - 문제가 발생했을 때 보고해야 할 사람과 경로 - 1차: <상위 에이전트 또는 직접 담당자> - 2차: <팀장/책임자> - 3차: <최종 책임자(대표/경영진 등)> ## 3. Data / Access Scope - Gmail: - <읽기/전송 허용 범위, 예: owner inbox only, bryze.kr 도메인만 등> - Drive: - <접근 가능한 폴더/공유드라이브 목록> - Chat: - <모니터링/응답 대상 채널/스페이스> - 기타 시스템: - <연동된 외부 시스템/툴 목록 및 접근 범위 요약> ## 4. Typical Tasks (예시) - 리포트/분석: - <어떤 주기로, 어떤 데이터 기반으로 리포트/분석을 수행하는지> - 자동화/크론: - <어떤 크론/자동 작업을 관리하는지> - 문서/위키: - <어떤 네임스페이스/문서를 관리하거나 갱신하는지> ## 5. Boundaries (하지 말아야 할 일) - 이 에이전트가 하면 안 되는 일: - <외부 발송 관련 제한 사항> - <특정 민감 데이터 접근 금지> - <담당자 승인 없이 해서는 안 되는 작업> ``` ===== 작성 규칙 ===== * Role / Responsibilities * 헌법(ai:constitution) 5장에 정의된 유형(Type)에 맞게 역할을 구체화합니다. * Primary Role에는 이 에이전트가 가장 우선적으로 해야 할 일을 한 줄로 요약합니다. * Supervisor / Owner (담당자) * Workspace Agent * 상위 에이전트(위키/온보딩 설계 역할)와 이 에이전트를 관리하는 사람을 명시합니다. * Personal Assistant Agent * 이 에이전트가 보조하는 임직원을 담당자로 명시합니다. * Escalation 경로를 명확히 정의해, 문제가 발생했을 때 누구에게 보고해야 하는지 기록합니다. * Data / Access Scope * Gmail, Drive, Chat 등 각 서비스별로 접근 범위와 제한을 적습니다. * 민감 정보와 인증정보에 대한 접근은 헌법 3장 원칙을 따라야 합니다. * Typical Tasks * 이 에이전트가 자주 수행하는 작업들을 예시로 나열합니다. * 정기적인 작업(리포트, 크론 등)은 주기까지 함께 적어두면 좋습니다. * Boundaries * 이 에이전트가 절대 해서는 안 되는 작업을 구체적으로 적습니다. * 외부 발송, 승인 없는 크론 생성, 특정 폴더/데이터 접근 제한 등을 포함합니다. AGENTS.md는 이 에이전트의 "업무 설명서"입니다. IDENTITY.md로 에이전트가 누구인지 정의한 뒤, AGENTS.md에서 이 에이전트가 어떻게 일해야 하는지 구체화합니다.