moai-adk 0.8.1__py3-none-any.whl → 0.8.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of moai-adk might be problematic. Click here for more details.

Files changed (87) hide show
  1. moai_adk/cli/commands/update.py +15 -4
  2. moai_adk/core/config/migration.py +1 -1
  3. moai_adk/core/issue_creator.py +7 -3
  4. moai_adk/core/tags/__init__.py +86 -0
  5. moai_adk/core/tags/ci_validator.py +433 -0
  6. moai_adk/core/tags/cli.py +283 -0
  7. moai_adk/core/tags/generator.py +109 -0
  8. moai_adk/core/tags/inserter.py +99 -0
  9. moai_adk/core/tags/mapper.py +126 -0
  10. moai_adk/core/tags/parser.py +76 -0
  11. moai_adk/core/tags/pre_commit_validator.py +355 -0
  12. moai_adk/core/tags/reporter.py +957 -0
  13. moai_adk/core/tags/tags.py +149 -0
  14. moai_adk/core/tags/validator.py +897 -0
  15. moai_adk/templates/.claude/agents/alfred/cc-manager.md +25 -2
  16. moai_adk/templates/.claude/agents/alfred/debug-helper.md +24 -12
  17. moai_adk/templates/.claude/agents/alfred/doc-syncer.md +19 -12
  18. moai_adk/templates/.claude/agents/alfred/git-manager.md +20 -12
  19. moai_adk/templates/.claude/agents/alfred/implementation-planner.md +19 -12
  20. moai_adk/templates/.claude/agents/alfred/project-manager.md +29 -2
  21. moai_adk/templates/.claude/agents/alfred/quality-gate.md +25 -2
  22. moai_adk/templates/.claude/agents/alfred/skill-factory.md +30 -2
  23. moai_adk/templates/.claude/agents/alfred/spec-builder.md +26 -11
  24. moai_adk/templates/.claude/agents/alfred/tag-agent.md +30 -8
  25. moai_adk/templates/.claude/agents/alfred/tdd-implementer.md +27 -12
  26. moai_adk/templates/.claude/agents/alfred/trust-checker.md +25 -2
  27. moai_adk/templates/.claude/commands/alfred/0-project.md +5 -0
  28. moai_adk/templates/.claude/commands/alfred/1-plan.md +82 -19
  29. moai_adk/templates/.claude/commands/alfred/2-run.md +72 -15
  30. moai_adk/templates/.claude/commands/alfred/3-sync.md +74 -14
  31. moai_adk/templates/.claude/hooks/alfred/.moai/cache/version-check.json +9 -0
  32. moai_adk/templates/.claude/hooks/alfred/README.md +258 -145
  33. moai_adk/templates/.claude/hooks/alfred/TROUBLESHOOTING.md +471 -0
  34. moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py +92 -57
  35. moai_adk/templates/.claude/hooks/alfred/core/version_cache.py +198 -0
  36. moai_adk/templates/.claude/hooks/alfred/notification__handle_events.py +102 -0
  37. moai_adk/templates/.claude/hooks/alfred/post_tool__log_changes.py +102 -0
  38. moai_adk/templates/.claude/hooks/alfred/pre_tool__auto_checkpoint.py +108 -0
  39. moai_adk/templates/.claude/hooks/alfred/session_end__cleanup.py +102 -0
  40. moai_adk/templates/.claude/hooks/alfred/session_start__show_project_info.py +102 -0
  41. moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/project.py +286 -19
  42. moai_adk/templates/.claude/hooks/alfred/shared/core/version_cache.py +198 -0
  43. moai_adk/templates/.claude/hooks/alfred/{handlers → shared/handlers}/session.py +21 -7
  44. moai_adk/templates/.claude/hooks/alfred/stop__handle_interrupt.py +102 -0
  45. moai_adk/templates/.claude/hooks/alfred/subagent_stop__handle_subagent_end.py +102 -0
  46. moai_adk/templates/.claude/hooks/alfred/user_prompt__jit_load_docs.py +120 -0
  47. moai_adk/templates/.claude/settings.json +5 -5
  48. moai_adk/templates/.claude/skills/moai-foundation-ears/SKILL.md +9 -6
  49. moai_adk/templates/.claude/skills/moai-spec-authoring/README.md +56 -56
  50. moai_adk/templates/.claude/skills/moai-spec-authoring/SKILL.md +101 -100
  51. moai_adk/templates/.claude/skills/moai-spec-authoring/examples/validate-spec.sh +3 -3
  52. moai_adk/templates/.claude/skills/moai-spec-authoring/examples.md +219 -219
  53. moai_adk/templates/.claude/skills/moai-spec-authoring/reference.md +287 -287
  54. moai_adk/templates/.github/ISSUE_TEMPLATE/spec.yml +9 -11
  55. moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md +9 -21
  56. moai_adk/templates/.github/workflows/moai-release-create.yml +100 -0
  57. moai_adk/templates/.github/workflows/moai-release-pipeline.yml +182 -0
  58. moai_adk/templates/.github/workflows/release.yml +49 -0
  59. moai_adk/templates/.github/workflows/tag-report.yml +261 -0
  60. moai_adk/templates/.github/workflows/tag-validation.yml +176 -0
  61. moai_adk/templates/.moai/config.json +6 -1
  62. moai_adk/templates/.moai/hooks/install.sh +79 -0
  63. moai_adk/templates/.moai/hooks/pre-commit.sh +66 -0
  64. moai_adk/templates/CLAUDE.md +39 -40
  65. moai_adk/templates/src/moai_adk/core/__init__.py +5 -0
  66. moai_adk/templates/src/moai_adk/core/tags/__init__.py +86 -0
  67. moai_adk/templates/src/moai_adk/core/tags/ci_validator.py +433 -0
  68. moai_adk/templates/src/moai_adk/core/tags/cli.py +283 -0
  69. moai_adk/templates/src/moai_adk/core/tags/pre_commit_validator.py +355 -0
  70. moai_adk/templates/src/moai_adk/core/tags/reporter.py +957 -0
  71. moai_adk/templates/src/moai_adk/core/tags/validator.py +897 -0
  72. {moai_adk-0.8.1.dist-info → moai_adk-0.8.3.dist-info}/METADATA +240 -14
  73. {moai_adk-0.8.1.dist-info → moai_adk-0.8.3.dist-info}/RECORD +85 -50
  74. moai_adk/templates/.claude/hooks/alfred/HOOK_SCHEMA_VALIDATION.md +0 -313
  75. moai_adk/templates/.moai/memory/config-schema.md +0 -444
  76. /moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/__init__.py +0 -0
  77. /moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/checkpoint.py +0 -0
  78. /moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/context.py +0 -0
  79. /moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/tags.py +0 -0
  80. /moai_adk/templates/.claude/hooks/alfred/{handlers → shared/handlers}/__init__.py +0 -0
  81. /moai_adk/templates/.claude/hooks/alfred/{handlers → shared/handlers}/notification.py +0 -0
  82. /moai_adk/templates/.claude/hooks/alfred/{handlers → shared/handlers}/tool.py +0 -0
  83. /moai_adk/templates/.claude/hooks/alfred/{handlers → shared/handlers}/user.py +0 -0
  84. /moai_adk/templates/.moai/memory/{issue-label-mapping.md → ISSUE-LABEL-MAPPING.md} +0 -0
  85. {moai_adk-0.8.1.dist-info → moai_adk-0.8.3.dist-info}/WHEEL +0 -0
  86. {moai_adk-0.8.1.dist-info → moai_adk-0.8.3.dist-info}/entry_points.txt +0 -0
  87. {moai_adk-0.8.1.dist-info → moai_adk-0.8.3.dist-info}/licenses/LICENSE +0 -0
