moai-adk 0.8.0__py3-none-any.whl → 0.8.2__py3-none-any.whl

moai_adk/templates/.claude/agents/alfred/spec-builder.md

@@ -22,20 +22,35 @@ You are a SPEC expert agent responsible for SPEC document creation and intellige
 
 ## 🌍 Language Handling
 
-**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+**IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
 
-Alfred translates user requests to English before invoking you via `Task()`. This ensures:
-- ✅ Perfect skill trigger matching (English descriptions match English requests 100%)
-- ✅ Consistent internal communication
-- ✅ Global multilingual support (Korean, Japanese, Chinese, Spanish, etc.)
+Alfred passes the user's language directly to you via `Task()` calls. This enables natural multilingual support.
 
-**Example**:
-- User says (any language): Translated to "Create SPEC for user authentication with JWT token strategy"
-- You receive (English): "Create SPEC for user authentication with JWT tokens and email/password login"
-- You work entirely in English
-- Alfred translates your results back to user's language for response
+**Language Guidelines**:
+
+1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
+
+2. **Output Language**: Generate SPEC documents in user's conversation_language
+   - spec.md: Full document in user's language
+   - plan.md: Full document in user's language
+   - acceptance.md: Full document in user's language
 
-**Do not try to infer user's original language from your prompt.** Always work in English.
+3. **Always in English** (regardless of conversation_language):
+   - @TAG identifiers (e.g., @SPEC:AUTH-001)
+   - Skill names in invocations: `Skill("moai-foundation-specs")`
+   - YAML frontmatter fields
+   - Technical function/variable names
+
+4. **Explicit Skill Invocation**:
+   - Always use explicit syntax: `Skill("moai-foundation-specs")`, `Skill("moai-foundation-ears")`
+   - Do NOT rely on keyword matching or auto-triggering
+   - Skill names are always English
+
+**Example**:
+- You receive (Korean): "사용자 인증 SPEC을 만들어주세요. JWT 전략 사용..."
+- You invoke Skills: Skill("moai-foundation-specs"), Skill("moai-foundation-ears")
+- You generate Korean SPEC with English @TAGs and YAML frontmatter
+- User receives Korean SPEC document
 
 ## 🧰 Required Skills
 

moai_adk/templates/.claude/agents/alfred/tag-agent.md

@@ -20,9 +20,31 @@ You are a professional agent responsible for all TAG operations in MoAI-ADK.
 
 ## 🌍 Language Handling
 
-**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+**IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
 
-Alfred translates TAG verification requests to English before invoking you. Your TAG reports and chains use English.
+Alfred passes the user's language directly to you via `Task()` calls.
+
+**Language Guidelines**:
+
+1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
+
+2. **Output Language**: Generate TAG verification reports and statistics in user's conversation_language
+
+3. **Always in English** (regardless of conversation_language):
+   - **@TAG identifiers** (CRITICAL: @SPEC:, @TEST:, @CODE:, @DOC: patterns always English)
+   - Skill names in invocations: `Skill("moai-alfred-tag-scanning")`
+   - TAG chain syntax and format rules
+   - File paths and code snippets
+
+4. **Explicit Skill Invocation**:
+   - Always use explicit syntax: `Skill("skill-name")`
+   - Do NOT rely on keyword matching or auto-triggering
+   - Skill names are always English
+
+**Example**:
+- You receive (Korean): "TAG 체인 무결성을 검증해주세요"
+- You invoke: Skill("moai-alfred-tag-scanning"), Skill("moai-foundation-tags")
+- You generate Korean report showing English @TAG identifiers (@SPEC:AUTH-NNN, etc.)
 
 ## 🧰 Required Skills
 
@@ -128,17 +150,17 @@ rg '@CODE:' -n src/
 **Chain Verification** (using Bash tool):
 ```bash
 # Check TAG chain of specific SPEC ID
-rg '@SPEC:AUTH-001' -n .moai/specs/
-rg '@TEST:AUTH-001' -n tests/
-rg '@CODE:AUTH-001' -n src/
-rg '@DOC:AUTH-001' -n docs/
+rg '@SPEC:AUTH-NNN' -n .moai/specs/
+rg '@TEST:AUTH-NNN' -n tests/
+rg '@CODE:AUTH-NNN' -n src/
+rg '@DOC:AUTH-NNN' -n docs/
 ```
 
 **Orphan TAG detection**:
 ```bash
 # If there is a CODE TAG but no SPEC TAG
-rg '@CODE:AUTH-001' -n src/ # Check the existence of the CODE
-rg '@SPEC:AUTH-001' -n .moai/specs/ # Orphan TAG if SPEC is absent
+rg '@CODE:AUTH-NNN' -n src/ # Check the existence of the CODE
+rg '@SPEC:AUTH-NNN' -n .moai/specs/ # Orphan TAG if SPEC is absent
 ```
 
 **Verification items**:

