diff --git a/Gemini/gemini-harness/skills/gemini-harness/SKILL.md b/Gemini/gemini-harness/.gemini/skills/gemini-harness/SKILL.md similarity index 92% rename from Gemini/gemini-harness/skills/gemini-harness/SKILL.md rename to Gemini/gemini-harness/.gemini/skills/gemini-harness/SKILL.md index 6257449..f29a490 100644 --- a/Gemini/gemini-harness/skills/gemini-harness/SKILL.md +++ b/Gemini/gemini-harness/.gemini/skills/gemini-harness/SKILL.md @@ -8,7 +8,7 @@ description: "하네스를 구성합니다. 전문 에이전트를 정의하며, 도메인/프로젝트에 맞는 하네스를 구성하고, 각 에이전트의 역할을 정의하며, 에이전트가 사용할 스킬을 생성하는 메타 스킬. **핵심 원칙:** -1. 에이전트 정의(`.agents/agents/`)와 스킬(`.agents/skills/`)을 생성한다. +1. 에이전트 정의(`exports/.agents/agents/`)와 스킬(`exports/.agents/skills/`)을 생성한다. 2. **에이전트 팀을 기본 실행 모드로 사용한다.** 3. **AGENTS.md에 하네스 포인터를 등록한다.** — 새 세션에서 오케스트레이터 스킬이 트리거되도록 최소한의 포인터(트리거 규칙 + 변경 이력)만 기록한다. 4. **하네스는 고정물이 아니라 진화하는 시스템이다.** — 매 실행 후 피드백을 반영하고, 에이전트·스킬·AGENTS.md를 지속 갱신한다. @@ -19,7 +19,7 @@ description: "하네스를 구성합니다. 전문 에이전트를 정의하며, 하네스 스킬이 트리거되면 가장 먼저 기존 하네스 현황을 확인한다. -1. `프로젝트/.agents/agents/`, `프로젝트/.agents/skills/`, `프로젝트/AGENTS.md`를 읽는다 +1. `exports/.agents/agents/`, `exports/.agents/skills/`, `exports/AGENTS.md`를 읽는다 2. 현황에 따라 실행 모드를 분기한다: - **신규 구축**: 에이전트/스킬 디렉토리가 없거나 비어있음 → Phase 1부터 전체 실행 - **기존 확장**: 기존 하네스가 있고 새 에이전트/스킬 추가 요청 → 아래 Phase 선택 매트릭스에 따라 필요한 Phase만 실행 @@ -79,11 +79,11 @@ description: "하네스를 구성합니다. 전문 에이전트를 정의하며, #### 3-0. 기존 에이전트 중복 검토 -신규 에이전트 생성 전, `프로젝트/.agents/agents/`의 기존 에이전트와 중복 여부를 확인한다. 하네스를 반복 구축하다 보면 역할이 겹치는 에이전트가 다른 이름으로 누적되기 쉽다. +신규 에이전트 생성 전, `exports/.agents/agents/`의 기존 에이전트와 중복 여부를 확인한다. 하네스를 반복 구축하다 보면 역할이 겹치는 에이전트가 다른 이름으로 누적되기 쉽다. > 중복 분류 기준과 재사용 설계는 `references/agent-design-patterns.md`의 "에이전트 재사용 설계" 참조. -**모든 에이전트는 반드시 `프로젝트/.agents/agents/{name}.md` 파일로 정의한다.** 에이전트 정의 파일 없이 invoke_subagent 도구의 prompt에 역할을 직접 넣는 것은 금지한다. 이유: +**모든 에이전트는 반드시 `exports/.agents/agents/{name}.md` 파일로 정의한다.** 에이전트 정의 파일 없이 invoke_subagent 도구의 prompt에 역할을 직접 넣는 것은 금지한다. 이유: - 에이전트 정의가 파일로 존재해야 다음 세션에서 재사용 가능 - 팀 통신 프로토콜이 명시되어야 에이전트 간 협업 품질 보장 - 하네스의 핵심 가치는 에이전트(누가)와 스킬(어떻게)의 분리 @@ -94,7 +94,7 @@ description: "하네스를 구성합니다. 전문 에이전트를 정의하며, **팀 재구성:** 에이전트 팀은 세션당 한 팀만 활성화할 수 있지만, Phase 간에 팀을 해체하고 새 팀을 구성할 수 있다. 파이프라인 패턴처럼 Phase별로 다른 전문가 조합이 필요하면, 이전 팀의 산출물을 파일로 저장한 뒤 팀을 정리하고 새 팀을 생성한다. -각 에이전트를 `프로젝트/.agents/agents/{name}.md`에 정의한다. 필수 섹션: 핵심 역할, 작업 원칙, 입력/출력 프로토콜, 에러 핸들링, 협업. 에이전트 팀 모드에서는 `## 팀 통신 프로토콜` 섹션을 추가하여 메시지 수신/발신 대상과 작업 요청 범위를 명시한다. +각 에이전트를 `exports/.agents/agents/{name}.md`에 정의한다. 필수 섹션: 핵심 역할, 작업 원칙, 입력/출력 프로토콜, 에러 핸들링, 협업. 에이전트 팀 모드에서는 `## 팀 통신 프로토콜` 섹션을 추가하여 메시지 수신/발신 대상과 작업 요청 범위를 명시한다. > 정의 템플릿과 실제 파일 전문은 `references/agent-design-patterns.md`의 "에이전트 정의 구조" + `references/team-examples.md` 참조. @@ -106,11 +106,11 @@ description: "하네스를 구성합니다. 전문 에이전트를 정의하며, ### Phase 4: 스킬 생성 -각 에이전트가 사용할 스킬을 `프로젝트/.agents/skills/{name}/SKILL.md`에 생성한다. 상세 작성 가이드는 `references/skill-writing-guide.md` 참조. +각 에이전트가 사용할 스킬을 `exports/.agents/skills/{name}/SKILL.md`에 생성한다. 상세 작성 가이드는 `references/skill-writing-guide.md` 참조. #### 4-0. 기존 스킬 중복 검토 -신규 스킬 생성 전, `프로젝트/.agents/skills/`의 기존 스킬과 중복 여부를 확인한다. 하네스를 반복 구축하다 보면 기능이 겹치는 스킬이 다른 이름으로 누적되기 쉽다. +신규 스킬 생성 전, `exports/.agents/skills/`의 기존 스킬과 중복 여부를 확인한다. 하네스를 반복 구축하다 보면 기능이 겹치는 스킬이 다른 이름으로 누적되기 쉽다. > 중복 분류 기준과 일반화 패턴은 `references/skill-writing-guide.md`의 "스킬 재사용 설계" 참조. @@ -275,7 +275,7 @@ Phase마다 다른 모드를 섞어 구성한다. 자주 쓰이는 조합: | {YYYY-MM-DD} | 초기 구성 | 전체 | - | ```` -**AGENTS.md에 넣지 않는 것:** 에이전트 목록, 스킬 목록, 디렉토리 구조, 실행 규칙 상세. 이유: 에이전트/스킬 목록은 오케스트레이터 스킬과 `.agents/agents/`, `.agents/skills/`에서 관리하므로 중복이다. 디렉토리 구조는 파일 시스템에서 직접 확인 가능하다. AGENTS.md는 **포인터(트리거 규칙) + 변경 이력**만 담는다. +**AGENTS.md에 넣지 않는 것:** 에이전트 목록, 스킬 목록, 디렉토리 구조, 실행 규칙 상세. 이유: 에이전트/스킬 목록은 오케스트레이터 스킬과 `exports/.agents/agents/`, `exports/.agents/skills/`에서 관리하므로 중복이다. 디렉토리 구조는 파일 시스템에서 직접 확인 가능하다. AGENTS.md는 **포인터(트리거 규칙) + 변경 이력**만 담는다. #### 5-5. 후속 작업 지원 @@ -410,8 +410,8 @@ Phase마다 다른 모드를 섞어 구성한다. 자주 쓰이는 조합: 기존 하네스의 점검·수정·동기화를 체계적으로 수행한다. Phase 0에서 "운영/유지보수" 분기로 진입했을 때 이 워크플로우를 따른다. **Step 1: 현황 감사** -- `.agents/agents/` 파일 목록과 오케스트레이터 스킬의 에이전트 구성 비교 → 불일치 목록 생성 -- `.agents/skills/` 디렉토리 목록과 오케스트레이터 스킬의 스킬 구성 비교 → 불일치 목록 생성 +- `exports/.agents/agents/` 파일 목록과 오케스트레이터 스킬의 에이전트 구성 비교 → 불일치 목록 생성 +- `exports/.agents/skills/` 디렉토리 목록과 오케스트레이터 스킬의 스킬 구성 비교 → 불일치 목록 생성 - 감사 결과를 사용자에게 보고한다 **Step 2: 점진적 추가/수정** @@ -431,8 +431,8 @@ Phase마다 다른 모드를 섞어 구성한다. 자주 쓰이는 조합: 생성 완료 후 확인: -- [ ] `프로젝트/.agents/agents/` — **에이전트 정의 파일 필수 생성** (빌트인 타입이라도 파일 생성 필수) -- [ ] `프로젝트/.agents/skills/` — 스킬 파일들 (SKILL.md + references/) +- [ ] `exports/.agents/agents/` — **에이전트 정의 파일 필수 생성** (빌트인 타입이라도 파일 생성 필수) +- [ ] `exports/.agents/skills/` — 스킬 파일들 (SKILL.md + references/) - [ ] 오케스트레이터 스킬 1개 (데이터 흐름 + 에러 핸들링 + 테스트 시나리오 포함) - [ ] 실행 모드 명시 (에이전트 팀 / 서브 에이전트 / 하이브리드 중 선택, 하이브리드면 Phase별 모드 기재) - [ ] 모든 invoke_subagent 호출에 `model: "gemini-3.5-pro"` 파라미터 명시 diff --git a/Gemini/gemini-harness/skills/gemini-harness/references/agent-design-patterns.md b/Gemini/gemini-harness/.gemini/skills/gemini-harness/references/agent-design-patterns.md similarity index 95% rename from Gemini/gemini-harness/skills/gemini-harness/references/agent-design-patterns.md rename to Gemini/gemini-harness/.gemini/skills/gemini-harness/references/agent-design-patterns.md index 86ac94b..ed69730 100644 --- a/Gemini/gemini-harness/skills/gemini-harness/references/agent-design-patterns.md +++ b/Gemini/gemini-harness/.gemini/skills/gemini-harness/references/agent-design-patterns.md @@ -196,19 +196,19 @@ Phase별로 다른 전문가 조합이 필요하면, 이전 팀의 산출물을 ### 커스텀 타입 -`.agents/agents/{name}.md`에 에이전트를 정의하면 `TypeName: "{name}"`으로 호출할 수 있다. 커스텀 에이전트는 전체 도구에 접근 가능. +`exports/.agents/agents/{name}.md`에 에이전트를 정의하면 `TypeName: "{name}"`으로 호출할 수 있다. 커스텀 에이전트는 전체 도구에 접근 가능. ### 선택 기준 | 상황 | 권장 | 이유 | |------|------|------| -| 역할이 복잡하고 여러 세션에서 재사용 | **커스텀 타입** (`.agents/agents/`) | 페르소나와 작업 원칙을 파일로 관리 | +| 역할이 복잡하고 여러 세션에서 재사용 | **커스텀 타입** (`exports/.agents/agents/`) | 페르소나와 작업 원칙을 파일로 관리 | | 단순 조사/수집이고 프롬프트만으로 충분 | **`general-purpose`** + 상세 프롬프트 | 에이전트 파일 불필요, 프롬프트에 지시 포함 | | 코드 읽기만 필요 (분석/리뷰) | **`Explore`** | 실수로 파일 수정하는 것을 방지 | | 설계/계획만 필요 | **`Plan`** | 분석에 집중, 코드 변경 방지 | | 파일 수정이 필요한 구현 작업 | **커스텀 타입** | 전체 도구 접근 + 전문 지시 | -**원칙:** 모든 에이전트는 반드시 `.agents/agents/{name}.md` 파일로 정의한다. 빌트인 타입이라도 에이전트 정의 파일을 생성하여 역할·원칙·프로토콜을 명시한다. 파일로 존재해야 다음 세션에서 재사용 가능하고, 팀 통신 프로토콜이 명시되어야 협업 품질이 보장된다. +**원칙:** 모든 에이전트는 반드시 `exports/.agents/agents/{name}.md` 파일로 정의한다. 빌트인 타입이라도 에이전트 정의 파일을 생성하여 역할·원칙·프로토콜을 명시한다. 파일로 존재해야 다음 세션에서 재사용 가능하고, 팀 통신 프로토콜이 명시되어야 협업 품질이 보장된다. **모델:** 모든 에이전트는 `model: "gemini-3.5-pro"`를 사용한다. invoke_subagent 도구 호출 시 반드시 `model: "gemini-3.5-pro"` 파라미터를 명시한다. @@ -279,7 +279,7 @@ description: "1-2문장 역할 설명. 트리거 키워드 나열." | 구분 | 스킬 (Skill) | 에이전트 (Agent) | |------|-------------|-----------------| | 정의 | 절차적 지식 + 도구 번들 | 전문가 페르소나 + 행동 원칙 | -| 위치 | `.agents/skills/` | `.agents/agents/` | +| 위치 | `exports/.agents/skills/` | `exports/.agents/agents/` | | 트리거 | 사용자 요청 키워드 매칭 | invoke_subagent 도구로 명시적 호출 | | 크기 | 작은~큰 (워크플로우) | 작은 (역할 정의) | | 용도 | "어떻게 하는가" | "누가 하는가" | diff --git a/Gemini/gemini-harness/skills/gemini-harness/references/orchestrator-template.md b/Gemini/gemini-harness/.gemini/skills/gemini-harness/references/orchestrator-template.md similarity index 100% rename from Gemini/gemini-harness/skills/gemini-harness/references/orchestrator-template.md rename to Gemini/gemini-harness/.gemini/skills/gemini-harness/references/orchestrator-template.md diff --git a/Gemini/gemini-harness/skills/gemini-harness/references/qa-agent-guide.md b/Gemini/gemini-harness/.gemini/skills/gemini-harness/references/qa-agent-guide.md similarity index 100% rename from Gemini/gemini-harness/skills/gemini-harness/references/qa-agent-guide.md rename to Gemini/gemini-harness/.gemini/skills/gemini-harness/references/qa-agent-guide.md diff --git a/Gemini/gemini-harness/skills/gemini-harness/references/skill-testing-guide.md b/Gemini/gemini-harness/.gemini/skills/gemini-harness/references/skill-testing-guide.md similarity index 100% rename from Gemini/gemini-harness/skills/gemini-harness/references/skill-testing-guide.md rename to Gemini/gemini-harness/.gemini/skills/gemini-harness/references/skill-testing-guide.md diff --git a/Gemini/gemini-harness/skills/gemini-harness/references/skill-writing-guide.md b/Gemini/gemini-harness/.gemini/skills/gemini-harness/references/skill-writing-guide.md similarity index 100% rename from Gemini/gemini-harness/skills/gemini-harness/references/skill-writing-guide.md rename to Gemini/gemini-harness/.gemini/skills/gemini-harness/references/skill-writing-guide.md diff --git a/Gemini/gemini-harness/skills/gemini-harness/references/team-examples.md b/Gemini/gemini-harness/.gemini/skills/gemini-harness/references/team-examples.md similarity index 97% rename from Gemini/gemini-harness/skills/gemini-harness/references/team-examples.md rename to Gemini/gemini-harness/.gemini/skills/gemini-harness/references/team-examples.md index f759c6a..d5ba31b 100644 --- a/Gemini/gemini-harness/skills/gemini-harness/references/team-examples.md +++ b/Gemini/gemini-harness/.gemini/skills/gemini-harness/references/team-examples.md @@ -27,7 +27,7 @@ | background-researcher | general-purpose | 배경/경쟁/학술 | research_background.md | | (리더 = 오케스트레이터) | — | 통합 보고서 | 종합보고서.md | -> 리서치 에이전트는 `general-purpose` 빌트인 타입을 사용하되, 반드시 `.agents/agents/{name}.md` 파일로 정의한다. 파일에는 역할·조사 범위·팀 통신 프로토콜을 명시하여 재사용성과 협업 품질을 보장한다. +> 리서치 에이전트는 `general-purpose` 빌트인 타입을 사용하되, 반드시 `exports/.agents/agents/{name}.md` 파일로 정의한다. 파일에는 역할·조사 범위·팀 통신 프로토콜을 명시하여 재사용성과 협업 품질을 보장한다. ### 오케스트레이터 워크플로우 (에이전트 팀) @@ -316,12 +316,12 @@ test ────send_message──→ security ("인증 모듈 테스트 ## 산출물 패턴 요약 ### 에이전트 정의 파일 -위치: `프로젝트/.agents/agents/{agent-name}.md` +위치: `exports/.agents/agents/{agent-name}.md` 필수 섹션: 핵심 역할, 작업 원칙, 입력/출력 프로토콜, 에러 핸들링, 협업 팀 모드 추가 섹션: **팀 통신 프로토콜** (메시지 수신/발신, 작업 요청 범위) ### 스킬 파일 구조 -위치: `프로젝트/.agents/skills/{skill-name}/SKILL.md` (프로젝트 레벨) +위치: `exports/.agents/skills/{skill-name}/SKILL.md` (프로젝트 레벨) 또는: `~/.agents/skills/{skill-name}/SKILL.md` (글로벌 레벨) ### 통합 스킬 (오케스트레이터) diff --git a/Gemini/gemini-harness/GEMINI.md b/Gemini/gemini-harness/GEMINI.md index b1bcd11..f5ca398 100644 --- a/Gemini/gemini-harness/GEMINI.md +++ b/Gemini/gemini-harness/GEMINI.md @@ -19,7 +19,7 @@ ### 3. 하네스 설계 철학 준수 - **에이전트 팀 우선**: 단일 거대 에이전트보다는 역할이 분리된 에이전트 팀(`invoke_subagent` 및 `send_message` 활용)의 협업을 지향하도록 설계원칙을 유지합니다. -- **파일 기반 구조화**: 모든 에이전트는 `.agents/agents/{name}.md`에, 스킬은 `.agents/skills/{name}/SKILL.md`에 독립적으로 정의되도록 템플릿과 생성 규칙을 엄격히 관리합니다. +- **파일 기반 구조화**: 모든 에이전트는 `exports/.agents/agents/{name}.md`에, 스킬은 `exports/.agents/skills/{name}/SKILL.md`에 독립적으로 정의되도록 템플릿과 생성 규칙을 엄격히 관리합니다. - **진화하는 시스템**: 피드백을 기반으로 하네스가 스스로를 갱신할 수 있는 운영/유지보수 워크플로우(Phase 7) 체계를 지속적으로 강화합니다. ### 4. 코드 작성 및 수정 지침