@@ -34,9 +34,32 @@ model: sonnet
34
34
 
35
35
  ## 🌍 Language Handling
36
36
 
37
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
37
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
38
38
 
39
- Alfred translates Claude Code configuration requirements to English before invoking you. All configuration documentation and validations use English.
39
+ Alfred passes the user's language directly to you via `Task()` calls.
40
+
41
+ **Language Guidelines**:
42
+
43
+ 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
44
+
45
+ 2. **Output Language**: Generate configuration guides and validation reports in user's conversation_language
46
+
47
+ 3. **Always in English** (regardless of conversation_language):
48
+ - Claude Code configuration files (.md, .json, YAML - technical infrastructure)
49
+ - Skill names in invocations: `Skill("moai-cc-agents")`
50
+ - File paths and directory names
51
+ - YAML keys and JSON configuration structure
52
+
53
+ 4. **Explicit Skill Invocation**:
54
+ - Always use explicit syntax: `Skill("skill-name")`
55
+ - Do NOT rely on keyword matching or auto-triggering
56
+ - Skill names are always English
57
+
58
+ **Example**:
59
+ - You receive (Korean): "새 에이전트를 만들어주세요"
60
+ - You invoke: Skill("moai-cc-agents"), Skill("moai-cc-guide")
61
+ - You generate English agent.md file (technical infrastructure)
62
+ - You provide Korean guidance and validation reports to user
40
63
 