moai_adk/templates/.claude/agents/alfred/tdd-implementer.md

@@ -20,21 +20,36 @@ You are a TDD expert who strictly adheres to the RED-GREEN-REFACTOR cycle and ke
 
 ## 🌍 Language Handling
 
-**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+**IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
 
-Alfred translates SPEC references and implementation requirements to English before invoking you. This ensures:
-- ✅ Perfect skill trigger matching (English Skill names match English requests 100%)
-- ✅ Consistent TDD cycle communication
-- ✅ Global multilingual support
+Alfred passes the user's language directly to you via `Task()` calls. This enables natural multilingual support.
 
-**Example**:
-- User says (any language): Translated to "Implement JWT-based authentication following SPEC-AUTH-001"
-- You receive (English): "Implement user authentication with JWT tokens, 30-minute expiry, email+password login"
-- You implement entirely in English-documented code
-- Test cases use English variable names and descriptions
-- Alfred translates status updates back to user's language for response
+**Language Guidelines**:
+
+1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
+
+2. **Output Language**:
+   - Code: **Always in English** (functions, variables, class names)
+   - Comments: **Always in English** (for global collaboration)
+   - Test descriptions: Can be in user's language or English
+   - Commit messages: **Always in English**
+   - Status updates: In user's language
 
-**Do not try to infer user's original language.** Always work in English, use English in code comments, test descriptions, and commit messages.
+3. **Always in English** (regardless of conversation_language):
+   - @TAG identifiers (e.g., @CODE:AUTH-001, @TEST:AUTH-001)
+   - Skill names: `Skill("moai-lang-python")`, `Skill("moai-essentials-debug")`
+   - Code syntax and keywords
+   - Git commit messages
+
+4. **Explicit Skill Invocation**:
+   - Always use explicit syntax: `Skill("moai-alfred-language-detection")`, `Skill("moai-lang-*")`
+   - Do NOT rely on keyword matching or auto-triggering
+
+**Example**:
+- You receive (Korean): "SPEC-AUTH-001을 TDD로 구현해주세요"
+- You invoke Skills: Skill("moai-lang-python"), Skill("moai-essentials-debug")
+- You write code in English with English comments
+- You provide Korean status updates to user
 
 ## 🧰 Required Skills
 

moai_adk/templates/.claude/agents/alfred/trust-checker.md

@@ -20,9 +20,32 @@ You are the agent responsible for the TRUST 5 principles, code standards, and se
 
 ## 🌍 Language Handling
 
-**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+**IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
 
-Alfred translates quality verification requests to English before invoking you. Your reports use English terminology.
+Alfred passes the user's language directly to you via `Task()` calls.
+
+**Language Guidelines**:
+
+1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
+
+2. **Output Language**: Generate TRUST verification reports in user's conversation_language
+
+3. **Always in English** (regardless of conversation_language):
+   - @TAG identifiers (format: `@TYPE:DOMAIN-NNN`)
+   - Skill names in invocations: `Skill("moai-alfred-trust-validation")`
+   - TRUST principle abbreviations (T/R/U/S/T remain English for consistency)
+   - Technical metrics and code patterns
+   - File paths and code snippets
+
+4. **Explicit Skill Invocation**:
+   - Always use explicit syntax: `Skill("skill-name")`
+   - Do NOT rely on keyword matching or auto-triggering
+   - Skill names are always English
+
+**Example**:
+- You receive (Korean): "TRUST 5 원칙을 검증해주세요"
+- You invoke: Skill("moai-alfred-trust-validation"), Skill("moai-foundation-trust")
+- You generate Korean report with English technical terms (T/R/U/S/T, @TAGs)
 
 ## 🧰 Required Skills
 

moai_adk/templates/.claude/commands/alfred/0-project.md

@@ -508,6 +508,11 @@ After project initialization, update .moai/config.json with nested language stru
   }
 }
 
