moai-adk 0.34.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

moai_adk/templates/.claude/commands/moai/9-feedback.md

@@ -1,24 +1,24 @@
 ---
-name: moai:9-feedback
 description: "Submit feedback or report issues"
 argument-hint: "[issue|suggestion|question]"
-allowed-tools: Read, Write, Edit, Grep, Glob, WebFetch, WebSearch, Bash, TodoWrite, AskUserQuestion, Task, Skill
-model: haiku
+type: local
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob, TodoWrite, AskUserQuestion
+model: sonnet
 ---
 
-##  Pre-execution Context
+## Pre-execution Context
 
 !git status --porcelain
 !git branch --show-current
 !git log --oneline -1
 
-##  Essential Files
+## Essential Files
 
 @.moai/config/config.yaml
 
 ---
 
-#  MoAI-ADK Step 9: Feedback Loop
+# MoAI-ADK Step 9: Feedback Loop
 
 > Architecture: Commands → Agents → Skills. This command orchestrates ONLY through `Task()` tool.
 > Delegation Model: Feedback collection delegated to `manager-quality` agent.
@@ -27,7 +27,7 @@ Workflow Integration: This command implements the feedback loop of the MoAI work
 
 ---
 
-##  Command Purpose
+## Command Purpose
 
 Collect user feedback, bug reports, or feature suggestions and create GitHub issues automatically.
 
@@ -35,20 +35,18 @@ Run on: `$ARGUMENTS` (Feedback type)
 
 ---
 
-##  Execution Philosophy
+## Execution Philosophy
 
-`/moai:9-feedback` performs feedback collection through agent delegation:
+/moai:9-feedback performs feedback collection through agent delegation:
 
-```
-User Command: /moai:9-feedback [type]
-    ↓
-Phase 1: Task(subagent_type="manager-quality")
-    → Analyze feedback type
-    → Collect details via AskUserQuestion
-    → Create GitHub Issue via Skill
-    ↓
-Output: Issue created with link
-```
+Execution Flow:
+
+- User Command: /moai:9-feedback [type]
+- Phase 1: Task with subagent_type "manager-quality"
+  - Analyze feedback type
+  - Collect details via AskUserQuestion
+  - Create GitHub Issue via Skill
+- Output: Issue created with link
 
 ### Key Principle: Full Delegation Pattern
 
@@ -69,11 +67,11 @@ This command exclusively uses these tools:
 
 ---
 
-##  Associated Agents & Skills
+## Associated Agents and Skills
+
+Associated Agents for Feedback Collection:
 
-| Agent/Skill     | Purpose                                       |
-| --------------- | --------------------------------------------- |
-| manager-quality | Feedback collection and GitHub issue creation |
+- manager-quality: Feedback collection and GitHub issue creation
 
 ---
 
@@ -86,12 +84,14 @@ This command uses agent execution patterns defined in CLAUDE.md (lines 96-120).
 Command implements simple sequential execution through 2 phases:
 
 Phase Flow:
+
 - Phase 1: Feedback Collection (manager-quality analyzes type and collects details)
 - Phase 2: GitHub Issue Creation (manager-quality creates issue with collected information)
 
 Each phase receives outputs from previous phase as context.
 
 WHY: Sequential execution ensures complete feedback capture before submission
+
 - Phase 2 requires validated feedback details from Phase 1
 - Issue creation requires all user input to be collected
 
@@ -102,6 +102,7 @@ IMPACT: Skipping Phase 1 would create incomplete GitHub issues
 Not applicable - simple linear workflow
 
 WHY: Feedback workflow has minimal complexity
+
 - Only one agent (manager-quality) handles entire process
 - Single feedback submission at a time
 - No independent operations to parallelize
@@ -113,6 +114,7 @@ IMPACT: Parallel execution unnecessary for single-agent linear workflow
 Not applicable - command completes in single execution
 
 WHY: Feedback submission is fast atomic operation
+
 - Typical execution completes in under 30 seconds
 - GitHub API calls are atomic and fast
 - No long-running processes requiring checkpoints
@@ -125,7 +127,7 @@ Refer to CLAUDE.md "Agent Chaining Patterns" (lines 96-120) for complete pattern
 
 ---
 
-##  Execution Process
+## Execution Process
 
 ### Step 1: Delegate to Quality Gate Agent
 