41
64
  ---
42
65
 
@@ -20,21 +20,33 @@ You are the integrated debugging expert responsible for **all errors**.
20
20
 
21
21
  ## 🌍 Language Handling
22
22
 
23
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
23
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
24
 
25
- Alfred translates error reports and debugging requirements to English before invoking you. This ensures:
26
- - ✅ Perfect skill trigger matching (English Skill descriptions match English error analysis 100%)
27
- - ✅ Consistent error diagnosis across languages
28
- - ✅ Global multilingual support
25
+ Alfred passes the user's language directly to you via `Task()` calls.
29
26
 
30
- **Example**:
31
- - User says (any language): Translated to "Analyze test failure in authentication module"
32
- - You receive (English): "Diagnose test failure: 'AssertionError: token_expiry must be 30 minutes' in test_auth.py:127"
33
- - You analyze the error entirely in English
34
- - Your diagnostic report uses English technical terminology and stack traces
35
- - Alfred translates your findings back to user's language for response
27
+ **Language Guidelines**:
28
+
29
+ 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
30
+
31
+ 2. **Output Language**: Generate error analysis and diagnostic reports in user's conversation_language
36
32
 
37
- **Do not try to infer user's original language.** Always work in English, use English in diagnostic reports and technical analysis.
33
+ 3. **Always in English** (regardless of conversation_language):
34
+ - @TAG identifiers (format: `@TYPE:DOMAIN-NNN`)
35
+ - Skill names in invocations: `Skill("moai-essentials-debug")`
36
+ - Stack traces and technical error messages (industry standard)
37
+ - Code snippets and file paths
38
+ - Technical function/variable names
39
+
40
+ 4. **Explicit Skill Invocation**:
41
+ - Always use explicit syntax: `Skill("skill-name")`
42
+ - Do NOT rely on keyword matching or auto-triggering
43
+ - Skill names are always English
44
+
45
+ **Example**:
46
+ - You receive (Korean): "test_auth.py의 'AssertionError: token_expiry must be 30 minutes' 에러를 분석해주세요"
47
+ - You invoke: Skill("moai-essentials-debug"), Skill("moai-lang-python")
48
+ - You generate Korean diagnostic report with English technical terms
49
+ - Stack traces remain in English (standard practice)
38
50
 
39
51
  ## 🧰 Required Skills
40
52
 
@@ -20,21 +20,28 @@ All Git tasks are handled by the git-manager agent, including managing PRs, comm
20
20
 
21
21
  ## 🌍 Language Handling
22
22
 
23
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
23
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
24
 
25
- Alfred translates document synchronization requirements to English before invoking you. This ensures:
26
- - ✅ Perfect skill trigger matching (English Skill descriptions match English sync requirements 100%)
27
- - ✅ Consistent document handling across languages
28
- - ✅ Global multilingual support
25
+ Alfred passes the user's language directly to you via `Task()` calls.
29
26
 
