moai-adk 0.15.0__py3-none-any.whl → 0.15.1__py3-none-any.whl

moai_adk/templates/.claude/commands/alfred/1-plan.md

@@ -444,15 +444,72 @@ Present your plan in the following format:
 - **Branches/PR**: [Git operations by mode]
 
 ---
-**Approval Request**: Would you like to proceed with creating a plan with the above plan?
- (Choose between “Proceed,” “Modify [Content],” or “Abort”)
+
+## Plan Approval Decision Point
+
+After the planning phase is complete, Alfred uses `AskUserQuestion` tool (documented in moai-alfred-interactive-questions skill) to obtain explicit user approval before proceeding to SPEC creation.
+
+**Example AskUserQuestion Call**:
+```python
+AskUserQuestion(
+    questions=[
+        {
+            "question": "Plan development is complete. Would you like to proceed with SPEC creation based on this plan?",
+            "header": "Plan Approval",
+            "multiSelect": false,
+            "options": [
+                {
+                    "label": "✅ Proceed with SPEC Creation",
+                    "description": "Create SPEC files in .moai/specs/SPEC-{ID}/ based on approved plan"
+                },
+                {
+                    "label": "🔄 Request Modifications",
+                    "description": "Specify changes to the plan before SPEC creation"
+                },
+                {
+                    "label": "⏸️ Save as Draft",
+                    "description": "Save plan as draft without creating SPEC files yet"
+                },
+                {
+                    "label": "❌ Cancel",
+                    "description": "Discard plan and return to planning phase"
+                }
+            ]
+        }
+    ]
+)
+```
+
+**Response Processing**:
+- **"✅ Proceed with SPEC Creation"** (`answers["0"] === "✅ Proceed with SPEC Creation"`) → Execute Phase 2
+  - Invoke spec-builder agent with approved plan
+  - Create spec.md, plan.md, acceptance.md files in `.moai/specs/SPEC-{ID}/`
+  - Initialize @SPEC TAG system
+  - Create feature branch via git-manager
+  - Create Draft PR for review
+
+- **"🔄 Request Modifications"** (`answers["0"] === "🔄 Request Modifications"`) → Repeat planning phase
+  - Collect modification requests from user
+  - Update plan based on feedback
+  - Re-present plan for approval (recursive decision)
+
+- **"⏸️ Save as Draft"** (`answers["0"] === "⏸️ Save as Draft"`) → Save without SPEC
+  - Save plan to `.moai/specs/SPEC-{ID}/plan.md` with status: draft
+  - Commit with message "draft(spec): WIP SPEC-{ID} - {title}"
+  - User can resume with `/alfred:1-plan resume SPEC-{ID}`
+
+- **"❌ Cancel"** (`answers["0"] === "❌ Cancel"`) → End task
+  - Discard plan artifacts
+  - Return user to initial planning prompt
+  - No files created or modified
+
 ```
 
 ---
 
 ## 🚀 STEP 2 Implementation Guide: Create a Plan (After Approval)
 
-Only if the user selects **"Proceed"** or **"Start"** will Alfred call the spec-builder agent to begin building the SPEC document.
+Only if the user selects **"✅ Proceed with SPEC Creation"** will Alfred call the spec-builder agent to begin building the SPEC document.
 
 ### EARS specification writing guide
 
@@ -759,27 +816,32 @@ See `.coderabbit.yaml` for detailed SPEC review checklist.
 
 ## Final Step
 
-After plan creation completes, Alfred automatically invokes AskUserQuestion to ask the user what to do next:
+After SPEC creation completes, Alfred automatically invokes AskUserQuestion to ask the user what to do next:
 
+**Example AskUserQuestion Call**:
 ```python
 AskUserQuestion(
     questions=[
         {
-            "question": "스펙 작성이 완료되었습니다. 다음으로 뭘 하시겠습니까?",
-            "header": "다음 단계",
+            "question": "SPEC creation is complete. What would you like to do next?",
+            "header": "Next Steps",
             "multiSelect": false,
             "options": [
                 {
-                    "label": "🔨 구현 시작",
-                    "description": "/alfred:2-run SPEC-XXX로 TDD 구현 진행"
+                    "label": "🔨 Start Implementation",
+                    "description": "Proceed to /alfred:2-run SPEC-XXX for TDD implementation"
+                },
+                {
+                    "label": "📝 Review SPEC",
+                    "description": "Review and modify SPEC documents before implementation"
                 },
                 {
-                    "label": "📝 스펙 수정",
-                    "description": "SPEC 문서 검토 후 수정"
+                    "label": "🔄 New Session",
+                    "description": "Execute /clear for better context management (recommended)"
                 },
                 {
-                    "label": "🔄 새 세션 시작",
-                    "description": "성능 최적화를 위해 /clear 실행"
+                    "label": "❌ Cancel",
+                    "description": "Return to planning phase"
                 }
             ]
         }
@@ -787,10 +849,26 @@ AskUserQuestion(
 )
 ```
 
-**User Responses**:
-- **🔨 구현 시작**: Proceed to `/alfred:2-run SPEC-XXX` for TDD implementation
-- **📝 스펙 수정**: Review and modify SPEC documents before implementation
-- **🔄 새 세션 시작**: Execute `/clear` to start fresh session (recommended for performance)
+**Response Processing**:
+- **"🔨 Start Implementation"** (`answers["0"] === "🔨 Start Implementation"`) → Proceed to `/alfred:2-run`
+  - Display: "Starting TDD implementation workflow..."
+  - User can execute: `/alfred:2-run SPEC-XXX`
+  - Continue to next phase without session break
+
+- **"📝 Review SPEC"** (`answers["0"] === "📝 Review SPEC"`) → Review generated SPEC
+  - Display: "📁 SPEC files created in `.moai/specs/SPEC-XXX/`"
+  - Show files: spec.md, plan.md, acceptance.md
+  - User can modify and then run `/alfred:2-run SPEC-XXX`
+
+- **"🔄 New Session"** (`answers["0"] === "🔄 New Session"`) → Clear and restart
+  - Display: "⏳ Clearing session for better context management..."
+  - Note: Improves performance for large projects
+  - Next session: User can run `/alfred:2-run SPEC-XXX`
+
+- **"❌ Cancel"** (`answers["0"] === "❌ Cancel"`) → Return to planning
+  - Display: "Returning to planning phase..."
+  - SPEC files preserved for future use
+  - User can create more SPECs with `/alfred:1-plan`
 
 ---
 

moai_adk/templates/.claude/commands/alfred/2-run.md

@@ -231,9 +231,72 @@ After reviewing the action plan, select one of the following:
 
 ---
 
+## Implementation Strategy Approval
+
+After the execution plan is ready, Alfred uses `AskUserQuestion` tool (documented in moai-alfred-interactive-questions skill) to obtain explicit user approval before proceeding to TDD implementation.
+
+**Example AskUserQuestion Call**:
+```python
+AskUserQuestion(
+    questions=[
+        {
+            "question": "Implementation plan is ready. How would you like to proceed?",
+            "header": "Implementation Approval",
+            "multiSelect": false,
+            "options": [
+                {
+                    "label": "✅ Proceed with TDD",
+                    "description": "Start RED → GREEN → REFACTOR cycle"
+                },
+                {
+                    "label": "🔍 Research First",
+                    "description": "Invoke Explore agent to study existing code patterns"
+                },
+                {
+                    "label": "🔄 Modify Strategy",
+                    "description": "Request changes to implementation approach"
+                },
+                {
+                    "label": "⏸️ Postpone",
+                    "description": "Save plan and return later"
+                }
+            ]
+        }
+    ]
+)
+```
+
+**Response Processing**:
+- **"✅ Proceed with TDD"** (`answers["0"] === "✅ Proceed with TDD"`) → Execute Phase 2
+  - Proceed directly to STEP 2 (TDD implementation)
+  - Invoke tdd-implementer agent with approved plan
+  - Begin RED phase (write failing tests)
+  - Display: "🔴 Starting RED phase..."
+
+- **"🔍 Research First"** (`answers["0"] === "🔍 Research First"`) → Run exploration first
+  - Invoke Explore agent to analyze existing codebase
+  - Pass exploration results to implementation-planner
+  - Re-generate plan with research insights
+  - Re-present plan for approval
+  - Display: "🔍 Codebase exploration complete. Plan updated."
+
+- **"🔄 Modify Strategy"** (`answers["0"] === "🔄 Modify Strategy"`) → Revise plan
+  - Collect strategy modification requests from user
+  - Update implementation plan with changes
+  - Re-present for approval (recursive)
+  - Display: "🔄 Plan modified. Please review updated strategy."
+
+- **"⏸️ Postpone"** (`answers["0"] === "⏸️ Postpone"`) → Save and resume later
+  - Save plan to `.moai/specs/SPEC-{ID}/plan.md`
+  - Commit with message "plan(spec): Save implementation plan for SPEC-{ID}"
+  - User can resume with `/alfred:2-run SPEC-{ID}`
+  - Display: "⏸️ Plan saved. Resume with `/alfred:2-run SPEC-{ID}`"
+
+---
+
 ## 🚀 STEP 2: Execute task (after user approval)
 
-After user approval (gathered through `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`), **call the tdd-implementer agent using the Task tool**.
+After user approval (collected via the AskUserQuestion decision point above), **call the tdd-implementer agent using the Task tool**.
 
 ---
 
@@ -667,25 +730,30 @@ Only if the user selects **"Proceed"** or **"Start"** will Alfred call the tdd-i
 
 Alfred calls AskUserQuestion to collect user's next action:
 
+**Example AskUserQuestion Call**:
 ```python
 AskUserQuestion(
     questions=[
         {
-            "question": "구현이 완료되었습니다. 다음으로 뭘 하시겠습니까?",
-            "header": "다음 단계",
+            "question": "Implementation is complete. What would you like to do next?",
+            "header": "Next Steps",
             "multiSelect": false,
             "options": [
                 {
-                    "label": "📚 문서 동기화 진행",
-                    "description": "/alfred:3-sync 실행하여 문서 동기화"
+                    "label": "📚 Synchronize Documentation",
+                    "description": "Proceed to /alfred:3-sync for documentation synchronization"
+                },
+                {
+                    "label": "🔨 Implement More Features",
+                    "description": "Continue with /alfred:2-run SPEC-XXX for next feature"
                 },
                 {
-                    "label": "🔍 추가 구현",
-                    "description": "다른 SPEC 구현 진행"
+                    "label": "🔄 New Session",
+                    "description": "Execute /clear for better context management (recommended)"
                 },
                 {
-                    "label": "🔄 새 세션 시작",
-                    "description": "성능 최적화를 위해 /clear 실행"
+                    "label": "✅ Complete",
+                    "description": "Finish current session"
                 }
             ]
         }
@@ -693,10 +761,26 @@ AskUserQuestion(
 )
 ```
 
-**User Responses**:
-- **📚 문서 동기화**: Proceed to `/alfred:3-sync` for documentation synchronization
-- **🔍 추가 구현**: Repeat `/alfred:2-run SPEC-XXX` for next feature
-- **🔄 새 세션**: Execute `/clear` to start fresh session (recommended for performance)
+**Response Processing**:
+- **"📚 Synchronize Documentation"** (`answers["0"] === "📚 Synchronize Documentation"`) → Proceed to `/alfred:3-sync`
+  - Display: "Starting documentation synchronization..."
+  - User can execute: `/alfred:3-sync auto`
+  - This verifies TAGs, updates docs, and prepares for PR merge
+
+- **"🔨 Implement More Features"** (`answers["0"] === "🔨 Implement More Features"`) → Continue implementation
+  - Display: "Ready for next feature implementation..."
+  - User can run: `/alfred:2-run SPEC-YYY` for another feature
+  - Maintains current session context
+
+- **"🔄 New Session"** (`answers["0"] === "🔄 New Session"`) → Clear and restart
+  - Display: "⏳ Clearing session for better context management..."
+  - Recommended after large implementations
+  - Next session: Can run any command
+
+- **"✅ Complete"** (`answers["0"] === "✅ Complete"`) → End current workflow
+  - Display: "Implementation workflow complete!"
+  - Recommend next manual steps via `/alfred:3-sync`
+  - User can review work or plan next features
 
 ---
 

moai_adk/templates/.claude/commands/alfred/3-sync.md

@@ -303,12 +303,45 @@ To skip pre-verification, use the `/alfred:3-sync --skip-pre-check` option.
 
 ---
 
-### User verification steps
+### 🎯 Synchronization Plan Approval (DECISION POINT 1)
 
-After reviewing your sync plan, `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` presents the following options for user decision:
-- **"Proceed"** or **"Start"**: Start synchronization as planned
-- **"Modify [Contents]"**: Request modifications to your sync plan
-- **"Abort"**: Abort the sync operation
+After completing synchronization analysis and establishing a plan, Alfred invokes AskUserQuestion to gather user approval:
+
+```python
+AskUserQuestion(
+    questions=[
+        {
+            "question": "Synchronization plan is ready. How would you like to proceed?",
+            "header": "Plan Approval",
+            "multiSelect": false,
+            "options": [
+                {
+                    "label": "✅ Proceed with Sync",
+                    "description": "Execute document synchronization as planned"
+                },
+                {
+                    "label": "🔄 Request Modifications",
+                    "description": "Specify changes to the synchronization strategy"
+                },
+                {
+                    "label": "🔍 Review Details",
+                    "description": "Re-examine TAG validation results and changes"
+                },
+                {
+                    "label": "❌ Abort",
+                    "description": "Cancel synchronization, keep current state"
+                }
+            ]
+        }
+    ]
+)
+```
+
+**Response Processing**:
+- **✅ Proceed with Sync** (`answers["0"] === "Proceed"`) → Execute Phase 2 (document synchronization)
+- **🔄 Request Modifications** (`answers["0"] === "Modifications"`) → Collect feedback and re-analyze
+- **🔍 Review Details** (`answers["0"] === "Review"`) → Display TAG validation results, then re-present decision
+- **❌ Abort** (`answers["0"] === "Abort"`) → Stop synchronization, maintain current branches
 
 ---
 
@@ -879,29 +912,71 @@ Report synchronization results in a structured format:
 3. Orphan TAG cleanup
 ```
 
+## 🎯 PR Merge Strategy Selection (DECISION POINT 2)
+
+After document synchronization completes successfully, Alfred checks team mode and invokes AskUserQuestion for PR merge strategy:
+
+```python
+AskUserQuestion(
+    questions=[
+        {
+            "question": "Document synchronization complete. How would you like to handle the PR?",
+            "header": "PR Merge Strategy",
+            "multiSelect": false,
+            "options": [
+                {
+                    "label": "🤖 Auto-Merge (Recommended)",
+                    "description": "Automatically merge PR and clean up branch (team mode)"
+                },
+                {
+                    "label": "📋 Manual Review",
+                    "description": "Keep PR in Ready state for manual review and merge"
+                },
+                {
+                    "label": "✏️ Keep as Draft",
+                    "description": "Maintain PR in draft state for further refinement"
+                },
+                {
+                    "label": "🔄 New Cycle",
+                    "description": "Save changes and start new feature (skip PR for now)"
+                }
+            ]
+        }
+    ]
+)
+```
+
+**Response Processing**:
+- **🤖 Auto-Merge** (`answers["0"] === "Auto-Merge"`) → Execute PR auto-merge with CI checks, update develop branch
+- **📋 Manual Review** (`answers["0"] === "Manual"`) → Transition PR to Ready state, notify reviewers
+- **✏️ Keep as Draft** (`answers["0"] === "Draft"`) → Leave PR in draft, ready for refinement
+- **🔄 New Cycle** (`answers["0"] === "New"`) → Skip PR handling, proceed to next feature planning
+
+---
+
 ## Final Step
 
-After document synchronization completes, Alfred automatically invokes AskUserQuestion to ask the user what to do next:
+After PR strategy is confirmed, Alfred invokes AskUserQuestion to ask the user what to do next:
 
 ```python
 AskUserQuestion(
     questions=[
         {
-            "question": "문서 동기화가 완료되었습니다. 다음으로 뭘 하시겠습니까?",
-            "header": "다음 단계",
+            "question": "Documentation synchronization complete. What would you like to do next?",
+            "header": "Next Steps",
             "multiSelect": false,
             "options": [
                 {
-                    "label": "📋 다음 스펙 작성",
-                    "description": "/alfred:1-plan으로 새로운 기능 SPEC 작성"
+                    "label": "📋 Create Next SPEC",
+                    "description": "Start new feature planning with /alfred:1-plan"
                 },
                 {
-                    "label": "📤 PR 병합",
-                    "description": "GitHub에서 PR 검토 및 병합 진행"
+                    "label": "📤 Merge PR",
+                    "description": "Review and merge PR to develop branch"
                 },
                 {
-                    "label": "🔄 새 세션 시작",
-                    "description": "성능 최적화를 위해 /clear 실행"
+                    "label": "🔄 Start New Session",
+                    "description": "Execute /clear for fresh session (recommended for performance)"
                 }
             ]
         }
@@ -910,9 +985,9 @@ AskUserQuestion(
 ```
 
 **User Responses**:
-- **📋 다음 스펙 작성**: Proceed to `/alfred:1-plan` for creating next SPEC
-- **📤 PR 병합**: Manual PR review and merge on GitHub
-- **🔄 새 세션 시작**: Execute `/clear` to start fresh session (recommended for performance)
+- **📋 Create Next SPEC**: Proceed to `/alfred:1-plan` for creating next SPEC
+- **📤 Merge PR**: Manual PR review and merge on GitHub
+- **🔄 Start New Session**: Execute `/clear` to start fresh session (recommended for performance)
 
 ---
 

{moai_adk-0.15.0.dist-info → moai_adk-0.15.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.15.0
+Version: 0.15.1
 Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0
 Project-URL: Homepage, https://github.com/modu-ai/moai-adk
 Project-URL: Repository, https://github.com/modu-ai/moai-adk
@@ -1714,122 +1714,137 @@ When working in your **local development environment**, CodeRabbit provides auto
 
 ---
 
-## Quick Issue Creation with `/alfred:9-feedback`
+## 🚀 Quick Issue Creation with `/alfred:9-feedback`
 
-MoAI-ADK v0.7.0+ includes the **Quick Issue Creation** feature, allowing developers to instantly create GitHub Issues without interrupting their development workflow.
+Encountered a bug or want to suggest a feature while using MoAI-ADK? Create GitHub Issues instantly with a single command directly from Claude Code without interrupting your workflow.
 
-### Why Quick Issue Creation?
+### Overview
 
-During development, you frequently encounter:
-- 🐛 Bugs that need immediate reporting
-- ✨ Feature ideas that come to mind
-- ⚡ Performance improvements to suggest
-- ❓ Architecture questions that need team discussion
+```bash
+/alfred:9-feedback
+```
+
+When you run this command, Alfred guides you through an interactive dialog to automatically create an issue:
+- 🐛 **Bug Report** - Document problems you encounter
+- ✨ **Feature Request** - Suggest new capabilities
+- ⚡ **Improvement** - Propose enhancements to existing features
+- ❓ **Question/Discussion** - Ask questions for team discussion
+
+### Quick Example
 
-**The old way**: Stop coding, go to GitHub, manually fill issue form, remember what you were working on.
-**The new way**: Type one command, GitHub Issue is created instantly, continue coding.
+```bash
+# Run in Claude Code
+/alfred:9-feedback
+```
 
-### Interactive Dialog Flow
+### Interactive Step-by-Step Flow
 
-When you run `/alfred:9-help`, Alfred guides you through an interactive multi-step dialog:
+**1️⃣ Select Issue Type**
 
-**Step 1: Select Issue Type**
 ```
-Alfred: What type of issue do you want to create?
+What type of issue do you want to create?
+
 [ ] 🐛 Bug Report - Something isn't working
 [ ] ✨ Feature Request - Suggest new functionality
 [ ] ⚡ Improvement - Enhance existing features
 [ ] ❓ Question/Discussion - Ask the team
 ```
 
-**Step 2: Enter Issue Title**
+**2️⃣ Enter Issue Title**
+
 ```
-Alfred: What's the issue title?
-Your input: "Login button not responding to clicks"
+What's the issue title? (be concise)
+Example: moai-adk update fails with template sync error
 ```
 
-**Step 3: Enter Description (Optional)**
+**3️⃣ Enter Detailed Description (Optional)**
+
 ```
-Alfred: Provide a detailed description (optional—press Enter to skip)
-Your input: "When I click the login button on iPhone 15, it freezes for 5 seconds then crashes"
+Provide a detailed description (optional—press Enter to skip):
+
+Example:
+When running moai-adk update:
+- Symptom: .claude/ directory permission error
+- Environment: macOS 14.2, Python 3.13, moai-adk v0.15.0
+- Expected: Templates should synchronize successfully
+- Actual: Permission denied error and termination
 ```
 
-**Step 4: Select Priority Level**
+**4️⃣ Select Priority Level**
+
 ```
-Alfred: What's the priority level?
+What's the priority level?
+
 [ ] 🔴 Critical - System down, data loss, security breach
 [ ] 🟠 High - Major feature broken, significant impact
 [✓] 🟡 Medium - Normal priority (default)
 [ ] 🟢 Low - Minor issues, nice-to-have
 ```
 
-**Step 5: Automatic Issue Creation**
-```
-Alfred automatically:
-1. Determines appropriate labels based on issue type and priority
-2. Formats title with emoji: "🐛 [BUG] Login button not responding..."
-3. Creates GitHub Issue with all information
-4. Returns the issue number and URL
-```
+### Automatic Issue Creation
 
-### Key Features
-
-1. **⚡ Instant Creation**: Create GitHub Issues in seconds
-2. **🏷️ Automatic Labels**: Issue type + priority automatically labeled
-3. **🎯 Priority Selection**: Choose from Critical/High/Medium/Low
-4. **🔗 Team Visibility**: Issues immediately visible and discussable
-5. **📋 Standardized Format**: All issues follow consistent structure
+Alfred automatically:
+1. Adds emoji to title: `🐛 [BUG] moai-adk update fails with template sync error`
+2. Formats the issue in GitHub format
+3. Auto-applies appropriate labels: `bug`, `reported`, `priority-high`
+4. Creates the issue in your repository
 
-### Complete Example: Bug Report During Code Review
+### Completion Output
 
-```bash
-# During code review, you notice a critical issue and want to report it instantly
-$ /alfred:9-feedback
+```
+✅ GitHub Issue #245 created successfully!
 
-Alfred: What type of issue do you want to create?
-> 🐛 Bug Report
+📋 Title: 🐛 [BUG] moai-adk update fails with template sync error
+🔴 Priority: High
+🏷️  Labels: bug, reported, priority-high
+🔗 URL: https://github.com/modu-ai/moai-adk/issues/245
 
-Alfred: What's the issue title?
-> Login button crash on mobile devices
+💡 Tip: Reference this issue number in your commit messages
+```
 
-Alfred: Provide a detailed description (optional—press Enter to skip)
-> Tapping the login button on iPhone 15 causes app to freeze for 5 seconds then crash.
-> Tested on iOS 17.2, Chrome 120 on macOS 14.2.
-> Expected: Login modal should appear
-> Actual: No response then crash
+### Key Features
 
-Alfred: What's the priority level?
-> 🟠 High
+| Feature | Description |
+|---------|-------------|
+| **Simple Command** | Just `/alfred:9-feedback`—no arguments needed |
+| **Interactive** | Step-by-step dialog for intuitive issue creation |
+| **Auto-labeled** | Issue type and priority automatically assigned as labels |
+| **Instant Creation** | Issue created in GitHub within ~30 seconds |
+| **Team Shared** | Issue immediately visible and trackable for your team |
 
-✅ GitHub Issue #234 created successfully!
+### Use Cases
 
-📋 Title: 🐛 [BUG] Login button crash on mobile devices
-🟠 Priority: High
-🏷️  Labels: bug, reported, priority-high
-🔗 URL: https://github.com/owner/repo/issues/234
+**📌 Bug Report Example**
 
-💡 Next: Continue with your work—the issue is now tracked!
+```
+/alfred:9-feedback
+→ Select 🐛 Bug Report
+→ Title: "moai-adk update fails with template sync error"
+→ Describe the symptom and environment
+→ Select 🟠 High priority
+→ Issue #246 automatically created
 ```
 
-### Integration with MoAI-ADK Workflow
-
-1. **During Development**: Use `/alfred:9-help` to report bugs/ideas instantly
-2. **In Code Review**: Convert improvement suggestions to tracked issues
-3. **When Planning**: Reference created issues in SPEC documents
-4. **During Sync**: Link issues to SPEC requirements with `/alfred:3-sync`
+**💡 Feature Request Example**
 
-### Prerequisites
+```
+/alfred:9-feedback
+→ Select ✨ Feature Request
+→ Title: "Add --dry-run option to moai-adk update"
+→ Describe the desired behavior
+→ Select 🟡 Medium priority
+→ Issue #247 automatically created
+```
 
-- GitHub CLI (`gh`) installed and authenticated
-- Repository initialized with Git
+### Best Practices
 
-### Learn More
+- ✅ Be clear and concise in your title
+- ✅ Include environment details for bug reports (OS, Python version, moai-adk version)
+- ✅ Description is optional—skip if title is self-explanatory
+- ❌ Avoid including personal information or sensitive data
+- ❌ Check existing issues to prevent duplicates before creating new ones
 
-See `.moai/docs/quick-issue-creation-guide.md` for comprehensive documentation including:
-- Detailed usage examples
-- Best practices and tips
-- Troubleshooting guide
-- Integration with SPEC documents
+---
 
 ---