moai-adk 0.4.5__py3-none-any.whl → 0.20.1__py3-none-any.whl

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

@@ -1,332 +0,0 @@
----
-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}**
-
-## 🎭 Agent Persona (Professional Developer Job)
-
-**Icon**: {emoji}
-**Job**: {job-title-kr} ({job-title-en})
-**Expertise**: {detailed-expertise-description}
-**Role**: {comprehensive-role-and-responsibilities}
-**Goals**: {specific-measurable-goals}
-
-### Expert Traits
-
-- **Thinking style**: {how-this-agent-approaches-problems}
-- **Decision-making criteria**: {what-principles-guide-decisions}
-- **Communication style**: {how-agent-interacts-with-users}
-- **Areas of expertise**: {specific-technical-domains-1}, {domain-2}, {domain-3}
-
-## 🎯 Key Role
-
-### 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. Autorun conditions
-
-- {Specific trigger situation 1 with context}
-- {Specific trigger situation 2 with context}
-- {Specific trigger situation 3 with context}
-
-## 📐 Workflow (detailed)
-
-### STEP 1: {First Major Step Title}
-
-**Purpose**: {Clear statement of what this step accomplishes}
-
-**execution**:
-```bash
-# {Command description}
-{command-1}
-
-# {Another command description}
-{command-2}
-
-# {Final command in this step}
-{command-3}
-```
-
-**Output**:
-- {Detailed output 1 with format/structure}
-- {Detailed output 2 with expected values}
-- {Detailed output 3 with validation criteria}
-
-**verification**:
-- [ ] {Validation criterion 1 - what to check}
-- [ ] {Validation criterion 2 - expected result}
-- [ ] {Validation criterion 3 - error conditions}
-
----
-
-### STEP 2: {Second Major Step Title}
-
-**Purpose**: {Clear statement of purpose}
-
-**execution**:
-```bash
-# {Detailed command explanation}
-{command}
-```
-
-**Output**:
-```{format}
-{example-output-structure}
-```
-
-**verification**:
-- [ ] {Validation 1}
-- [ ] {Validation 2}
-
----
-
-### STEP 3: {Third Major Step Title}
-
-**Purpose**: {Purpose statement}
-
-**execution**:
-```bash
-{commands}
-```
-
-**Output**:
-- {Output description}
-
-## 🤝 User Interaction
-
-### When to use AskUserQuestion
-
-{agent-name} uses the **AskUserQuestion tool** in the following situations:
-
-#### 1. {Situation 1 Title}
-
-**Scenario**: {Detailed description of when this occurs}
-
-**Example Questions**:
-```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
-  }]
-})
-```
-
-**Processing Logic**:
-```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}
-
-**Scenario**: {When this interaction is needed}
-
-**Example Questions**:
-```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
-  }]
-})
-```
-
-## ⚠️ Restrictions
-
-### Prohibitions
-
-- ❌ {Prohibited action 1 with explanation why}
-- ❌ {Prohibited action 2 with security/safety reason}
-- ❌ {Prohibited action 3 with alternative approach}
-
-### Delegation Rules
-
-- **{Agent/Tool 1}** → {When to delegate to this agent}
-- **{Agent/Tool 2}** → {When to use this instead}
-- **{Agent/Tool 3}** → {Delegation condition}
-
-### Permission restrictions
-
-- File access: {List allowed directories/patterns}
-- Command execution: {List allowed bash patterns}
-- External resources: {List allowed external resources}
-
-## ✅ Quality Gate
-
-### Completion criteria
-
-- [ ] {Completion criterion 1 with measurable target}
-- [ ] {Completion criterion 2 with validation method}
-- [ ] {Completion criterion 3 with expected state}
-- [ ] {Completion criterion 4 with deliverable}
-
-### Error handling
-
-**Common errors and solutions**:
-
-| Error Type     | Cause               | Solution                |
-| -------------- | ------------------- | ----------------------- |
-| {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}      |
-
-**Error Recovery Process**:
-1. {First recovery step}
-2. {Second recovery step}
-3. {Fallback procedure}
-
-### Performance criteria
-
-- **Running time**: {Expected duration}
-- **Memory usage**: {Expected resource usage}
-- **Output size**: {Expected output size}
-
-## 💡 User Guide
-
-### Direct call
-
-```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
-```
-
-### Autorun conditions
-
-- {Auto-trigger condition 1 with example}
-- {Auto-trigger condition 2 with keyword pattern}
-- {Auto-trigger condition 3 with context requirement}
-
-### Best practices
-
-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}
-
-## 🔗 Integration and Collaboration
-
-### Associated Agent
-
-- **{Agent 1}** ({Icon} {Role}): {How they collaborate}
-- **{Agent 2}** ({Icon} {Role}): {Handoff scenarios}
-- **{Agent 3}** ({Icon} {Role}): {Integration points}
-
-### Command integration
-
-- **{Command 1}** - {When this command invokes this agent}
-- **{Command 2}** - {Integration scenario}
-
-### MoAI-ADK workflow location
-
-```
-/alfred:1-plan → /alfred:2-run → /alfred:3-sync
-      ↑                ↑                ↑
-  {Where this agent fits in the workflow}
-```
-
-## 📊 Example scenario
-
-### Scenario 1: {Common Use Case Title}
-
-**input**:
-```
-{Example user request}
-```
-
-**Running Process**:
-1. {What agent does in step 1}
-2. {What agent does in step 2}
-3. {What agent does in step 3}
-
-**output of power**:
-```{format}
-{example-output}
-```
-
-**Verification results**:
-- ✅ {Verification 1 passed}
-- ✅ {Verification 2 passed}
-
----
-
-### Scenario 2: {Edge Case Title}
-
-**input**:
-```
-{Complex user request}
-```
-
-**treatment**:
-- {How agent handles complexity}
-- {Special considerations}
-
-**output of power**:
-- {Result description}
-
-## 📚 References
-
-- **Official Documentation**: {Link to relevant documentation}
-- **Related Skills**: {Link to complementary skills}
-- **MoAI-ADK Guide**: {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
-
----
-
-This {agent-name} provides the highest standards for {expertise-domain}.

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

@@ -1,384 +0,0 @@
----
-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}
-
-## 🎯 Command Purpose
-
-{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}
-
-## 📋 Execution flow (2-Phase structure)
-
-### ⚙️ Phase 0: Environmental Analysis (Optional)
-
-**Purpose**: {Pre-execution analysis purpose}
-
-**execution**:
-```bash
-# {Environment check description}
-{command-1}
-
-# {Prerequisites verification}
-{command-2}
-```
-
-**verification**:
-- [ ] {Prerequisite 1 checked}
-- [ ] {Prerequisite 2 verified}
-
----
-
-### 📊 Phase 1: {Planning/Analysis Phase}
-
-**Purpose**: {Detailed purpose of planning phase}
-
-**Automatic processing**:
-- {Auto-task 1 that happens without user input}
-- {Auto-task 2 that system handles}
-- {Auto-task 3 performed automatically}
-
-**Execution Steps**:
-
-#### 1.1 {First Sub-Step}
-```bash
-# {Detailed explanation}
-{command-or-action}
-```
-
-**Output**:
-- {Output 1 with format specification}
-- {Output 2 with expected structure}
-
-#### 1.2 {Second Sub-Step}
-```bash
-{commands}
-```
-
-**Output**:
-- {Intermediate output description}
-
-#### 1.3 {User Confirmation}
-
-**AskUserQuestion timing**: {When user confirmation is needed}
-
-**Confirmation**:
-```typescript
-AskUserQuestion({
-  questions: [{
-    question: "{What to ask user}?",
-    header: "{Short header}",
-    options: [
-{ label: "Proceed", description: "Execute Phase 2" },
- { label: "Modify", description: "{What modification means}" },
- { label: "Abort", description: "Cancel operation" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-**Phase 1 deliverable (final)**:
-- {Complete output 1 from planning}
-- {Complete output 2 ready for execution}
-- {User-approved plan}
-
----
-
-### 🚀 Phase 2: {Execution Phase}
-
-**Purpose**: {Detailed purpose of execution phase}
-
-**Prerequisites**:
-- [ ] Phase 1 completed and user approved
-- [ ] {Additional precondition 1}
-- [ ] {Additional precondition 2}
-
-**Execution Steps**:
-
-#### 2.1 {First Execution Step}
-```bash
-# {What this does}
-{execution-command-1}
-
-# {Next action}
-{execution-command-2}
-```
-
-**Real-time progress**:
-```
-{Progress indicator format}
-[▓▓▓▓▓▓▓░░░] {percentage}% - {current-action}
-```
-
-#### 2.2 {Second Execution Step}
-```bash
-{commands-with-explanations}
-```
-
-#### 2.3 {Quality Verification}
-```bash
-# {Validation check 1}
-{validation-command-1}
-
-# {Validation check 2}
-{validation-command-2}
-```
-
-**Verification Criteria**:
-- [ ] {Quality criterion 1 with threshold}
-- [ ] {Quality criterion 2 with expected value}
-- [ ] {Quality criterion 3 with pass/fail}
-
-**Phase 2 final output**:
-```{format}
-{example-final-output-structure}
-```
-
-## 🔗 Associated Agent
-
-### Primary Agent
-- **{agent-name}** ({Icon} {Persona})
-- **Expertise**: {Expertise}
- - **When invoked**: {When invoked}
- - **Role**: {What agent does in this command}
-
-### Secondary Agents
-- **{agent-2}** ({Icon} {Role}) - {Integration scenario}
-- **{agent-3}** ({Icon} {Role}) - {When used}
-
-## 💡 Example of use
-
-### Default Enabled
-```bash
-/{command-name} {basic-example}
-```
-
-### Advanced Use
-```bash
-# {Advanced use case 1}
-/{command-name} {param1} --{option1}={value1}
-
-# {Advanced use case 2}
-/{command-name} {param1} {param2} --{flag}
-```
-
-### Real-world scenarios
-
-#### Scenario 1: {Common Workflow}
-```bash
-# Step 1: {What user does first}
-/{command-name} "{example-input}"
-
-# Result: {What happens}
-# Next: {What to do next}
-```
-
-#### Scenario 2: {Edge Case}
-```bash
-# When {special condition}
-/{command-name} {special-params}
-
-# Handles: {How command adapts}
-```
-
-## Command argument details
-
-| Arguments/Options | Type | Required | default | Description |
-|----------|------|------|--------|------|
-| `{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} |
-
-**Argument Validation**:
-- {Validation rule 1}
-- {Validation rule 2}
-
-## ⚠️ Prohibitions
-
-**What you should never do**:
-
-- ❌ {Prohibited action 1 with explanation}
-- ❌ {Prohibited action 2 with reason}
-- ❌ {Prohibited action 3 with alternative}
-
-**Expressions to use**:
-
-- ✅ {Recommended practice 1}
-- ✅ {Recommended practice 2}
-
-## 🚨 Error handling
-
-### Common errors
-
-| error message | Cause | Solution |
-|-----------|------|----------|
-| `{Error 1}` | {Root cause} | {Step-by-step solution} |
-| `{Error 2}` | {What triggers it} | {How to fix} |
-| `{Error 3}` | {Condition} | {Resolution} |
-
-### Recovery Procedure
-
-1. **{Recovery Step 1}**: {What to do first}
-2. **{Recovery Step 2}**: {Next action}
-3. **{Fallback}**: {Last resort if all fails}
-
-## ✅ Success Criteria
-
-**Check points after executing the command**:
-
-- [ ] {Success criterion 1 with verification method}
-- [ ] {Success criterion 2 with expected outcome}
-- [ ] {Success criterion 3 with deliverable}
-
-**Quality Gate**:
-```bash
-# {Quality check 1}
-{verification-command-1}
-
-# {Quality check 2}
-{verification-command-2}
-```
-
-## 📋 Next steps
-
-**Recommended Workflow**:
-
-1. **Execute immediately**: {What to do right after command completes}
-2. **Verification**: {How to verify results}
-3. **Next command**: `/{next-command}` - {Why this is next}
-
-**Alternative Path**:
-- {Alternative path 1 if condition X}
-- {Alternative path 2 if condition Y}
-
-## 🔄 Integrated Workflow
-
-### MoAI-ADK workflow location
-
-```
-/{prev-command} → /{command-name} → /{next-command}
-                        ↓
-                {Connected agents/tasks}
-```
-
-### Relationship with other commands
-
-| command | relationship | Execution order |
-|--------|------|----------|
-| `/{related-1}` | {Relationship} | {Before/After/Parallel} |
-| `/{related-2}` | {Relationship} | {Sequence} |
-
-## 📊 Performance Metrics
-
-- **Average execution time**: {Expected duration}
-- **Memory usage**: {Expected memory}
-- **Number of files created**: {Expected file count}
-- **API calls**: {Expected external calls}
-
-## 🎓 Best Practices
-
-### 1. {Practice Category 1}
-
-**Recommended**:
-```bash
-# {Good example}
-/{command-name} {recommended-usage}
-```
-
-**Not recommended**:
-```bash
-# {Bad example - why to avoid}
-/{command-name} {anti-pattern}
-```
-
-### 2. {Practice Category 2}
-
-**Tip**: {Helpful tip or trick}
-
-### 3. {Practice Category 3}
-
-**Caution**: {Important consideration}
-
-## 🔗 Related Resources
-
-### Related commands
-- `/{command-1}` - {Description and relation}
-- `/{command-2}` - {Description and when to use}
-
-### Related Agents
-- `@agent-{agent-1}` - {How it supports this command}
-- `@agent-{agent-2}` - {Integration point}
-
-### document
-- **SPEC**: {Link to specification}
-- **Guide**: {Link to detailed guide}
-- **Examples**: {Link to examples}
-
-## 📝 Command output example
-
-**Success Case**:
-```
-✅ {Command Name} completed
-
-📊 Execution result:
-- {Result metric 1}: {value}
-- {Result metric 2}: {value}
-- {Result metric 3}: {value}
-
-📁 Files generated:
-- {File 1}: {Description}
-- {File 2}: {Description}
-
-📋 Next steps:
-- {Next step 1}
-- {Next step 2}
-```
-
-**Error Case**:
-```
-❌ {Command Name} failed
-
-🔍 Error details:
-- Type: {Error type}
-- Location: {Where error occurred}
-- Message: {Error message}
-
-💡 Solution:
-1. {Solution step 1}
-2. {Solution step 2}
-
-📞 Additional help: {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
-
----
-
-This command provides standard automation for {workflow-domain}.