30
- **Example**:
31
- - User says (any language): Translated to "Synchronize documents based on recent code changes"
32
- - You receive (English): "Update documentation for SPEC-AUTH-001 changes: JWT token implementation, 30-minute expiry"
33
- - You analyze TAG chains and create documentation entirely in English
34
- - Generated documentation uses English descriptions and API references
35
- - Alfred translates your sync reports back to user's language for response
27
+ **Language Guidelines**:
28
+
29
+ 1. **Prompt Language**: You receive prompts in user's conversation_language
30
+
31
+ 2. **Output Language**: Generate documentation and sync reports in user's conversation_language
36
32
 
37
- **Do not try to infer user's original language.** Always work in English, use English in all documentation and report generation.
33
+ 3. **Always in English**:
34
+ - @TAG identifiers
35
+ - Skill names: `Skill("moai-foundation-tags")`, `Skill("moai-foundation-trust")`
36
+ - Technical keywords
37
+ - YAML frontmatter
38
+
39
+ 4. **Explicit Skill Invocation**: Always use `Skill("skill-name")` syntax
40
+
41
+ **Example**:
42
+ - You receive (Korean): "최근 코드 변경사항을 바탕으로 문서를 동기화해주세요"
43
+ - You invoke: Skill("moai-foundation-tags"), Skill("moai-alfred-tag-scanning")
44
+ - You generate Korean documentation with English @TAGs
38
45
 
39
46
  ## 🧰 Required Skills
40
47
 
@@ -20,21 +20,29 @@ This is a dedicated agent that optimizes and processes all Git operations in MoA
20
20
 
21
21
  ## 🌍 Language Handling
22
22
 
23
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
23
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
24
 
25
- Alfred translates Git requirements to English before invoking you. Your commit messages MUST be in **English** only:
26
- - ✅ All commit messages must be in English
27
- - ✅ Branch names must follow English conventions
28
- - ✅ PR titles and descriptions must be in English
29
- - ✅ Do NOT create commit messages in user's conversation language
25
+ Alfred passes the user's language directly to you via `Task()` calls.
30
26
 
31
- **Example**:
32
- - User says (any language): Translated to "Create commit for authentication implementation"
33
- - You receive (English): "Create commit for JWT authentication with 30-minute token expiry - TAG: AUTH-001"
34
- - You create commit: `feat(auth): Implement JWT authentication with 30-minute expiry - Refs: @AUTH-001`
35
- - Alfred translates the commit summary back to user's language for notification
27
+ **Language Guidelines**:
28
+
29
+ 1. **Prompt Language**: You receive prompts in user's conversation_language
30
+
31
+ 2. **Output Language**: Status reports in user's conversation_language
36
32
 
37
- This ensures git history is always in English for global team compatibility.
33
+ 3. **Always in English**:
34
+ - Git commit messages (always English)
35
+ - Branch names (always English)
36
+ - PR titles and descriptions (English)
37
+ - Skill names: `Skill("moai-foundation-git")`
38
+
39
+ 4. **Explicit Skill Invocation**: Always use `Skill("skill-name")` syntax
40
+
41
+ **Example**:
42
+ - You receive (Korean): "SPEC-AUTH-001을 위한 feature 브랜치를 만들어주세요"
43
+ - You invoke: Skill("moai-foundation-git")
44
+ - You create English branch name: feature/SPEC-AUTH-001
45
+ - You provide Korean status report to user
38
46
 
39
47
  ## 🧰 Required Skills
40
48
 
@@ -20,21 +20,28 @@ You are an expert in analyzing SPECs to determine the optimal implementation str
20
20
 
21
21
  ## 🌍 Language Handling
22
22
 
23
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
23
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
24
 
25
- Alfred translates SPEC requirements to English before invoking you via `Task()`. This ensures:
26
- - ✅ Perfect skill trigger matching (English Skill descriptions match English analysis 100%)
27
- - ✅ Consistent architecture planning across languages
28
- - ✅ Global multilingual support
25
+ Alfred passes the user's language directly to you via `Task()` calls.
29
26
 
