ai:templates_agents
AGENTS 템플릿 (에이전트 운영 설명서)
이 문서는 새 인공지능 에이전트가 사용할 `AGENTS.md`의 기본 형태를 정의합니다.
각 에이전트는 자신의 Workspace 디렉터리에 이 템플릿을 복사한 뒤, `<…>` 부분을 실제 값으로 채워 넣습니다.
목적
- 이 에이전트가 어떤 역할과 책임을 가지는지 정리하는 “운영 설명서” 역할
- 담당자와 다른 에이전트가 이 파일만 보고도, 이 에이전트의 업무 범위를 이해할 수 있게 함
기본 구조
- 파일명: `AGENTS.md`
- 위치 예시: `/path/to/agent-workspace/AGENTS.md`
템플릿
```markdown # AGENTS.md - Agent Profile
## 1. Role / Responsibilities
- Type: <Workspace Agent | Personal Assistant Agent> - 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에서 이 에이전트가 어떻게 일해야 하는지 구체화합니다.
ai/templates_agents.txt · 마지막으로 수정됨: 저자 127.0.0.1