@@ -204,7 +206,7 @@ Language and Accessibility:
 
 ---
 
-##  Summary: Execution Verification Checklist
+## Summary: Execution Verification Checklist
 
 Before considering command execution complete, verify all requirements:
 
@@ -226,14 +228,27 @@ Before considering command execution complete, verify all requirements:
 
 ---
 
-##  Quick Reference
+## Quick Reference
+
+Scenario: Report bug
 
-| Scenario         | Entry Point                   | Expected Outcome                            |
-| ---------------- | ----------------------------- | ------------------------------------------- |
-| Report bug       | `/moai:9-feedback issue`      | GitHub issue created with bug label         |
-| Request feature  | `/moai:9-feedback suggestion` | GitHub issue created with enhancement label |
-| Ask question     | `/moai:9-feedback question`   | GitHub issue created with question label    |
-| General feedback | `/moai:9-feedback`            | Interactive feedback collection             |
+- Entry Point: /moai:9-feedback issue
+- Expected Outcome: GitHub issue created with bug label
+
+Scenario: Request feature
+
+- Entry Point: /moai:9-feedback suggestion
+- Expected Outcome: GitHub issue created with enhancement label
+
+Scenario: Ask question
+
+- Entry Point: /moai:9-feedback question
+- Expected Outcome: GitHub issue created with question label
+
+Scenario: General feedback
+
+- Entry Point: /moai:9-feedback
+- Expected Outcome: Interactive feedback collection
 
 Associated Agent:
 
@@ -290,6 +305,7 @@ WHY: Guided choices help users continue productive workflows
 IMPACT: Abrupt completion requires user to determine next actions
 
 Next Step Options:
+
 - Continue Development: Return to current development workflow
 - Submit Additional Feedback: Report another issue or suggestion
 - View Issue: Open created GitHub issue in browser
@@ -306,7 +322,7 @@ Requirements:
 
 ---
 
-##  EXECUTION DIRECTIVE
+## EXECUTION DIRECTIVE
 
 You must NOW execute the command following the "Execution Process" described above.
 

moai_adk/templates/.claude/commands/moai/alfred.md