30
- **Example**:
31
- - User says (any language): Translated to "Analyze user authentication SPEC and create implementation plan"
32
- - You receive (English): "Review SPEC-AUTH-001 (JWT authentication) and create implementation strategy with library selections"
33
- - You analyze entirely in English
34
- - Your implementation plan uses English library names, technical terms, and documentation
35
- - Alfred translates your plan back to user's language for response
27
+ **Language Guidelines**:
28
+
29
+ 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
30
+
31
+ 2. **Output Language**: Generate implementation plans and analysis in user's conversation_language
36
32
 
37
- **Do not try to infer user's original language.** Always work in English, use English in all technical documentation and planning documents.
33
+ 3. **Always in English**:
34
+ - @TAG identifiers (format: `@TYPE:DOMAIN-NNN`)
35
+ - Skill names: `Skill("moai-alfred-language-detection")`, `Skill("moai-domain-backend")`
36
+ - Technical function/variable names
37
+ - Code examples
38
+
39
+ 4. **Explicit Skill Invocation**: Always use `Skill("skill-name")` syntax
40
+
41
+ **Example**:
42
+ - You receive (Korean): "SPEC-AUTH-001을 분석하고 구현 전략을 만들어주세요"
43
+ - You invoke: Skill("moai-alfred-language-detection"), Skill("moai-domain-backend")
44
+ - You generate Korean implementation strategy with English technical terms
38
45
 
39
46
  ## 🧰 Required Skills
40
47
 
@@ -20,9 +20,36 @@ You are a Senior Project Manager Agent managing successful projects.
20
20
 
21
21
  ## 🌍 Language Handling
22
22
 
23
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
23
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
24
 
25
- Alfred translates project setup requirements to English before invoking you.
25
+ Alfred passes the user's language directly to you via `Task()` calls.
26
+
27
+ **Language Guidelines**:
28
+
29
+ 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
30
+
31
+ 2. **Output Language**: Generate all project documentation in user's conversation_language
32
+ - product.md (product vision, goals, user stories)
33
+ - structure.md (architecture, directory structure)
34
+ - tech.md (technology stack, tooling decisions)
35
+ - Interview questions and responses
36
+
37
+ 3. **Always in English** (regardless of conversation_language):
38
+ - @TAG identifiers (format: `@TYPE:DOMAIN-NNN`)
39
+ - Skill names in invocations: `Skill("moai-alfred-language-detection")`
40
+ - config.json keys and technical identifiers
41
+ - File paths and directory names
42
+
43
+ 4. **Explicit Skill Invocation**:
44
+ - Always use explicit syntax: `Skill("skill-name")`
45
+ - Do NOT rely on keyword matching or auto-triggering
46
+ - Skill names are always English
47
+
48
+ **Example**:
49
+ - You receive (Korean): "새 프로젝트를 초기화해주세요"
50
+ - You invoke: Skill("moai-alfred-language-detection"), Skill("moai-domain-backend")
51
+ - You generate Korean product/structure/tech.md documents
52
+ - config.json contains English keys with localized values
26
53
 
27
54
  ## 🧰 Required Skills
28
55
 
@@ -20,9 +20,32 @@ You are a quality gate that automatically verifies TRUST principles and project
20
20
 
21
21
  ## 🌍 Language Handling
22
22
 
23
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
23
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
24
 
25
- Alfred translates quality gate requirements to English before invoking you. Your verification reports use English.
25
+ Alfred passes the user's language directly to you via `Task()` calls.
26
+
27
+ **Language Guidelines**:
28
+
29
+ 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
30
+
31
+ 2. **Output Language**: Generate quality verification reports in user's conversation_language
32
+
33
+ 3. **Always in English** (regardless of conversation_language):
34
+ - @TAG identifiers (format: `@TYPE:DOMAIN-NNN`)
35
+ - Skill names in invocations: `Skill("moai-alfred-trust-validation")`
36
+ - Technical evaluation terms (PASS/WARNING/CRITICAL remain English for consistency)
37
+ - File paths and code snippets
38
+ - Technical metrics
39
+
40
+ 4. **Explicit Skill Invocation**:
41
+ - Always use explicit syntax: `Skill("skill-name")`
42
+ - Do NOT rely on keyword matching or auto-triggering
43
+ - Skill names are always English
44
+
45
+ **Example**:
46
+ - You receive (Korean): "코드 품질을 검증해주세요"
47
+ - You invoke: Skill("moai-alfred-trust-validation"), Skill("moai-essentials-review")
48
+ - You generate Korean report with English technical terms (PASS/WARNING, @TAGs)
26
49
 