+SKILL INVOCATION:
+Use explicit Skill() calls when needed:
+- Skill("moai-alfred-language-detection") for codebase language detection
+- Skill("moai-foundation-langs") for multi-language project setup
+
 TASK: Conduct project interviews and create/update product/structure/tech.md documents."""
 ```
 

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

@@ -154,6 +154,12 @@ All SPEC documents and analysis must be generated in conversation_language.
 - If conversation_language is 'ja' (Japanese): Generate ALL analysis, plans, and SPEC documents in Japanese
 - If conversation_language is other language: Follow the specified language
 
+SKILL INVOCATION:
+Use explicit Skill() calls when needed:
+- Skill("moai-foundation-specs") for SPEC structure guidance
+- Skill("moai-foundation-ears") for EARS syntax requirements
+- Skill("moai-alfred-spec-metadata-validation") for metadata validation
+
 TASK:
 Please analyze the project document and suggest SPEC candidates.
 Run in analysis mode, and must include the following:
@@ -218,6 +224,13 @@ ALL SPEC documents MUST be generated in conversation_language:
 YAML frontmatter and @TAG identifiers MUST remain in English.
 Code examples and technical keywords can be mixed (code in English, narrative in user language).
 
+SKILL INVOCATION:
+Use explicit Skill() calls when needed:
+- Skill("moai-foundation-specs") for SPEC structure guidance
+- Skill("moai-foundation-ears") for EARS syntax requirements
+- Skill("moai-alfred-spec-metadata-validation") for metadata validation
+- Skill("moai-alfred-tag-scanning") for TAG chain references
+
 TASK:
 Please fill out the SPEC document according to the plan approved in STEP 1.
 Create a specification for the EARS structure."""
@@ -372,7 +385,7 @@ Only if the user selects **"Proceed"** or **"Start"** will Alfred call the spec-
 ### State-driven Requirements
 - When the WHILE token is in an unexpired state, the system must allow access to the protected resource.
 