@@ -0,0 +1,339 @@
+---
+description: "Agentic AI automation - From SPEC to code with autonomous loop"
+argument-hint: '"task description" [--loop] [--max N] [--seq] | resume SPEC-XXX'
+type: utility
+allowed-tools: Task, AskUserQuestion, TodoWrite, Bash, Read, Write, Edit, Glob, Grep
+model: inherit
+---
+
+## Pre-execution Context
+
+!git status --porcelain
+!git branch --show-current
+
+## Essential Files
+
+@.moai/config/sections/ralph.yaml
+@.moai/config/sections/git-strategy.yaml
+@.moai/config/sections/quality.yaml
+@.moai/config/sections/llm.yaml
+
+---
+
+# /moai:alfred - Agentic AI Autonomous Automation
+
+## Core Principle: Fully Autonomous Automation
+
+User provides a goal, AI autonomously plans, executes, and completes.
+
+```
+USER: "Add authentication feature"
+  ↓
+AI: Explore → Plan → Implement → Verify → Repeat
+  ↓
+AI: All issues resolved
+  ↓
+AI: <moai>DONE</moai>
+```
+
+## Command Purpose
+
+Autonomously execute the full MoAI workflow:
+
+1. **Parallel Exploration** (Explore + Research simultaneously)
+2. **SPEC Generation** (after user approval)
+3. **TDD Implementation** (auto iterative fixing)
+4. **Documentation Sync**
+5. **Completion Marker Detection** (`<moai>DONE</moai>`)
+
+Feature Description: $ARGUMENTS
+
+## Quick Start
+
+```bash
+# Default autonomous execution (parallel exploration)
+/moai:alfred "Add JWT authentication"
+
+# Enable auto loop (max 50 iterations)
+/moai:alfred "JWT auth" --loop --max 50
+
+# Sequential exploration + auto loop
+/moai:alfred "JWT auth" --loop --sequential
+
+# Resume previous work
+/moai:alfred resume SPEC-AUTH-001
+```
+
+## Command Options
+
+| Option | Alias | Description | Default |
+|--------|-------|-------------|---------|
+| `--loop` | - | Enable auto iterative fixing | ralph.yaml |
+| `--max N` | --max-iterations | Maximum iteration count | 100 |
+| `--sequential` | --seq | Sequential exploration (for debugging) | Parallel |
+| `--branch` | - | Auto-create feature branch | git-strategy |
+| `--pr` | - | Auto-create PR | git-strategy |
+| `--resume SPEC` | - | Resume previous work | - |
+
+## Completion Promise
+
+AI must add a marker when work is complete:
+
+```markdown
+## Complete
+
+All implementation complete, tests passing, docs updated. <moai>DONE</moai>
+```
+
+**Marker Types**:
+- `<moai>DONE</moai>` - Task complete
+- `<moai>COMPLETE</moai>` - Full completion
+- `<moai:done />` - XML format
+
+## Agentic Autonomous Flow
+
+```
+START: /moai:alfred "task description"
+
+PHASE 0: Parallel Exploration (autonomous)
+  ┌── Explore Agent: Codebase analysis
+  ├── Research Agent: Documentation/issue search
+  └── Quality Agent: Current state diagnosis
+  ↓
+Integration → Execution plan generation
+
+PHASE 1: SPEC Generation
+  └── Written in EARS format
+  ↓
+User Approval
+  ↓
+PHASE 2: TDD Implementation (autonomous loop)
+  │
+  └── WHILE (issues_exist AND iteration < max):
+       ├── Diagnostics (LSP + Tests + Coverage)
+       ├── TODO generation
+       ├── Fix execution
+       ├── Verification
+       └── Completion marker detected? → BREAK
+  ↓
+PHASE 3: Documentation Sync
+  └── Add marker: <moai>DONE</moai>
+  ↓
+COMPLETE
+```
+
+### Phase 0: Parallel Exploration Implementation
+
+By default, execute three exploration agents simultaneously for optimal performance:
+
+Step 1 - Launch Parallel Agent Tasks:
+
+In a single response, invoke all three Task tools simultaneously (Claude Code executes them in parallel automatically):
+
+1. Explore Agent:
+   - subagent_type: Explore
+   - description: Codebase analysis for task context
+   - prompt: Include user task description, request relevant files, architecture patterns, existing implementations
+
+2. Research Agent:
+   - subagent_type: Explore (with WebSearch/WebFetch focus)
+   - description: External documentation and best practices research
+   - prompt: Include user task description, request API docs, library documentation, similar implementations
+
+3. Quality Agent:
+   - subagent_type: manager-quality
+   - description: Current project quality assessment
+   - prompt: Request test coverage status, lint status, technical debt assessment
+
+All three Task calls in the same response triggers automatic parallel execution (up to 10 concurrent).
+
+Step 2 - Collect and Integrate Results:
+
+After all three agents complete:
+
+1. Collect outputs from each agent response
+2. Extract key findings:
+   - From Explore: Relevant files, architecture patterns, existing code to reference
+   - From Research: External knowledge, best practices, API patterns
+   - From Quality: Current test coverage, code quality baseline, known issues
+
+3. Synthesize into unified exploration report
+
+Step 3 - Generate Execution Plan:
+
+Based on integrated findings:
+
+1. Identify implementation approach
+2. List files to create/modify
+3. Define test strategy
+4. Estimate scope and complexity
+
+Step 4 - User Approval Checkpoint:
+
+Present integrated findings and proposed plan to user via AskUserQuestion:
+- Options: Proceed to SPEC creation, Modify approach, Cancel
+
+Error Handling:
+
+If any agent fails:
+- Continue with results from successful agents
+- Note missing information in plan
+- Offer to retry failed agent or proceed with partial information
+
+WHY: Parallel exploration reduces Phase 0 time from 45-90 seconds to 15-30 seconds (2-3x speedup)
+IMPACT: Faster initial context gathering without sacrificing comprehensiveness
+
+## TODO-Obsessive Rule
+
+[HARD] TodoWrite Tool Mandatory Usage:
+
+1. Immediate Creation: When issues are discovered, call TodoWrite tool to add items with pending status
+2. Immediate Progress: Before starting work, call TodoWrite tool to change item to in_progress
+3. Immediate Completion: After completing work, call TodoWrite tool to change item to completed
+4. Prohibited: Output TODO lists as text (MUST use TodoWrite tool)
+5. Completion Condition: All TODOs completed OR completion marker detected
+
+WHY: Using TodoWrite tool allows users to track progress in real-time.
+
+## Output Format
+
+### Running
+
+```markdown
+## Alfred: Phase 2 (Loop 3/100)
+
+### TODO Status
+- [x] Implement JWT token generation
+- [x] Implement login endpoint
+- [ ] Token validation middleware ← in progress
+
+### Issues
+- ERROR: src/auth.py:45 - undefined 'jwt_decode'
+- WARNING: tests/test_auth.py:12 - unused 'result'
+
+Fixing...
+```
+
+### Complete
+
+```markdown
+## Alfred: COMPLETE
+
+### Summary
+- SPEC: SPEC-AUTH-001
+- Files: 8 files modified
+- Tests: 25/25 passing
+- Coverage: 88%
+- Loops: 7 iterations
+
+### Changes
++ JWT token generation
++ Login endpoint
++ Token validation middleware
++ Unit tests (12 cases)
++ API documentation
+
+<moai>DONE</moai>
+```
+
+## LLM Mode
+
+Auto-routing based on `llm.yaml` settings:
+
+| Mode | Plan Phase | Run Phase |
+|------|------------|-----------|
+| opus-only | Claude (current) | Claude (current) |
+| hybrid | Claude (current) | GLM (worktree) |
+| glm-only | GLM (worktree) | GLM (worktree) |
+
+## Expert Delegation (Single Domain)
+
+Single domain tasks are delegated directly to expert agents:
+
+```bash
+# Alfred auto-determines
+/moai:alfred "SQL query optimization"
+
+# → Delegates directly to expert-performance agent
+# → Immediate implementation without SPEC
+```
+
+## Quick Reference
+
+```bash
+# Autonomous execution (default parallel)
+/moai:alfred "task"
+
+# Auto loop + sequential
+/moai:alfred "task" --loop --sequential
+
+# Specify max iterations
+/moai:alfred "task" --loop --max 50
+
+# Branch + PR
+/moai:alfred "task" --branch --pr
+
+# Resume
+/moai:alfred resume SPEC-XXX
+```
+
+---
+
+## EXECUTION DIRECTIVE
+
+1. Parse $ARGUMENTS (extract --loop, --max, --sequential, --branch, --pr, --resume flags)
+
+2. IF --resume flag with SPEC ID: Load existing SPEC and continue from last state
+
+3. Detect LLM mode from llm.yaml (opus-only, hybrid, glm-only)
+
+4. Execute Phase 0 - Parallel Exploration:
+
+   IF --sequential flag is specified:
+
+   4a. Run Explore, then Research, then Quality sequentially
+
+   ELSE (default parallel mode):
+
+   4b. In a single response, invoke three Task tools simultaneously:
+       - Task 1 (Explore): Codebase analysis with subagent_type="Explore"
+       - Task 2 (Research): Documentation research with subagent_type="Explore" and WebSearch focus
+       - Task 3 (Quality): Quality assessment with subagent_type="manager-quality"
+
+   4c. Collect and integrate results from all three agents
+
+   4d. Generate unified exploration report and execution plan
+
+5. Routing decision:
+   - IF single-domain task (e.g., "SQL optimization"): Delegate directly to expert agent, skip SPEC
+   - IF multi-domain task: Proceed to full workflow with SPEC generation
+
+6. [HARD] Call TodoWrite tool to add discovered tasks with pending status
+
+7. User confirmation via AskUserQuestion (Proceed, Modify, Cancel)
+
+8. Execute Phase 1 - SPEC Generation:
+   - Use manager-spec subagent to create EARS-format SPEC document
+
+9. Execute Phase 2 - TDD Implementation Loop:
+
+   IF --loop flag OR ralph.yaml loop.enabled is true:
+
+   9a. WHILE (issues exist AND iteration less than max):
+       - [HARD] Before each task, call TodoWrite to change item to in_progress
+       - Execute diagnostics (parallel if enabled)
+       - Fix discovered issues
+       - [HARD] After each fix, call TodoWrite to change item to completed
+       - Check for completion marker
+       - IF marker found: Break loop
+
+10. Execute Phase 3 - Documentation Sync:
+    - Use manager-docs subagent to synchronize documentation
+
+11. Terminate with completion marker: Add marker when all tasks complete successfully
+
+---
+
+Version: 3.1.0
+Last Updated: 2026-01-11
+Core: Agentic AI Autonomous Automation