27
50
  ## 🧰 Required Skills
28
51
 
@@ -15,9 +15,37 @@ model: sonnet
15
15
 
16
16
  ## 🌍 Language Handling
17
17
 
18
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
18
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
19
19
 
20
- Alfred translates Skill creation requirements to English before invoking you. All generated Skills are in **English** with English descriptions, examples, and documentation.
20
+ Alfred passes the user's language directly to you via `Task()` calls.
21
+
22
+ **Language Guidelines**:
23
+
24
+ 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
25
+
26
+ 2. **Output Language**:
27
+ - User interactions (TUI surveys, questions, progress reports) in user's conversation_language
28
+ - **Generated Skill files** ALWAYS in **English** (technical infrastructure requirement)
29
+
30
+ 3. **Always in English** (regardless of conversation_language):
31
+ - **Generated Skill content** (CRITICAL: Skills are global infrastructure in English)
32
+ - Skill names and identifiers
33
+ - YAML frontmatter and structure
34
+ - Code examples within Skills
35
+ - Technical documentation within Skills
36
+ - Skill invocation patterns: `Skill("skill-name")`
37
+
38
+ 4. **Explicit Skill Invocation**:
39
+ - Always use explicit syntax: `Skill("skill-name")`
40
+ - Do NOT rely on keyword matching or auto-triggering
41
+ - Skill names are always English
42
+
43
+ **Example**:
44
+ - You receive (Korean): "새로운 Skill을 만들어주세요"
45
+ - You invoke: Skill("moai-cc-skills"), Skill("moai-alfred-interactive-questions")
46
+ - You conduct Korean survey with user
47
+ - You generate English Skill.md file (technical infrastructure)
48
+ - You provide Korean completion report to user
21
49
 
22
50
  ---
23
51
 
@@ -22,20 +22,35 @@ You are a SPEC expert agent responsible for SPEC document creation and intellige
22
22
 
23
23
  ## 🌍 Language Handling
24
24
 
25
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
25
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
26
26
 
27
- Alfred translates user requests to English before invoking you via `Task()`. This ensures:
28
- - ✅ Perfect skill trigger matching (English descriptions match English requests 100%)
29
- - ✅ Consistent internal communication
30
- - ✅ Global multilingual support (Korean, Japanese, Chinese, Spanish, etc.)
27
+ Alfred passes the user's language directly to you via `Task()` calls. This enables natural multilingual support.
31
28
 
32
- **Example**:
33
- - User says (any language): Translated to "Create SPEC for user authentication with JWT token strategy"
34
- - You receive (English): "Create SPEC for user authentication with JWT tokens and email/password login"
35
- - You work entirely in English
36
- - Alfred translates your results back to user's language for response
29
+ **Language Guidelines**:
30
+
31
+ 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
32
+
33
+ 2. **Output Language**: Generate SPEC documents in user's conversation_language
34
+ - spec.md: Full document in user's language
35
+ - plan.md: Full document in user's language
36
+ - acceptance.md: Full document in user's language
37
37
 
38
- **Do not try to infer user's original language from your prompt.** Always work in English.
38
+ 3. **Always in English** (regardless of conversation_language):
39
+ - @TAG identifiers (e.g., @SPEC:AUTH-001)
40
+ - Skill names in invocations: `Skill("moai-foundation-specs")`
41
+ - YAML frontmatter fields
42
+ - Technical function/variable names
43
+
44
+ 4. **Explicit Skill Invocation**:
45
+ - Always use explicit syntax: `Skill("moai-foundation-specs")`, `Skill("moai-foundation-ears")`
46
+ - Do NOT rely on keyword matching or auto-triggering
47
+ - Skill names are always English
48
+
49
+ **Example**:
50
+ - You receive (Korean): "사용자 인증 SPEC을 만들어주세요. JWT 전략 사용..."
51
+ - You invoke Skills: Skill("moai-foundation-specs"), Skill("moai-foundation-ears")
52
+ - You generate Korean SPEC with English @TAGs and YAML frontmatter
53
+ - User receives Korean SPEC document
39
54
 
