차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

--- ai:templates_agents [2026-10-30 12:08] – DokuWiki 솔루션 이전; 공개 인증정보 정제. 기존 본문/목차 보존. migration
+++ ai:templates_agents [2026-10-30 14:55] (현재) – 바깥 편집 127.0.0.1
@@ 줄 1: / 줄 1: @@
+====== 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에서 이 에이전트가 어떻게 일해야 하는지 구체화합니다.