moai_adk/templates/.claude/commands/moai/cancel-loop.md

@@ -0,0 +1,163 @@
+---
+description: "Cancel autonomous loop with snapshot preservation"
+argument-hint: "[--force] [--snapshot] | [--list]"
+type: utility
+allowed-tools: Task, AskUserQuestion, TodoWrite, Bash, Read, Write, Edit, Glob, Grep
+model: inherit
+---
+
+## Pre-execution Context
+
+!git status --porcelain
+!cat .moai/cache/.moai_loop_state.json 2>/dev/null || echo "No active loop"
+
+## Essential Files
+
+@.moai/config/sections/ralph.yaml
+
+---
+
+# /moai:cancel-loop - Cancel Autonomous Loop
+
+## Core Principle: 상태 보존
+
+루프 취소 시 모든 진행 상태를 스냅샷으로 저장합니다.
+
+```
+CANCEL → SNAPSHOT → RECOVER 가능
+```
+
+## Command Purpose
+
+활성 루프를 취소하고 복구 가능한 스냅샷을 생성:
+
+1. 루프 중지
+2. 스냅샷 저장
+3. 상태 보고
+4. 복구 옵션 제공
+
+Arguments: $ARGUMENTS
+
+## Quick Start
+
+```bash
+# 기본 취소 (확인 후)
+/moai:cancel-loop
+
+# 강제 취소
+/moai:cancel-loop --force
+
+# 스냅샷 저장
+/moai:cancel-loop --snapshot
+
+# 스냅샷 목록
+/moai:cancel-loop --list
+```
+
+## Command Options
+
+| 옵션 | 설명 |
+|------|------|
+| `--force` | 확인 없이 취소 |
+| `--snapshot` | 스냅샷 저장 |
+| `--keep` | state 파일 보존 |
+| `--reason TEXT` | 취소 사유 |
+| `--list` | 스냅샷 목록 |
+
+## Output Format
+
+### 기본 취소
+
+```markdown
+## Loop: Cancelled
+
+### Status
+- Iterations: 7/100
+- Errors: 2 remaining
+- Warnings: 3 remaining
+
+### TODO
+1. [ ] src/auth.py:67 - missing return
+2. [ ] tests/test_auth.py:12 - unused var
+
+### Snapshot
+.moai/cache/ralph-snapshots/cancel-20240111-105230.json
+
+### Recovery
+/moai:loop --resume latest
+```
+
+### 스냅샷 목록
+
+```markdown
+## Snapshots: 2 available
+
+1. cancel-20240111-105230 (7 iters, 2 errors)
+2. cancel-20240110-154523 (12 iters, 0 errors)
+
+### Recovery
+/moai:loop --resume cancel-20240111-105230
+```
+
+### 활성 루프 없음
+
+```markdown
+## No Active Loop
+
+### Snapshots Available
+2 snapshots found. Use --list to view.
+
+### Start New
+/moai:loop
+```
+
+## Snapshot Location
+
+```bash
+.moai/cache/ralph-snapshots/
+├── cancel-20240111-103042.json
+├── cancel-20240111-105230.json
+└── latest.json -> cancel-20240111-105230.json
+```
+
+## Recovery
+
+```bash
+# 최신 스냅샷
+/moai:loop --resume latest
+
+# 특정 스냅샷
+/moai:loop --resume cancel-20240111-105230
+```
+
+## Quick Reference
+
+```bash
+# 취소
+/moai:cancel-loop
+
+# 강제 취소
+/moai:cancel-loop --force
+
+# 스냅샷 저장
+/moai:cancel-loop --snapshot
+
+# 목록
+/moai:cancel-loop --list
+```
+
+---
+
+## EXECUTION DIRECTIVE
+
+1. 활성 루프 확인
+2. 확인 요청 (--force 제외)
+3. 스냅샷 저장 (--snapshot)
+4. 상태 보고
+5. 복구 옵션
+
+---
+
+Version: 2.1.0
+Last Updated: 2026-01-11
+Core: Agentic AI State Management