moai-adk 0.3.13__py3-none-any.whl → 0.4.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-claude-code/templates/agent-full.md

@@ -0,0 +1,332 @@
+---
+name: {agent-name}
+description: "Use when: {detailed-trigger-condition-with-context}"
+tools: Read, Write, Edit, MultiEdit, Grep, Glob, Bash, TodoWrite, WebFetch
+model: sonnet
+---
+
+# {Agent Name} - {Specialist Title}
+
+**{Comprehensive 2-3 sentence description of agent's role, expertise, and unique value proposition}**
+
+## 🎭 에이전트 페르소나 (전문 개발자 직무)
+
+**아이콘**: {emoji}
+**직무**: {job-title-kr} ({job-title-en})
+**전문 영역**: {detailed-expertise-description}
+**역할**: {comprehensive-role-and-responsibilities}
+**목표**: {specific-measurable-goals}
+
+### 전문가 특성
+
+- **사고 방식**: {how-this-agent-approaches-problems}
+- **의사결정 기준**: {what-principles-guide-decisions}
+- **커뮤니케이션 스타일**: {how-agent-interacts-with-users}
+- **전문 분야**: {specific-technical-domains-1}, {domain-2}, {domain-3}
+
+## 🎯 핵심 역할
+
+### 1. {Primary Responsibility Area}
+
+- **{Sub-responsibility 1}**: {detailed-description-of-what-this-involves}
+- **{Sub-responsibility 2}**: {detailed-description-with-examples}
+- **{Sub-responsibility 3}**: {description-and-expected-outcomes}
+
+### 2. 자동 실행 조건
+
+- {Specific trigger situation 1 with context}
+- {Specific trigger situation 2 with context}
+- {Specific trigger situation 3 with context}
+
+## 📐 워크플로우 (상세)
+
+### STEP 1: {First Major Step Title}
+
+**목적**: {Clear statement of what this step accomplishes}
+
+**실행**:
+```bash
+# {Command description}
+{command-1}
+
+# {Another command description}
+{command-2}
+
+# {Final command in this step}
+{command-3}
+```
+
+**산출물**:
+- {Detailed output 1 with format/structure}
+- {Detailed output 2 with expected values}
+- {Detailed output 3 with validation criteria}
+
+**검증**:
+- [ ] {Validation criterion 1 - what to check}
+- [ ] {Validation criterion 2 - expected result}
+- [ ] {Validation criterion 3 - error conditions}
+
+---
+
+### STEP 2: {Second Major Step Title}
+
+**목적**: {Clear statement of purpose}
+
+**실행**:
+```bash
+# {Detailed command explanation}
+{command}
+```
+
+**산출물**:
+```{format}
+{example-output-structure}
+```
+
+**검증**:
+- [ ] {Validation 1}
+- [ ] {Validation 2}
+
+---
+
+### STEP 3: {Third Major Step Title}
+
+**목적**: {Purpose statement}
+
+**실행**:
+```bash
+{commands}
+```
+
+**산출물**:
+- {Output description}
+
+## 🤝 사용자 상호작용
+
+### AskUserQuestion 사용 시점
+
+{agent-name}는 다음 상황에서 **AskUserQuestion 도구**를 사용합니다:
+
+#### 1. {Situation 1 Title}
+
+**상황**: {Detailed description of when this occurs}
+
+**예시 질문**:
+```typescript
+AskUserQuestion({
+  questions: [{
+    question: "{Specific question to ask user}?",
+    header: "{Short header text}",
+    options: [
+      {
+        label: "{Option 1}",
+        description: "{What happens if user chooses this}"
+      },
+      {
+        label: "{Option 2}",
+        description: "{What happens if user chooses this}"
+      },
+      {
+        label: "{Option 3}",
+        description: "{Alternative choice explanation}"
+      }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+**처리 로직**:
+```typescript
+// Based on user response
+if (answer === "Option 1") {
+  // {What agent does for this choice}
+} else if (answer === "Option 2") {
+  // {What agent does for this choice}
+}
+```
+
+---
+
+#### 2. {Situation 2 Title}
+
+**상황**: {When this interaction is needed}
+
+**예시 질문**:
+```typescript
+AskUserQuestion({
+  questions: [{
+    question: "{Another scenario question}?",
+    header: "{Header}",
+    options: [
+      { label: "{Choice A}", description: "{Impact of choice A}" },
+      { label: "{Choice B}", description: "{Impact of choice B}" }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+## ⚠️ 제약사항
+
+### 금지 사항
+
+- ❌ {Prohibited action 1 with explanation why}
+- ❌ {Prohibited action 2 with security/safety reason}
+- ❌ {Prohibited action 3 with alternative approach}
+
+### 위임 규칙
+
+- **{Agent/Tool 1}** → {When to delegate to this agent}
+- **{Agent/Tool 2}** → {When to use this instead}
+- **{Agent/Tool 3}** → {Delegation condition}
+
+### 권한 제한
+
+- 파일 접근: {List allowed directories/patterns}
+- 명령 실행: {List allowed bash patterns}
+- 외부 리소스: {List allowed external resources}
+
+## ✅ 품질 게이트
+
+### 완료 기준
+
+- [ ] {Completion criterion 1 with measurable target}
+- [ ] {Completion criterion 2 with validation method}
+- [ ] {Completion criterion 3 with expected state}
+- [ ] {Completion criterion 4 with deliverable}
+
+### 에러 처리
+
+**일반적인 오류 및 해결책**:
+
+| 오류 유형 | 원인 | 해결 방법 |
+|----------|------|----------|
+| {Error Type 1} | {Root cause} | {Step-by-step solution} |
+| {Error Type 2} | {What causes it} | {How to fix it} |
+| {Error Type 3} | {Trigger condition} | {Resolution steps} |
+
+**에러 복구 프로세스**:
+1. {First recovery step}
+2. {Second recovery step}
+3. {Fallback procedure}
+
+### 성능 기준
+
+- **실행 시간**: {Expected duration}
+- **메모리 사용**: {Expected resource usage}
+- **출력 크기**: {Expected output size}
+
+## 💡 사용 가이드
+
+### 직접 호출
+
+```bash
+# Basic usage
+@agent-{agent-name} "{simple task description}"
+
+# With specific context
+@agent-{agent-name} "{detailed task with context and constraints}"
+
+# With options
+@agent-{agent-name} "{task}" --option1 value1 --option2 value2
+```
+
+### 자동 실행 조건
+
+- {Auto-trigger condition 1 with example}
+- {Auto-trigger condition 2 with keyword pattern}
+- {Auto-trigger condition 3 with context requirement}
+
+### 베스트 프랙티스
+
+1. **{Practice 1 Title}**
+   - {Detailed explanation}
+   - Example: `{code-or-command-example}`
+
+2. **{Practice 2 Title}**
+   - {Why this is important}
+   - Anti-pattern: ❌ `{what-not-to-do}`
+   - Correct: ✅ `{what-to-do-instead}`
+
+3. **{Practice 3 Title}**
+   - {Best approach}
+   - When to apply: {Specific scenarios}
+
+## 🔗 통합 및 협업
+
+### 연관 에이전트
+
+- **{Agent 1}** ({Icon} {Role}): {How they collaborate}
+- **{Agent 2}** ({Icon} {Role}): {Handoff scenarios}
+- **{Agent 3}** ({Icon} {Role}): {Integration points}
+
+### 커맨드 통합
+
+- **{Command 1}** - {When this command invokes this agent}
+- **{Command 2}** - {Integration scenario}
+
+### MoAI-ADK 워크플로우 위치
+
+```
+/alfred:1-spec → /alfred:2-build → /alfred:3-sync
+      ↑                ↑                ↑
+  {Where this agent fits in the workflow}
+```
+
+## 📊 예제 시나리오
+
+### 시나리오 1: {Common Use Case Title}
+
+**입력**:
+```
+{Example user request}
+```
+
+**실행 과정**:
+1. {What agent does in step 1}
+2. {What agent does in step 2}
+3. {What agent does in step 3}
+
+**출력**:
+```{format}
+{example-output}
+```
+
+**검증 결과**:
+- ✅ {Verification 1 passed}
+- ✅ {Verification 2 passed}
+
+---
+
+### 시나리오 2: {Edge Case Title}
+
+**입력**:
+```
+{Complex user request}
+```
+
+**처리**:
+- {How agent handles complexity}
+- {Special considerations}
+
+**출력**:
+- {Result description}
+
+## 📚 참고 자료
+
+- **공식 문서**: {Link to relevant documentation}
+- **관련 스킬**: {Link to complementary skills}
+- **MoAI-ADK 가이드**: {Link to internal guide}
+
+---
+
+**Template Level**: Full
+**Best For**: Production MoAI-ADK projects, enterprise workflows
+**Features**: Complete feature set, AskUserQuestion, quality gates, error handling
+**Estimated Setup Time**: 30-45 minutes
+**Maintenance**: Regular updates recommended
+
+---
+
+이 {agent-name}는 {expertise-domain}의 최고 표준을 제공합니다.

moai_adk/templates/.claude/skills/moai-claude-code/templates/command-full.md

@@ -0,0 +1,384 @@
+---
+name: {command-name}
+description: {Comprehensive one-line description with context}
+argument-hint: [{param1}] [{param2}] [{options}]
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - MultiEdit
+  - Grep
+  - Glob
+  - TodoWrite
+  - Task
+  - Bash(git:*)
+  - Bash({specific-pattern}:*)
+---
+
+# 📋 {Command Title}
+
+{Comprehensive 2-3 sentence description of command's purpose, integration with MoAI-ADK workflow, and key benefits}
+
+## 🎯 커맨드 목적
+
+{Detailed multi-paragraph explanation covering:
+- What problem this command solves
+- How it fits into the larger workflow
+- When to use this command vs alternatives
+- What makes this command unique/valuable}
+
+## 📋 실행 흐름 (2-Phase 구조)
+
+### ⚙️ Phase 0: 환경 분석 (선택적)
+
+**목적**: {Pre-execution analysis purpose}
+
+**실행**:
+```bash
+# {Environment check description}
+{command-1}
+
+# {Prerequisites verification}
+{command-2}
+```
+
+**검증**:
+- [ ] {Prerequisite 1 checked}
+- [ ] {Prerequisite 2 verified}
+
+---
+
+### 📊 Phase 1: {Planning/Analysis Phase}
+
+**목적**: {Detailed purpose of planning phase}
+
+**자동 처리**:
+- {Auto-task 1 that happens without user input}
+- {Auto-task 2 that system handles}
+- {Auto-task 3 performed automatically}
+
+**실행 단계**:
+
+#### 1.1 {First Sub-Step}
+```bash
+# {Detailed explanation}
+{command-or-action}
+```
+
+**산출물**:
+- {Output 1 with format specification}
+- {Output 2 with expected structure}
+
+#### 1.2 {Second Sub-Step}
+```bash
+{commands}
+```
+
+**산출물**:
+- {Intermediate output description}
+
+#### 1.3 {사용자 확인}
+
+**AskUserQuestion 시점**: {When user confirmation is needed}
+
+**확인 내용**:
+```typescript
+AskUserQuestion({
+  questions: [{
+    question: "{What to ask user}?",
+    header: "{Short header}",
+    options: [
+      { label: "진행", description: "Phase 2 실행" },
+      { label: "수정", description: "{What modification means}" },
+      { label: "중단", description: "작업 취소" }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+**Phase 1 산출물 (최종)**:
+- {Complete output 1 from planning}
+- {Complete output 2 ready for execution}
+- {User-approved plan}
+
+---
+
+### 🚀 Phase 2: {Execution Phase}
+
+**목적**: {Detailed purpose of execution phase}
+
+**사전 조건**:
+- [ ] Phase 1 완료 및 사용자 승인
+- [ ] {Additional precondition 1}
+- [ ] {Additional precondition 2}
+
+**실행 단계**:
+
+#### 2.1 {First Execution Step}
+```bash
+# {What this does}
+{execution-command-1}
+
+# {Next action}
+{execution-command-2}
+```
+
+**실시간 진행 상황**:
+```
+{Progress indicator format}
+[▓▓▓▓▓▓▓░░░] {percentage}% - {current-action}
+```
+
+#### 2.2 {Second Execution Step}
+```bash
+{commands-with-explanations}
+```
+
+#### 2.3 {품질 검증}
+```bash
+# {Validation check 1}
+{validation-command-1}
+
+# {Validation check 2}
+{validation-command-2}
+```
+
+**검증 기준**:
+- [ ] {Quality criterion 1 with threshold}
+- [ ] {Quality criterion 2 with expected value}
+- [ ] {Quality criterion 3 with pass/fail}
+
+**Phase 2 최종 산출물**:
+```{format}
+{example-final-output-structure}
+```
+
+## 🔗 연관 에이전트
+
+### Primary Agent
+- **{agent-name}** ({Icon} {Persona})
+  - **전문 영역**: {Expertise}
+  - **호출 시점**: {When invoked}
+  - **역할**: {What agent does in this command}
+
+### Secondary Agents
+- **{agent-2}** ({Icon} {Role}) - {Integration scenario}
+- **{agent-3}** ({Icon} {Role}) - {When used}
+
+## 💡 사용 예시
+
+### 기본 사용
+```bash
+/{command-name} {basic-example}
+```
+
+### 고급 사용
+```bash
+# {Advanced use case 1}
+/{command-name} {param1} --{option1}={value1}
+
+# {Advanced use case 2}
+/{command-name} {param1} {param2} --{flag}
+```
+
+### 실전 시나리오
+
+#### 시나리오 1: {Common Workflow}
+```bash
+# Step 1: {What user does first}
+/{command-name} "{example-input}"
+
+# Result: {What happens}
+# Next: {What to do next}
+```
+
+#### 시나리오 2: {Edge Case}
+```bash
+# When {special condition}
+/{command-name} {special-params}
+
+# Handles: {How command adapts}
+```
+
+## 명령어 인수 상세
+
+| 인수/옵션 | 타입 | 필수 | 기본값 | 설명 |
+|----------|------|------|--------|------|
+| `{param1}` | {type} | ✅ | - | {Detailed description of param1} |
+| `{param2}` | {type} | ⚠️ | {default} | {Detailed description of param2} |
+| `--{option1}` | {type} | ⚠️ | {default} | {What this option controls} |
+| `--{flag}` | boolean | ⚠️ | false | {When to use this flag} |
+
+**인수 검증**:
+- {Validation rule 1}
+- {Validation rule 2}
+
+## ⚠️ 금지 사항
+
+**절대 하지 말아야 할 작업**:
+
+- ❌ {Prohibited action 1 with explanation}
+- ❌ {Prohibited action 2 with reason}
+- ❌ {Prohibited action 3 with alternative}
+
+**사용해야 할 표현**:
+
+- ✅ {Recommended practice 1}
+- ✅ {Recommended practice 2}
+
+## 🚨 에러 처리
+
+### 일반적인 오류
+
+| 에러 메시지 | 원인 | 해결 방법 |
+|-----------|------|----------|
+| `{Error 1}` | {Root cause} | {Step-by-step solution} |
+| `{Error 2}` | {What triggers it} | {How to fix} |
+| `{Error 3}` | {Condition} | {Resolution} |
+
+### 복구 절차
+
+1. **{Recovery Step 1}**: {What to do first}
+2. **{Recovery Step 2}**: {Next action}
+3. **{Fallback}**: {Last resort if all fails}
+
+## ✅ 성공 기준
+
+**커맨드 실행 후 확인 사항**:
+
+- [ ] {Success criterion 1 with verification method}
+- [ ] {Success criterion 2 with expected outcome}
+- [ ] {Success criterion 3 with deliverable}
+
+**품질 게이트**:
+```bash
+# {Quality check 1}
+{verification-command-1}
+
+# {Quality check 2}
+{verification-command-2}
+```
+
+## 📋 다음 단계
+
+**권장 워크플로우**:
+
+1. **즉시 실행**: {What to do right after command completes}
+2. **검증**: {How to verify results}
+3. **다음 커맨드**: `/{next-command}` - {Why this is next}
+
+**대안 경로**:
+- {Alternative path 1 if condition X}
+- {Alternative path 2 if condition Y}
+
+## 🔄 통합 워크플로우
+
+### MoAI-ADK 워크플로우 위치
+
+```
+/{prev-command} → /{command-name} → /{next-command}
+                        ↓
+                {Connected agents/tasks}
+```
+
+### 다른 커맨드와의 관계
+
+| 커맨드 | 관계 | 실행 순서 |
+|--------|------|----------|
+| `/{related-1}` | {Relationship} | {Before/After/Parallel} |
+| `/{related-2}` | {Relationship} | {Sequence} |
+
+## 📊 성능 메트릭
+
+- **평균 실행 시간**: {Expected duration}
+- **메모리 사용량**: {Expected memory}
+- **생성 파일 수**: {Expected file count}
+- **API 호출**: {Expected external calls}
+
+## 🎓 베스트 프랙티스
+
+### 1. {Practice Category 1}
+
+**권장**:
+```bash
+# {Good example}
+/{command-name} {recommended-usage}
+```
+
+**비권장**:
+```bash
+# {Bad example - why to avoid}
+/{command-name} {anti-pattern}
+```
+
+### 2. {Practice Category 2}
+
+**팁**: {Helpful tip or trick}
+
+### 3. {Practice Category 3}
+
+**주의**: {Important consideration}
+
+## 🔗 관련 리소스
+
+### 관련 커맨드
+- `/{command-1}` - {Description and relation}
+- `/{command-2}` - {Description and when to use}
+
+### 관련 에이전트
+- `@agent-{agent-1}` - {How it supports this command}
+- `@agent-{agent-2}` - {Integration point}
+
+### 문서
+- **SPEC**: {Link to specification}
+- **가이드**: {Link to detailed guide}
+- **예제**: {Link to examples}
+
+## 📝 커맨드 출력 예시
+
+**성공 케이스**:
+```
+✅ {Command Name} 완료
+
+📊 실행 결과:
+- {Result metric 1}: {value}
+- {Result metric 2}: {value}
+- {Result metric 3}: {value}
+
+📁 생성된 파일:
+- {File 1}: {Description}
+- {File 2}: {Description}
+
+📋 다음 단계:
+- {Next step 1}
+- {Next step 2}
+```
+
+**에러 케이스**:
+```
+❌ {Command Name} 실패
+
+🔍 에러 상세:
+- 유형: {Error type}
+- 위치: {Where error occurred}
+- 메시지: {Error message}
+
+💡 해결 방법:
+1. {Solution step 1}
+2. {Solution step 2}
+
+📞 추가 도움: {Where to get help}
+```
+
+---
+
+**Template Level**: Full
+**Best For**: Production MoAI-ADK workflows, enterprise automation
+**Features**: 2-phase structure, quality gates, comprehensive error handling, integration
+**Estimated Setup Time**: 30-45 minutes
+**Maintenance**: Regular updates recommended as workflows evolve
+
+---
+
+이 커맨드는 {workflow-domain}의 표준 자동화를 제공합니다.