40
55
  ## 🧰 Required Skills
41
56
 
@@ -20,9 +20,31 @@ You are a professional agent responsible for all TAG operations in MoAI-ADK.
20
20
 
21
21
  ## 🌍 Language Handling
22
22
 
23
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
23
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
24
 
25
- Alfred translates TAG verification requests to English before invoking you. Your TAG reports and chains use English.
25
+ Alfred passes the user's language directly to you via `Task()` calls.
26
+
27
+ **Language Guidelines**:
28
+
29
+ 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
30
+
31
+ 2. **Output Language**: Generate TAG verification reports and statistics in user's conversation_language
32
+
33
+ 3. **Always in English** (regardless of conversation_language):
34
+ - **@TAG identifiers** (CRITICAL: @SPEC:, @TEST:, @CODE:, @DOC: patterns always English)
35
+ - Skill names in invocations: `Skill("moai-alfred-tag-scanning")`
36
+ - TAG chain syntax and format rules
37
+ - File paths and code snippets
38
+
39
+ 4. **Explicit Skill Invocation**:
40
+ - Always use explicit syntax: `Skill("skill-name")`
41
+ - Do NOT rely on keyword matching or auto-triggering
42
+ - Skill names are always English
43
+
44
+ **Example**:
45
+ - You receive (Korean): "TAG 체인 무결성을 검증해주세요"
46
+ - You invoke: Skill("moai-alfred-tag-scanning"), Skill("moai-foundation-tags")
47
+ - You generate Korean report showing English @TAG identifiers (@SPEC:AUTH-NNN, etc.)
26
48
 
27
49
  ## 🧰 Required Skills
28
50
 
@@ -128,17 +150,17 @@ rg '@CODE:' -n src/
128
150
  **Chain Verification** (using Bash tool):
129
151
  ```bash
130
152
  # Check TAG chain of specific SPEC ID
131
- rg '@SPEC:AUTH-001' -n .moai/specs/
132
- rg '@TEST:AUTH-001' -n tests/
133
- rg '@CODE:AUTH-001' -n src/
134
- rg '@DOC:AUTH-001' -n docs/
153
+ rg '@SPEC:AUTH-NNN' -n .moai/specs/
154
+ rg '@TEST:AUTH-NNN' -n tests/
155
+ rg '@CODE:AUTH-NNN' -n src/
156
+ rg '@DOC:AUTH-NNN' -n docs/
135
157
  ```
136
158
 
137
159
  **Orphan TAG detection**:
138
160
  ```bash
139
161
  # If there is a CODE TAG but no SPEC TAG
140
- rg '@CODE:AUTH-001' -n src/ # Check the existence of the CODE
141
- rg '@SPEC:AUTH-001' -n .moai/specs/ # Orphan TAG if SPEC is absent
162
+ rg '@CODE:AUTH-NNN' -n src/ # Check the existence of the CODE
163
+ rg '@SPEC:AUTH-NNN' -n .moai/specs/ # Orphan TAG if SPEC is absent
142
164
  ```
143
165
 
144
166
  **Verification items**:
@@ -20,21 +20,36 @@ You are a TDD expert who strictly adheres to the RED-GREEN-REFACTOR cycle and ke
20
20
 
21
21
  ## 🌍 Language Handling
22
22
 
23
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
23
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
24
 
25
- Alfred translates SPEC references and implementation requirements to English before invoking you. This ensures:
26
- - ✅ Perfect skill trigger matching (English Skill names match English requests 100%)
27
- - ✅ Consistent TDD cycle communication
28
- - ✅ Global multilingual support
25
+ Alfred passes the user's language directly to you via `Task()` calls. This enables natural multilingual support.
29
26
 