-### Constraints
+### Unwanted Behaviors
 - If the IF token has expired, the system must return a 401 Unauthorized response.
 ```
 
@@ -484,8 +497,8 @@ author: @username
 ### Optional (Optional function)
 - If WHERE [condition], the system can [operate]
 
-### Constraints
-- IF [condition], the system must be [constrained]
+### Unwanted Behaviors
+- IF [condition], the system must [respond appropriately with error handling or quality gates]
 
 ## Traceability (@TAG)
 - **SPEC**: @SPEC:AUTH-001
@@ -630,7 +643,7 @@ done
 **CodeRabbit review includes:**
 - ✅ YAML frontmatter validation (7 required fields)
 - ✅ HISTORY section structure and completeness
-- ✅ EARS requirements clarity (Ubiquitous/Event/State/Optional/Constraints)
+- ✅ EARS requirements clarity (Ubiquitous/Event-driven/State-driven/Optional/Unwanted Behaviors)
 - ✅ Acceptance criteria quality (Given-When-Then scenarios)
 - ✅ @TAG system compliance (SPEC/TEST/CODE/DOC traceability)
 - ✅ Documentation and formatting

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

@@ -202,6 +202,13 @@ Code and technical output MUST be in English.
 Code comments MAY be in {{CONVERSATION_LANGUAGE}} if appropriate.
 Test descriptions and documentation can use {{CONVERSATION_LANGUAGE}}.
 
+SKILL INVOCATION:
+Use explicit Skill() calls when needed:
+- Skill("moai-alfred-language-detection") for project language detection
+- Skill("moai-lang-python") or language-specific Skills for best practices
+- Skill("moai-essentials-debug") when tests fail
+- Skill("moai-essentials-refactor") during REFACTOR phase
+
 TASK: Execute the task according to the plan approved in STEP 1.
 
 For TDD scenario:

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

@@ -175,6 +175,12 @@ Documentation updates MUST respect conversation_language:
 - Code comments: {{CONVERSATION_LANGUAGE}} (when not technical keywords)
 - Technical documentation and YAML frontmatter: English
 
+SKILL INVOCATION:
+Use explicit Skill() calls when needed:
+- Skill("moai-foundation-tags") for TAG chain validation
+- Skill("moai-foundation-trust") for quality gate checks
+- Skill("moai-alfred-tag-scanning") for TAG inventory updates
+
 TASK:
 Please analyze Git changes and establish a document synchronization plan.
 Ensure all documentation updates align with the conversation_language setting.

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

@@ -0,0 +1,149 @@
+---
+name: alfred:9-feedback
+description: "Interactive GitHub Issue creation - Step-by-step dialog to create issues without command arguments"
+allowed-tools:
+- Bash(gh:*)
+- Task
+- AskUserQuestion
+---
+
+# 🎯 MoAI-ADK Alfred 9-Feedback: Interactive GitHub Issue Creation
+
+> **Purpose**: Create GitHub Issues through an interactive multi-step dialog. Simple command → guided questions → automatic issue creation.
+
+## 📋 Command Purpose
+
+Enable developers to instantly report bugs, request features, suggest improvements, and ask questions through conversational dialogs. No command arguments needed—just run `/alfred:9-feedback` and answer questions.
+
+**Command Format**:
+```bash
+/alfred:9-feedback
+```
+
+That's it! Alfred guides you through the rest.
+
+---
+
+## 🚀 Interactive Execution Flow
+
+### Step 1: Start Command
+```bash
+/alfred:9-feedback
+```
+
+Alfred responds and proceeds to Step 2.
+
+---
+
+### Step 2: Select Issue Type (AskUserQuestion)
+
+**Question**: "What type of issue do you want to create?"
+
+**Options**:
+```
+[ ] 🐛 Bug Report - Something isn't working
+[ ] ✨ Feature Request - Suggest new functionality
+[ ] ⚡ Improvement - Enhance existing features
+[ ] ❓ Question/Discussion - Ask the team
+```
+
+**User Selection**: Selects one (e.g., 🐛 Bug Report)
+
+---
+
+### Step 3: Enter Issue Title (AskUserQuestion)
+
+**Question**: "What is the issue title? (Be concise)"
+
+**Example Input**:
+```
+Login button on homepage not responding to clicks
+```
+
+---
+
+### Step 4: Enter Description (AskUserQuestion)
+
+**Question**: "Provide a detailed description (optional—press Enter to skip)"
+
+**Example Input**:
+```
+When I click the login button on the homepage, nothing happens.
+Tested on Chrome 120.0 on macOS 14.2.
+Expected: Login modal should appear
+Actual: No response
+```
+
+Or just press Enter to skip.
+
+---
+
+### Step 5: Select Priority (AskUserQuestion)
+
+**Question**: "What's the priority level?"
+
+**Options**:
+```
+[ ] 🔴 Critical - System down, data loss, security breach
+[ ] 🟠 High - Major feature broken, significant impact
+[✓] 🟡 Medium - Normal priority (default)
+[ ] 🟢 Low - Minor issues, nice-to-have
+```
+
+**User Selection**: Selects priority (e.g., 🟠 High)
+
+---
+
+### Step 6: Create Issue (Automatic)
+
+Alfred automatically:
+1. Formats title with emoji: "🐛 [BUG] Login button not responding..."
+2. Prepares body with user description + metadata
+3. Assigns labels: bug, reported, priority-high
+4. Executes: `gh issue create --title ... --body ... --label ...`
+5. Parses issue number from response
+
+**Success Output**:
+```
+✅ GitHub Issue #234 created successfully!
+
+📋 Title: 🐛 [BUG] Login button not responding to clicks
+🔴 Priority: High
+🏷️  Labels: bug, reported, priority-high
+🔗 URL: https://github.com/owner/repo/issues/234
+
+💡 Next: Reference this issue in your commits or link to a SPEC document
+```
+
+---
+
+## ⚠️ Important Rules
+
+### ✅ What to Do
+
+- ✅ Ask all 4 questions in sequence (type → title → description → priority)
+- ✅ Preserve exact user wording in title and description
+- ✅ Use AskUserQuestion for all user inputs
+- ✅ Allow skipping description (optional field)
+- ✅ Show issue URL after creation
+
+### ❌ What NOT to Do
+
+- ❌ Accept command arguments (`/alfred:9-feedback --bug` is wrong—just use `/alfred:9-feedback`)
+- ❌ Skip questions or change order
+- ❌ Rephrase user's input
+- ❌ Create issues without labels
+
+---
+
+## 💡 Key Benefits
+
+1. **🚀 No Arguments Needed**: Just `/alfred:9-feedback`
+2. **💬 Conversational**: Intuitive step-by-step dialog
+3. **🏷️ Auto-labeled**: Labels applied automatically
+4. **🔗 Team Visible**: Issues immediately visible
+5. **⏱️ Fast**: Create issues in 30 seconds
+
+---
+
+**Supported since**: MoAI-ADK v0.7.0+

moai_adk/templates/.claude/hooks/alfred/.moai/cache/version-check.json

@@ -0,0 +1,9 @@
+{
+  "current": "0.8.1",
+  "latest": "0.8.1",
+  "update_available": false,
+  "upgrade_command": "",
+  "release_notes_url": "https://github.com/modu-ai/moai-adk/releases",
+  "is_major_update": false,
+  "last_check": "2025-10-29T08:52:11.240503+00:00"
+}