moai-adk 0.8.1__py3-none-any.whl → 0.8.2__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/tags/__init__.py +87 -0
  3. moai_adk/core/tags/ci_validator.py +435 -0
  4. moai_adk/core/tags/cli.py +283 -0
  5. moai_adk/core/tags/generator.py +109 -0
  6. moai_adk/core/tags/inserter.py +99 -0
  7. moai_adk/core/tags/mapper.py +126 -0
  8. moai_adk/core/tags/parser.py +76 -0
  9. moai_adk/core/tags/pre_commit_validator.py +355 -0
  10. moai_adk/core/tags/reporter.py +959 -0
  11. moai_adk/core/tags/tags.py +149 -0
  12. moai_adk/core/tags/validator.py +897 -0
  13. moai_adk/templates/.claude/agents/alfred/cc-manager.md +25 -2
  14. moai_adk/templates/.claude/agents/alfred/debug-helper.md +24 -12
  15. moai_adk/templates/.claude/agents/alfred/doc-syncer.md +19 -12
  16. moai_adk/templates/.claude/agents/alfred/git-manager.md +20 -12
  17. moai_adk/templates/.claude/agents/alfred/implementation-planner.md +19 -12
  18. moai_adk/templates/.claude/agents/alfred/project-manager.md +29 -2
  19. moai_adk/templates/.claude/agents/alfred/quality-gate.md +25 -2
  20. moai_adk/templates/.claude/agents/alfred/skill-factory.md +30 -2
  21. moai_adk/templates/.claude/agents/alfred/spec-builder.md +26 -11
  22. moai_adk/templates/.claude/agents/alfred/tag-agent.md +30 -8
  23. moai_adk/templates/.claude/agents/alfred/tdd-implementer.md +27 -12
  24. moai_adk/templates/.claude/agents/alfred/trust-checker.md +25 -2
  25. moai_adk/templates/.claude/commands/alfred/0-project.md +5 -0
  26. moai_adk/templates/.claude/commands/alfred/1-plan.md +17 -4
  27. moai_adk/templates/.claude/commands/alfred/2-run.md +7 -0
  28. moai_adk/templates/.claude/commands/alfred/3-sync.md +6 -0
  29. moai_adk/templates/.claude/hooks/alfred/.moai/cache/version-check.json +9 -0
  30. moai_adk/templates/.claude/hooks/alfred/README.md +258 -145
  31. moai_adk/templates/.claude/hooks/alfred/TROUBLESHOOTING.md +471 -0
  32. moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py +92 -57
  33. moai_adk/templates/.claude/hooks/alfred/core/version_cache.py +198 -0
  34. moai_adk/templates/.claude/hooks/alfred/notification__handle_events.py +102 -0
  35. moai_adk/templates/.claude/hooks/alfred/post_tool__log_changes.py +102 -0
  36. moai_adk/templates/.claude/hooks/alfred/pre_tool__auto_checkpoint.py +108 -0
  37. moai_adk/templates/.claude/hooks/alfred/session_end__cleanup.py +102 -0
  38. moai_adk/templates/.claude/hooks/alfred/session_start__show_project_info.py +102 -0
  39. moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/project.py +269 -13
  40. moai_adk/templates/.claude/hooks/alfred/shared/core/version_cache.py +198 -0
  41. moai_adk/templates/.claude/hooks/alfred/{handlers → shared/handlers}/session.py +21 -7
  42. moai_adk/templates/.claude/hooks/alfred/stop__handle_interrupt.py +102 -0
  43. moai_adk/templates/.claude/hooks/alfred/subagent_stop__handle_subagent_end.py +102 -0
  44. moai_adk/templates/.claude/hooks/alfred/user_prompt__jit_load_docs.py +120 -0
  45. moai_adk/templates/.claude/settings.json +5 -5
  46. moai_adk/templates/.claude/skills/moai-foundation-ears/SKILL.md +9 -6
  47. moai_adk/templates/.claude/skills/moai-spec-authoring/README.md +56 -56
  48. moai_adk/templates/.claude/skills/moai-spec-authoring/SKILL.md +101 -100
  49. moai_adk/templates/.claude/skills/moai-spec-authoring/examples/validate-spec.sh +3 -3
  50. moai_adk/templates/.claude/skills/moai-spec-authoring/examples.md +219 -219
  51. moai_adk/templates/.claude/skills/moai-spec-authoring/reference.md +287 -287
  52. moai_adk/templates/.github/ISSUE_TEMPLATE/spec.yml +9 -11
  53. moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md +9 -21
  54. moai_adk/templates/.github/workflows/moai-release-create.yml +100 -0
  55. moai_adk/templates/.github/workflows/moai-release-pipeline.yml +182 -0
  56. moai_adk/templates/.github/workflows/release.yml +49 -0
  57. moai_adk/templates/.github/workflows/tag-report.yml +261 -0
  58. moai_adk/templates/.github/workflows/tag-validation.yml +176 -0
  59. moai_adk/templates/.moai/config.json +6 -1
  60. moai_adk/templates/.moai/hooks/install.sh +79 -0
  61. moai_adk/templates/.moai/hooks/pre-commit.sh +66 -0
  62. moai_adk/templates/CLAUDE.md +39 -40
  63. moai_adk/templates/src/moai_adk/core/__init__.py +5 -0
  64. moai_adk/templates/src/moai_adk/core/tags/__init__.py +87 -0
  65. moai_adk/templates/src/moai_adk/core/tags/ci_validator.py +435 -0
  66. moai_adk/templates/src/moai_adk/core/tags/cli.py +283 -0
  67. moai_adk/templates/src/moai_adk/core/tags/pre_commit_validator.py +355 -0
  68. moai_adk/templates/src/moai_adk/core/tags/reporter.py +959 -0
  69. moai_adk/templates/src/moai_adk/core/tags/validator.py +897 -0
  70. {moai_adk-0.8.1.dist-info → moai_adk-0.8.2.dist-info}/METADATA +226 -1
  71. {moai_adk-0.8.1.dist-info → moai_adk-0.8.2.dist-info}/RECORD +83 -50
  72. moai_adk/templates/.claude/hooks/alfred/HOOK_SCHEMA_VALIDATION.md +0 -313
  73. moai_adk/templates/.moai/memory/config-schema.md +0 -444
  74. moai_adk/templates/.moai/memory/gitflow-protection-policy.md +0 -220
  75. moai_adk/templates/.moai/memory/spec-metadata.md +0 -356
  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.2.dist-info}/WHEEL +0 -0
  86. {moai_adk-0.8.1.dist-info → moai_adk-0.8.2.dist-info}/entry_points.txt +0 -0
  87. {moai_adk-0.8.1.dist-info → moai_adk-0.8.2.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
 
@@ -154,6 +154,12 @@ All SPEC documents and analysis must be generated in conversation_language.
154
154
  - If conversation_language is 'ja' (Japanese): Generate ALL analysis, plans, and SPEC documents in Japanese
155
155
  - If conversation_language is other language: Follow the specified language
156
156
 
157
+ SKILL INVOCATION:
158
+ Use explicit Skill() calls when needed:
159
+ - Skill("moai-foundation-specs") for SPEC structure guidance
160
+ - Skill("moai-foundation-ears") for EARS syntax requirements
161
+ - Skill("moai-alfred-spec-metadata-validation") for metadata validation
162
+
157
163
  TASK:
158
164
  Please analyze the project document and suggest SPEC candidates.
159
165
  Run in analysis mode, and must include the following:
@@ -218,6 +224,13 @@ ALL SPEC documents MUST be generated in conversation_language:
218
224
  YAML frontmatter and @TAG identifiers MUST remain in English.
219
225
  Code examples and technical keywords can be mixed (code in English, narrative in user language).
220
226
 
227
+ SKILL INVOCATION:
228
+ Use explicit Skill() calls when needed:
229
+ - Skill("moai-foundation-specs") for SPEC structure guidance
230
+ - Skill("moai-foundation-ears") for EARS syntax requirements
231
+ - Skill("moai-alfred-spec-metadata-validation") for metadata validation
232
+ - Skill("moai-alfred-tag-scanning") for TAG chain references
233
+
221
234
  TASK:
222
235
  Please fill out the SPEC document according to the plan approved in STEP 1.
223
236
  Create a specification for the EARS structure."""
@@ -372,7 +385,7 @@ Only if the user selects **"Proceed"** or **"Start"** will Alfred call the spec-
372
385
  ### State-driven Requirements
373
386
  - When the WHILE token is in an unexpired state, the system must allow access to the protected resource.
374
387
 
375
- ### Constraints
388
+ ### Unwanted Behaviors
376
389
  - If the IF token has expired, the system must return a 401 Unauthorized response.
377
390
  ```
378
391
 
@@ -484,8 +497,8 @@ author: @username
484
497
  ### Optional (Optional function)
485
498
  - If WHERE [condition], the system can [operate]
486
499
 
487
- ### Constraints
488
- - IF [condition], the system must be [constrained]
500
+ ### Unwanted Behaviors
501
+ - IF [condition], the system must [respond appropriately with error handling or quality gates]
489
502
 
490
503
  ## Traceability (@TAG)
491
504
  - **SPEC**: @SPEC:AUTH-001
@@ -630,7 +643,7 @@ done
630
643
  **CodeRabbit review includes:**
631
644
  - ✅ YAML frontmatter validation (7 required fields)
632
645
  - ✅ HISTORY section structure and completeness
633
- - ✅ EARS requirements clarity (Ubiquitous/Event/State/Optional/Constraints)
646
+ - ✅ EARS requirements clarity (Ubiquitous/Event-driven/State-driven/Optional/Unwanted Behaviors)
634
647
  - ✅ Acceptance criteria quality (Given-When-Then scenarios)
635
648
  - ✅ @TAG system compliance (SPEC/TEST/CODE/DOC traceability)
636
649
  - ✅ Documentation and formatting
@@ -202,6 +202,13 @@ Code and technical output MUST be in English.
202
202
  Code comments MAY be in {{CONVERSATION_LANGUAGE}} if appropriate.
203
203
  Test descriptions and documentation can use {{CONVERSATION_LANGUAGE}}.
204
204
 
205
+ SKILL INVOCATION:
206
+ Use explicit Skill() calls when needed:
207
+ - Skill("moai-alfred-language-detection") for project language detection
208
+ - Skill("moai-lang-python") or language-specific Skills for best practices
209
+ - Skill("moai-essentials-debug") when tests fail
210
+ - Skill("moai-essentials-refactor") during REFACTOR phase
211
+
205
212
  TASK: Execute the task according to the plan approved in STEP 1.
206
213
 
207
214
  For TDD scenario:
@@ -175,6 +175,12 @@ Documentation updates MUST respect conversation_language:
175
175
  - Code comments: {{CONVERSATION_LANGUAGE}} (when not technical keywords)
176
176
  - Technical documentation and YAML frontmatter: English
177
177
 
178
+ SKILL INVOCATION:
179
+ Use explicit Skill() calls when needed:
180
+ - Skill("moai-foundation-tags") for TAG chain validation
181
+ - Skill("moai-foundation-trust") for quality gate checks
182
+ - Skill("moai-alfred-tag-scanning") for TAG inventory updates
183
+
178
184
  TASK:
179
185
  Please analyze Git changes and establish a document synchronization plan.
180
186
  Ensure all documentation updates align with the conversation_language setting.
@@ -0,0 +1,9 @@
1
+ {
2
+ "current": "0.8.1",
3
+ "latest": "0.8.1",
4
+ "update_available": false,
5
+ "upgrade_command": "",
6
+ "release_notes_url": "https://github.com/modu-ai/moai-adk/releases",
7
+ "is_major_update": false,
8
+ "last_check": "2025-10-29T08:52:11.240503+00:00"
9
+ }