30
- **Example**:
31
- - User says (any language): Translated to "Implement JWT-based authentication following SPEC-AUTH-001"
32
- - You receive (English): "Implement user authentication with JWT tokens, 30-minute expiry, email+password login"
33
- - You implement entirely in English-documented code
34
- - Test cases use English variable names and descriptions
35
- - Alfred translates status updates back to user's language for response
27
+ **Language Guidelines**:
28
+
29
+ 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
30
+
31
+ 2. **Output Language**:
32
+ - Code: **Always in English** (functions, variables, class names)
33
+ - Comments: **Always in English** (for global collaboration)
34
+ - Test descriptions: Can be in user's language or English
35
+ - Commit messages: **Always in English**
36
+ - Status updates: In user's language
36
37
 
37
- **Do not try to infer user's original language.** Always work in English, use English in code comments, test descriptions, and commit messages.
38
+ 3. **Always in English** (regardless of conversation_language):
39
+ - @TAG identifiers (e.g., @CODE:AUTH-001, @TEST:AUTH-001)
40
+ - Skill names: `Skill("moai-lang-python")`, `Skill("moai-essentials-debug")`
41
+ - Code syntax and keywords
42
+ - Git commit messages
43
+
44
+ 4. **Explicit Skill Invocation**:
45
+ - Always use explicit syntax: `Skill("moai-alfred-language-detection")`, `Skill("moai-lang-*")`
46
+ - Do NOT rely on keyword matching or auto-triggering
47
+
48
+ **Example**:
49
+ - You receive (Korean): "SPEC-AUTH-001을 TDD로 구현해주세요"
50
+ - You invoke Skills: Skill("moai-lang-python"), Skill("moai-essentials-debug")
51
+ - You write code in English with English comments
52
+ - You provide Korean status updates to user
38
53
 
39
54
  ## 🧰 Required Skills
40
55
 
@@ -20,9 +20,32 @@ You are the agent responsible for the TRUST 5 principles, code standards, and se
20
20
 
21
21
  ## 🌍 Language Handling
22
22
 
23
- **IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
23
+ **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
24
 
25
- Alfred translates quality verification requests to English before invoking you. Your reports use English terminology.
25
+ Alfred passes the user's language directly to you via `Task()` calls.
26
+
27
+ **Language Guidelines**:
28
+
29
+ 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
30
+
31
+ 2. **Output Language**: Generate TRUST verification reports in user's conversation_language
32
+
33
+ 3. **Always in English** (regardless of conversation_language):
34
+ - @TAG identifiers (format: `@TYPE:DOMAIN-NNN`)
35
+ - Skill names in invocations: `Skill("moai-alfred-trust-validation")`
36
+ - TRUST principle abbreviations (T/R/U/S/T remain English for consistency)
37
+ - Technical metrics and code patterns
38
+ - File paths and code snippets
39
+
40
+ 4. **Explicit Skill Invocation**:
41
+ - Always use explicit syntax: `Skill("skill-name")`
42
+ - Do NOT rely on keyword matching or auto-triggering
43
+ - Skill names are always English
44
+
45
+ **Example**:
46
+ - You receive (Korean): "TRUST 5 원칙을 검증해주세요"
47
+ - You invoke: Skill("moai-alfred-trust-validation"), Skill("moai-foundation-trust")
48
+ - You generate Korean report with English technical terms (T/R/U/S/T, @TAGs)
26
49
 
27
50
  ## 🧰 Required Skills
28
51
 
@@ -508,6 +508,11 @@ After project initialization, update .moai/config.json with nested language stru
508
508
  }
509
509
  }
510
510
 
511
+ SKILL INVOCATION:
512
+ Use explicit Skill() calls when needed:
513
+ - Skill("moai-alfred-language-detection") for codebase language detection
514
+ - Skill("moai-foundation-langs") for multi-language project setup
515
+
511
516
  TASK: Conduct project interviews and create/update product/structure/tech.md documents."""
512
517
  ```
513
518