moai-adk 0.4.4__py3-none-any.whl → 0.4.7__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 (191) hide show
  1. moai_adk/__init__.py +1 -1
  2. moai_adk/core/project/initializer.py +12 -5
  3. moai_adk/templates/.claude/agents/alfred/skill-factory.md +829 -0
  4. moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/SKILL.md +78 -77
  5. moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/examples.md +29 -0
  6. moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/reference.md +28 -0
  7. moai_adk/templates/.claude/skills/moai-alfred-debugger-pro/SKILL.md +87 -77
  8. moai_adk/templates/.claude/skills/moai-alfred-debugger-pro/examples.md +29 -0
  9. moai_adk/templates/.claude/skills/moai-alfred-debugger-pro/reference.md +28 -0
  10. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/SKILL.md +76 -66
  11. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/examples.md +29 -0
  12. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/reference.md +28 -0
  13. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/SKILL.md +86 -59
  14. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/examples.md +29 -0
  15. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/reference.md +29 -0
  16. moai_adk/templates/.claude/skills/moai-alfred-language-detection/SKILL.md +87 -73
  17. moai_adk/templates/.claude/skills/moai-alfred-language-detection/examples.md +29 -0
  18. moai_adk/templates/.claude/skills/moai-alfred-language-detection/reference.md +28 -0
  19. moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/SKILL.md +87 -79
  20. moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/examples.md +29 -0
  21. moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/reference.md +28 -0
  22. moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/SKILL.md +87 -71
  23. moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/examples.md +29 -0
  24. moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/reference.md +28 -0
  25. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/SKILL.md +78 -62
  26. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/examples.md +29 -0
  27. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/reference.md +28 -0
  28. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/SKILL.md +78 -55
  29. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/examples.md +29 -0
  30. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/reference.md +28 -0
  31. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/SKILL.md +78 -64
  32. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/examples.md +29 -0
  33. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/reference.md +28 -0
  34. moai_adk/templates/.claude/skills/moai-alfred-tui-survey/SKILL.md +604 -56
  35. moai_adk/templates/.claude/skills/moai-alfred-tui-survey/examples.md +974 -44
  36. moai_adk/templates/.claude/skills/moai-alfred-tui-survey/reference.md +801 -0
  37. moai_adk/templates/.claude/skills/moai-claude-code/SKILL.md +88 -61
  38. moai_adk/templates/.claude/skills/moai-claude-code/examples.md +16 -500
  39. moai_adk/templates/.claude/skills/moai-claude-code/reference.md +15 -420
  40. moai_adk/templates/.claude/skills/moai-domain-backend/SKILL.md +234 -43
  41. moai_adk/templates/.claude/skills/moai-domain-backend/examples.md +1633 -0
  42. moai_adk/templates/.claude/skills/moai-domain-backend/reference.md +660 -0
  43. moai_adk/templates/.claude/skills/moai-domain-cli-tool/SKILL.md +97 -69
  44. moai_adk/templates/.claude/skills/moai-domain-cli-tool/examples.md +29 -0
  45. moai_adk/templates/.claude/skills/moai-domain-cli-tool/reference.md +30 -0
  46. moai_adk/templates/.claude/skills/moai-domain-data-science/SKILL.md +97 -72
  47. moai_adk/templates/.claude/skills/moai-domain-data-science/examples.md +29 -0
  48. moai_adk/templates/.claude/skills/moai-domain-data-science/reference.md +30 -0
  49. moai_adk/templates/.claude/skills/moai-domain-database/SKILL.md +97 -74
  50. moai_adk/templates/.claude/skills/moai-domain-database/examples.md +29 -0
  51. moai_adk/templates/.claude/skills/moai-domain-database/reference.md +30 -0
  52. moai_adk/templates/.claude/skills/moai-domain-devops/SKILL.md +98 -74
  53. moai_adk/templates/.claude/skills/moai-domain-devops/examples.md +29 -0
  54. moai_adk/templates/.claude/skills/moai-domain-devops/reference.md +31 -0
  55. moai_adk/templates/.claude/skills/moai-domain-frontend/SKILL.md +98 -73
  56. moai_adk/templates/.claude/skills/moai-domain-frontend/examples.md +29 -0
  57. moai_adk/templates/.claude/skills/moai-domain-frontend/reference.md +31 -0
  58. moai_adk/templates/.claude/skills/moai-domain-ml/SKILL.md +97 -73
  59. moai_adk/templates/.claude/skills/moai-domain-ml/examples.md +29 -0
  60. moai_adk/templates/.claude/skills/moai-domain-ml/reference.md +30 -0
  61. moai_adk/templates/.claude/skills/moai-domain-mobile-app/SKILL.md +97 -67
  62. moai_adk/templates/.claude/skills/moai-domain-mobile-app/examples.md +29 -0
  63. moai_adk/templates/.claude/skills/moai-domain-mobile-app/reference.md +30 -0
  64. moai_adk/templates/.claude/skills/moai-domain-security/SKILL.md +97 -79
  65. moai_adk/templates/.claude/skills/moai-domain-security/examples.md +29 -0
  66. moai_adk/templates/.claude/skills/moai-domain-security/reference.md +30 -0
  67. moai_adk/templates/.claude/skills/moai-domain-web-api/SKILL.md +97 -71
  68. moai_adk/templates/.claude/skills/moai-domain-web-api/examples.md +29 -0
  69. moai_adk/templates/.claude/skills/moai-domain-web-api/reference.md +30 -0
  70. moai_adk/templates/.claude/skills/moai-essentials-debug/SKILL.md +656 -60
  71. moai_adk/templates/.claude/skills/moai-essentials-debug/examples.md +1107 -0
  72. moai_adk/templates/.claude/skills/moai-essentials-debug/reference.md +1533 -0
  73. moai_adk/templates/.claude/skills/moai-essentials-perf/SKILL.md +87 -78
  74. moai_adk/templates/.claude/skills/moai-essentials-perf/examples.md +29 -0
  75. moai_adk/templates/.claude/skills/moai-essentials-perf/reference.md +28 -0
  76. moai_adk/templates/.claude/skills/moai-essentials-refactor/SKILL.md +87 -70
  77. moai_adk/templates/.claude/skills/moai-essentials-refactor/examples.md +29 -0
  78. moai_adk/templates/.claude/skills/moai-essentials-refactor/reference.md +28 -0
  79. moai_adk/templates/.claude/skills/moai-essentials-review/SKILL.md +87 -86
  80. moai_adk/templates/.claude/skills/moai-essentials-review/examples.md +29 -0
  81. moai_adk/templates/.claude/skills/moai-essentials-review/reference.md +28 -0
  82. moai_adk/templates/.claude/skills/moai-foundation-ears/SKILL.md +77 -62
  83. moai_adk/templates/.claude/skills/moai-foundation-ears/examples.md +29 -0
  84. moai_adk/templates/.claude/skills/moai-foundation-ears/reference.md +28 -0
  85. moai_adk/templates/.claude/skills/moai-foundation-git/SKILL.md +88 -56
  86. moai_adk/templates/.claude/skills/moai-foundation-git/examples.md +29 -0
  87. moai_adk/templates/.claude/skills/moai-foundation-git/reference.md +29 -0
  88. moai_adk/templates/.claude/skills/moai-foundation-langs/SKILL.md +90 -71
  89. moai_adk/templates/.claude/skills/moai-foundation-langs/examples.md +29 -0
  90. moai_adk/templates/.claude/skills/moai-foundation-langs/reference.md +28 -0
  91. moai_adk/templates/.claude/skills/moai-foundation-specs/SKILL.md +78 -58
  92. moai_adk/templates/.claude/skills/moai-foundation-specs/examples.md +29 -0
  93. moai_adk/templates/.claude/skills/moai-foundation-specs/reference.md +28 -0
  94. moai_adk/templates/.claude/skills/moai-foundation-tags/SKILL.md +78 -51
  95. moai_adk/templates/.claude/skills/moai-foundation-tags/examples.md +29 -0
  96. moai_adk/templates/.claude/skills/moai-foundation-tags/reference.md +28 -0
  97. moai_adk/templates/.claude/skills/moai-foundation-trust/SKILL.md +253 -32
  98. moai_adk/templates/.claude/skills/moai-foundation-trust/examples.md +0 -0
  99. moai_adk/templates/.claude/skills/moai-foundation-trust/reference.md +1099 -0
  100. moai_adk/templates/.claude/skills/moai-lang-c/SKILL.md +98 -74
  101. moai_adk/templates/.claude/skills/moai-lang-c/examples.md +29 -0
  102. moai_adk/templates/.claude/skills/moai-lang-c/reference.md +31 -0
  103. moai_adk/templates/.claude/skills/moai-lang-clojure/SKILL.md +97 -74
  104. moai_adk/templates/.claude/skills/moai-lang-clojure/examples.md +29 -0
  105. moai_adk/templates/.claude/skills/moai-lang-clojure/reference.md +30 -0
  106. moai_adk/templates/.claude/skills/moai-lang-cpp/SKILL.md +98 -76
  107. moai_adk/templates/.claude/skills/moai-lang-cpp/examples.md +29 -0
  108. moai_adk/templates/.claude/skills/moai-lang-cpp/reference.md +31 -0
  109. moai_adk/templates/.claude/skills/moai-lang-csharp/SKILL.md +97 -74
  110. moai_adk/templates/.claude/skills/moai-lang-csharp/examples.md +29 -0
  111. moai_adk/templates/.claude/skills/moai-lang-csharp/reference.md +30 -0
  112. moai_adk/templates/.claude/skills/moai-lang-dart/SKILL.md +86 -61
  113. moai_adk/templates/.claude/skills/moai-lang-dart/examples.md +29 -0
  114. moai_adk/templates/.claude/skills/moai-lang-dart/reference.md +30 -0
  115. moai_adk/templates/.claude/skills/moai-lang-elixir/SKILL.md +98 -73
  116. moai_adk/templates/.claude/skills/moai-lang-elixir/examples.md +29 -0
  117. moai_adk/templates/.claude/skills/moai-lang-elixir/reference.md +31 -0
  118. moai_adk/templates/.claude/skills/moai-lang-go/SKILL.md +98 -74
  119. moai_adk/templates/.claude/skills/moai-lang-go/examples.md +29 -0
  120. moai_adk/templates/.claude/skills/moai-lang-go/reference.md +31 -0
  121. moai_adk/templates/.claude/skills/moai-lang-haskell/SKILL.md +98 -74
  122. moai_adk/templates/.claude/skills/moai-lang-haskell/examples.md +29 -0
  123. moai_adk/templates/.claude/skills/moai-lang-haskell/reference.md +31 -0
  124. moai_adk/templates/.claude/skills/moai-lang-java/SKILL.md +87 -61
  125. moai_adk/templates/.claude/skills/moai-lang-java/examples.md +29 -0
  126. moai_adk/templates/.claude/skills/moai-lang-java/reference.md +31 -0
  127. moai_adk/templates/.claude/skills/moai-lang-javascript/SKILL.md +88 -59
  128. moai_adk/templates/.claude/skills/moai-lang-javascript/examples.md +29 -0
  129. moai_adk/templates/.claude/skills/moai-lang-javascript/reference.md +32 -0
  130. moai_adk/templates/.claude/skills/moai-lang-julia/SKILL.md +86 -61
  131. moai_adk/templates/.claude/skills/moai-lang-julia/examples.md +29 -0
  132. moai_adk/templates/.claude/skills/moai-lang-julia/reference.md +30 -0
  133. moai_adk/templates/.claude/skills/moai-lang-kotlin/SKILL.md +98 -73
  134. moai_adk/templates/.claude/skills/moai-lang-kotlin/examples.md +29 -0
  135. moai_adk/templates/.claude/skills/moai-lang-kotlin/reference.md +31 -0
  136. moai_adk/templates/.claude/skills/moai-lang-lua/SKILL.md +86 -61
  137. moai_adk/templates/.claude/skills/moai-lang-lua/examples.md +29 -0
  138. moai_adk/templates/.claude/skills/moai-lang-lua/reference.md +30 -0
  139. moai_adk/templates/.claude/skills/moai-lang-php/SKILL.md +86 -61
  140. moai_adk/templates/.claude/skills/moai-lang-php/examples.md +29 -0
  141. moai_adk/templates/.claude/skills/moai-lang-php/reference.md +30 -0
  142. moai_adk/templates/.claude/skills/moai-lang-python/SKILL.md +388 -53
  143. moai_adk/templates/.claude/skills/moai-lang-python/examples.md +624 -0
  144. moai_adk/templates/.claude/skills/moai-lang-python/reference.md +316 -0
  145. moai_adk/templates/.claude/skills/moai-lang-r/SKILL.md +97 -73
  146. moai_adk/templates/.claude/skills/moai-lang-r/examples.md +29 -0
  147. moai_adk/templates/.claude/skills/moai-lang-r/reference.md +30 -0
  148. moai_adk/templates/.claude/skills/moai-lang-ruby/SKILL.md +98 -73
  149. moai_adk/templates/.claude/skills/moai-lang-ruby/examples.md +29 -0
  150. moai_adk/templates/.claude/skills/moai-lang-ruby/reference.md +31 -0
  151. moai_adk/templates/.claude/skills/moai-lang-rust/SKILL.md +98 -74
  152. moai_adk/templates/.claude/skills/moai-lang-rust/examples.md +29 -0
  153. moai_adk/templates/.claude/skills/moai-lang-rust/reference.md +31 -0
  154. moai_adk/templates/.claude/skills/moai-lang-scala/SKILL.md +97 -74
  155. moai_adk/templates/.claude/skills/moai-lang-scala/examples.md +29 -0
  156. moai_adk/templates/.claude/skills/moai-lang-scala/reference.md +30 -0
  157. moai_adk/templates/.claude/skills/moai-lang-shell/SKILL.md +97 -74
  158. moai_adk/templates/.claude/skills/moai-lang-shell/examples.md +29 -0
  159. moai_adk/templates/.claude/skills/moai-lang-shell/reference.md +30 -0
  160. moai_adk/templates/.claude/skills/moai-lang-sql/SKILL.md +98 -74
  161. moai_adk/templates/.claude/skills/moai-lang-sql/examples.md +29 -0
  162. moai_adk/templates/.claude/skills/moai-lang-sql/reference.md +31 -0
  163. moai_adk/templates/.claude/skills/moai-lang-swift/SKILL.md +97 -73
  164. moai_adk/templates/.claude/skills/moai-lang-swift/examples.md +29 -0
  165. moai_adk/templates/.claude/skills/moai-lang-swift/reference.md +30 -0
  166. moai_adk/templates/.claude/skills/moai-lang-typescript/SKILL.md +90 -59
  167. moai_adk/templates/.claude/skills/moai-lang-typescript/examples.md +29 -0
  168. moai_adk/templates/.claude/skills/moai-lang-typescript/reference.md +34 -0
  169. moai_adk/templates/.claude/skills/moai-skill-factory/CHECKLIST.md +482 -0
  170. moai_adk/templates/.claude/skills/moai-skill-factory/EXAMPLES.md +52 -0
  171. moai_adk/templates/.claude/skills/moai-skill-factory/INTERACTIVE-DISCOVERY.md +524 -0
  172. moai_adk/templates/.claude/skills/moai-skill-factory/METADATA.md +477 -0
  173. moai_adk/templates/.claude/skills/moai-skill-factory/SKILL-UPDATE-ADVISOR.md +577 -0
  174. moai_adk/templates/.claude/skills/moai-skill-factory/SKILL.md +560 -0
  175. moai_adk/templates/.claude/skills/moai-skill-factory/STRUCTURE.md +583 -0
  176. moai_adk/templates/.claude/skills/moai-skill-factory/WEB-RESEARCH.md +526 -0
  177. moai_adk/templates/.claude/skills/moai-skill-factory/reference.md +69 -0
  178. moai_adk/templates/.claude/skills/moai-skill-factory/scripts/generate-structure.sh +328 -0
  179. moai_adk/templates/.claude/skills/moai-skill-factory/scripts/validate-skill.sh +312 -0
  180. moai_adk/templates/.claude/skills/moai-skill-factory/templates/SKILL_TEMPLATE.md +245 -0
  181. moai_adk/templates/.claude/skills/moai-skill-factory/templates/examples-template.md +285 -0
  182. moai_adk/templates/.claude/skills/moai-skill-factory/templates/reference-template.md +278 -0
  183. moai_adk/templates/.claude/skills/moai-skill-factory/templates/scripts-template.sh +303 -0
  184. moai_adk/templates/CLAUDE.md +43 -11
  185. moai_adk-0.4.7.dist-info/METADATA +1162 -0
  186. moai_adk-0.4.7.dist-info/RECORD +275 -0
  187. moai_adk-0.4.4.dist-info/METADATA +0 -369
  188. moai_adk-0.4.4.dist-info/RECORD +0 -152
  189. {moai_adk-0.4.4.dist-info → moai_adk-0.4.7.dist-info}/WHEEL +0 -0
  190. {moai_adk-0.4.4.dist-info → moai_adk-0.4.7.dist-info}/entry_points.txt +0 -0
  191. {moai_adk-0.4.4.dist-info → moai_adk-0.4.7.dist-info}/licenses/LICENSE +0 -0
@@ -1,98 +1,123 @@
1
1
  ---
2
-
3
2
  name: moai-lang-julia
4
- description: Julia best practices with Test stdlib, Pkg manager, and scientific computing patterns. Use when writing or reviewing Julia code in project workflows.
3
+ version: 2.0.0
4
+ created: 2025-10-22
5
+ updated: 2025-10-22
6
+ status: active
7
+ description: Julia 1.11+ best practices with Test stdlib, Pkg manager, and scientific computing patterns.
8
+ keywords: ['julia', 'test', 'pkg', 'scientific']
5
9
  allowed-tools:
6
10
  - Read
7
11
  - Bash
8
12
  ---
9
13
 
10
- # Julia Expert
14
+ # Lang Julia Skill
11
15
 
12
16
  ## Skill Metadata
17
+
13
18
  | Field | Value |
14
19
  | ----- | ----- |
15
- | Allowed tools | Read (read_file), Bash (terminal) |
16
- | Auto-load | On demand when language keywords are detected |
17
- | Trigger cues | Julia code discussions, framework guidance, or file extensions such as .jl. |
18
- | Tier | 3 |
20
+ | **Skill Name** | moai-lang-julia |
21
+ | **Version** | 2.0.0 (2025-10-22) |
22
+ | **Allowed tools** | Read (read_file), Bash (terminal) |
23
+ | **Auto-load** | On demand when keywords detected |
24
+ | **Tier** | Language |
19
25
 
20
- ## What it does
26
+ ---
21
27
 
22
- Provides Julia-specific expertise for TDD development, including Test standard library, Pkg package manager, and high-performance scientific computing patterns.
28
+ ## What It Does
23
29
 
24
- ## When to use
30
+ Julia 1.11+ best practices with Test stdlib, Pkg manager, and scientific computing patterns.
25
31
 
26
- - Engages when the conversation references Julia work, frameworks, or files like .jl.
27
- - "Writing Julia tests", "How to use Test stdlib", "Scientific computing"
28
- - Automatically invoked when working with Julia projects
29
- - Julia SPEC implementation (`/alfred:2-run`)
32
+ **Key capabilities**:
33
+ - Best practices enforcement for language domain
34
+ - TRUST 5 principles integration
35
+ - Latest tool versions (2025-10-22)
36
+ - ✅ TDD workflow support
30
37
 
31
- ## How it works
38
+ ---
32
39
 
33
- **TDD Framework**:
34
- - **Test**: Built-in testing library (@test, @testset)
35
- - **Coverage.jl**: Test coverage analysis
36
- - **BenchmarkTools.jl**: Performance benchmarking
40
+ ## When to Use
37
41
 
38
- **Package Management**:
39
- - **Pkg**: Built-in package manager
40
- - **Project.toml**: Package configuration
41
- - **Manifest.toml**: Dependency lock file
42
+ **Automatic triggers**:
43
+ - Related code discussions and file patterns
44
+ - SPEC implementation (`/alfred:2-run`)
45
+ - Code review requests
42
46
 
43
- **Code Quality**:
44
- - **JuliaFormatter.jl**: Code formatting
45
- - **Lint.jl**: Static analysis
46
- - **JET.jl**: Type inference analysis
47
+ **Manual invocation**:
48
+ - Review code for TRUST 5 compliance
49
+ - Design new features
50
+ - Troubleshoot issues
47
51
 
48
- **Scientific Computing**:
49
- - **Multiple dispatch**: Method specialization on argument types
50
- - **Type stability**: Performance optimization
51
- - **Broadcasting**: Element-wise operations (. syntax)
52
- - **Linear algebra**: Built-in BLAS/LAPACK
52
+ ---
53
53
 
54
- **Best Practices**:
55
- - File ≤300 LOC, function ≤50 LOC
56
- - Type annotations for performance-critical code
57
- - Prefer abstract types for function arguments
58
- - Use @inbounds for performance (after bounds checking)
59
- - Profile before optimizing
54
+ ## Tool Version Matrix (2025-10-22)
60
55
 
61
- ## Examples
62
- ```bash
63
- julia --project -e 'using Pkg; Pkg.test()'
64
- ```
56
+ | Tool | Version | Purpose | Status |
57
+ |------|---------|---------|--------|
58
+ | **Julia** | 1.11.0 | Primary | ✅ Current |
59
+ | **Test.jl** | 1.11.0 | Primary | ✅ Current |
60
+ | **Pkg.jl** | 1.11.0 | Primary | ✅ Current |
61
+
62
+ ---
65
63
 
66
64
  ## Inputs
67
- - Language-specific source directories (e.g. `src/`, `app/`).
68
- - Language-specific build/test configuration files (e.g. `package.json`, `pyproject.toml`, `go.mod`).
69
- - Relevant test suites and sample data.
65
+
66
+ - Language-specific source directories
67
+ - Configuration files
68
+ - Test suites and sample data
70
69
 
71
70
  ## Outputs
72
- - Test/lint execution plan tailored to the selected language.
73
- - List of key language idioms and review checkpoints.
71
+
72
+ - Test/lint execution plan
73
+ - TRUST 5 review checkpoints
74
+ - Migration guidance
74
75
 
75
76
  ## Failure Modes
76
- - When the language runtime or package manager is not installed.
77
- - When the main language cannot be determined in a multilingual project.
77
+
78
+ - When required tools are not installed
79
+ - When dependencies are missing
80
+ - When test coverage falls below 85%
78
81
 
79
82
  ## Dependencies
80
- - Access to the project file is required using the Read/Grep tool.
81
- - When used with `Skill("moai-foundation-langs")`, it is easy to share cross-language conventions.
82
83
 
83
- ## References
84
- - Julia Language. "Documentation." https://docs.julialang.org/en/v1/ (accessed 2025-03-29).
85
- - JuliaFormatter.jl. "JuliaFormatter Documentation." https://domluna.github.io/JuliaFormatter.jl/stable/ (accessed 2025-03-29).
84
+ - Access to project files via Read/Bash tools
85
+ - Integration with `moai-foundation-langs` for language detection
86
+ - Integration with `moai-foundation-trust` for quality gates
87
+
88
+ ---
89
+
90
+ ## References (Latest Documentation)
91
+
92
+ _Documentation links updated 2025-10-22_
93
+
94
+ ---
86
95
 
87
96
  ## Changelog
88
- - 2025-03-29: Input/output/failure response/reference information for each language has been specified.
89
97
 
90
- ## Works well with
98
+ - **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
99
+ - **v1.0.0** (2025-03-29): Initial Skill release
91
100
 
92
- - alfred-trust-validation (coverage verification)
93
- - alfred-code-reviewer (Julia-specific review)
94
- - alfred-performance-optimizer (Julia profiling)
101
+ ---
102
+
103
+ ## Works Well With
104
+
105
+ - `moai-foundation-trust` (quality gates)
106
+ - `moai-alfred-code-reviewer` (code review)
107
+ - `moai-essentials-debug` (debugging support)
108
+
109
+ ---
95
110
 
96
111
  ## Best Practices
97
- - Enable automatic validation by matching your linter with the language's official style guide.
98
- - Fix test/build pipelines with reproducible commands in CI.
112
+
113
+ **DO**:
114
+ - Follow language best practices
115
+ - Use latest stable tool versions
116
+ - Maintain test coverage ≥85%
117
+ - Document all public APIs
118
+
119
+ ❌ **DON'T**:
120
+ - Skip quality gates
121
+ - Use deprecated tools
122
+ - Ignore security warnings
123
+ - Mix testing frameworks
@@ -0,0 +1,29 @@
1
+ # moai-lang-julia - Working Examples
2
+
3
+ _Last updated: 2025-10-22_
4
+
5
+ ## Example 1: Basic Setup
6
+
7
+ ```bash
8
+ # Setup commands
9
+ # ...
10
+ ```
11
+
12
+ ## Example 2: TDD Workflow
13
+
14
+ ```bash
15
+ # RED: Write failing test
16
+ # GREEN: Implement feature
17
+ # REFACTOR: Improve code
18
+ ```
19
+
20
+ ## Example 3: Quality Gate
21
+
22
+ ```bash
23
+ # Run quality checks
24
+ # Verify coverage ≥85%
25
+ ```
26
+
27
+ ---
28
+
29
+ _For more examples, see SKILL.md reference section_
@@ -0,0 +1,30 @@
1
+ # moai-lang-julia - CLI Reference
2
+
3
+ _Last updated: 2025-10-22_
4
+
5
+ ## Quick Reference
6
+
7
+ ### Installation
8
+
9
+ ```bash
10
+ # Installation commands
11
+ ```
12
+
13
+ ### Common Commands
14
+
15
+ ```bash
16
+ # Test
17
+ # Lint
18
+ # Format
19
+ # Build
20
+ ```
21
+
22
+ ## Tool Versions (2025-10-22)
23
+
24
+ - **Julia**: 1.11.0
25
+ - **Test.jl**: 1.11.0
26
+ - **Pkg.jl**: 1.11.0
27
+
28
+ ---
29
+
30
+ _For detailed usage, see SKILL.md_
@@ -1,99 +1,124 @@
1
1
  ---
2
-
3
2
  name: moai-lang-kotlin
4
- description: Kotlin best practices with JUnit, Gradle, ktlint, coroutines, and extension functions. Use when writing or reviewing Kotlin code in project workflows.
3
+ version: 2.0.0
4
+ created: 2025-10-22
5
+ updated: 2025-10-22
6
+ status: active
7
+ description: Kotlin 2.1+ best practices with JUnit 5, Gradle, ktlint, coroutines, and extension functions.
8
+ keywords: ['kotlin', 'junit', 'gradle', 'ktlint', 'coroutines']
5
9
  allowed-tools:
6
10
  - Read
7
11
  - Bash
8
12
  ---
9
13
 
10
- # Kotlin Expert
14
+ # Lang Kotlin Skill
11
15
 
12
16
  ## Skill Metadata
17
+
13
18
  | Field | Value |
14
19
  | ----- | ----- |
15
- | Allowed tools | Read (read_file), Bash (terminal) |
16
- | Auto-load | On demand when language keywords are detected |
17
- | Trigger cues | Kotlin code discussions, framework guidance, or file extensions such as .kt/.kts. |
18
- | Tier | 3 |
19
-
20
- ## What it does
21
-
22
- Provides Kotlin-specific expertise for TDD development, including JUnit testing, Gradle build system, ktlint linting, coroutines for concurrency, and extension functions.
23
-
24
- ## When to use
25
-
26
- - Engages when the conversation references Kotlin work, frameworks, or files like .kt/.kts.
27
- - “Writing Kotlin tests”, “How to use coroutines”, “Android patterns”
28
- - Automatically invoked when working with Kotlin/Android projects
29
- - Kotlin SPEC implementation (`/alfred:2-run`)
30
-
31
- ## How it works
32
-
33
- **TDD Framework**:
34
- - **JUnit 5**: Unit testing with Kotlin extensions
35
- - **MockK**: Kotlin-friendly mocking library
36
- - **Kotest**: Kotlin-native testing framework
37
- - Test coverage ≥85% with JaCoCo
38
-
39
- **Build Tools**:
40
- - **Gradle**: build.gradle.kts with Kotlin DSL
41
- - **Maven**: pom.xml alternative
42
- - Multi-platform support (JVM, Native, JS)
43
-
44
- **Code Quality**:
45
- - **ktlint**: Kotlin linter with formatting
46
- - **detekt**: Static code analysis
47
- - **Android Lint**: Android-specific checks
48
-
49
- **Kotlin Features**:
50
- - **Coroutines**: Async programming with suspend functions
51
- - **Extension functions**: Add methods to existing classes
52
- - **Data classes**: Automatic equals/hashCode/toString
53
- - **Null safety**: Non-nullable types by default
54
- - **Smart casts**: Automatic type casting after checks
55
-
56
- **Android Patterns**:
57
- - **Jetpack Compose**: Declarative UI
58
- - **ViewModel**: UI state management
59
- - **Room**: Database abstraction
60
- - **Retrofit**: Network requests
61
-
62
- ## Examples
63
- ```bash
64
- ./gradlew test && ./gradlew ktlintCheck
65
- ```
20
+ | **Skill Name** | moai-lang-kotlin |
21
+ | **Version** | 2.0.0 (2025-10-22) |
22
+ | **Allowed tools** | Read (read_file), Bash (terminal) |
23
+ | **Auto-load** | On demand when keywords detected |
24
+ | **Tier** | Language |
25
+
26
+ ---
27
+
28
+ ## What It Does
29
+
30
+ Kotlin 2.1+ best practices with JUnit 5, Gradle, ktlint, coroutines, and extension functions.
31
+
32
+ **Key capabilities**:
33
+ - Best practices enforcement for language domain
34
+ - TRUST 5 principles integration
35
+ - ✅ Latest tool versions (2025-10-22)
36
+ - TDD workflow support
37
+
38
+ ---
39
+
40
+ ## When to Use
41
+
42
+ **Automatic triggers**:
43
+ - Related code discussions and file patterns
44
+ - SPEC implementation (`/alfred:2-run`)
45
+ - Code review requests
46
+
47
+ **Manual invocation**:
48
+ - Review code for TRUST 5 compliance
49
+ - Design new features
50
+ - Troubleshoot issues
51
+
52
+ ---
53
+
54
+ ## Tool Version Matrix (2025-10-22)
55
+
56
+ | Tool | Version | Purpose | Status |
57
+ |------|---------|---------|--------|
58
+ | **Kotlin** | 2.1.0 | Primary | ✅ Current |
59
+ | **JUnit** | 5.11.0 | Primary | ✅ Current |
60
+ | **Gradle** | 8.12.0 | Primary | ✅ Current |
61
+ | **ktlint** | 1.5.0 | Primary | ✅ Current |
62
+
63
+ ---
66
64
 
67
65
  ## Inputs
68
- - Language-specific source directories (e.g. `src/`, `app/`).
69
- - Language-specific build/test configuration files (e.g. `package.json`, `pyproject.toml`, `go.mod`).
70
- - Relevant test suites and sample data.
66
+
67
+ - Language-specific source directories
68
+ - Configuration files
69
+ - Test suites and sample data
71
70
 
72
71
  ## Outputs
73
- - Test/lint execution plan tailored to the selected language.
74
- - List of key language idioms and review checkpoints.
72
+
73
+ - Test/lint execution plan
74
+ - TRUST 5 review checkpoints
75
+ - Migration guidance
75
76
 
76
77
  ## Failure Modes
77
- - When the language runtime or package manager is not installed.
78
- - When the main language cannot be determined in a multilingual project.
78
+
79
+ - When required tools are not installed
80
+ - When dependencies are missing
81
+ - When test coverage falls below 85%
79
82
 
80
83
  ## Dependencies
81
- - Access to the project file is required using the Read/Grep tool.
82
- - When used with `Skill("moai-foundation-langs")`, it is easy to share cross-language conventions.
83
84
 
84
- ## References
85
- - JetBrains. "Kotlin Language Documentation." https://kotlinlang.org/docs/home.html (accessed 2025-03-29).
86
- - Pinterest. "ktlint." https://pinterest.github.io/ktlint/ (accessed 2025-03-29).
85
+ - Access to project files via Read/Bash tools
86
+ - Integration with `moai-foundation-langs` for language detection
87
+ - Integration with `moai-foundation-trust` for quality gates
88
+
89
+ ---
90
+
91
+ ## References (Latest Documentation)
92
+
93
+ _Documentation links updated 2025-10-22_
94
+
95
+ ---
87
96
 
88
97
  ## Changelog
89
- - 2025-03-29: Input/output/failure response/reference information for each language has been specified.
90
98
 
91
- ## Works well with
99
+ - **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
100
+ - **v1.0.0** (2025-03-29): Initial Skill release
101
+
102
+ ---
103
+
104
+ ## Works Well With
105
+
106
+ - `moai-foundation-trust` (quality gates)
107
+ - `moai-alfred-code-reviewer` (code review)
108
+ - `moai-essentials-debug` (debugging support)
92
109
 
93
- - alfred-trust-validation (coverage verification)
94
- - alfred-code-reviewer (Kotlin-specific review)
95
- - mobile-app-expert (Android app development)
110
+ ---
96
111
 
97
112
  ## Best Practices
98
- - Enable automatic validation by matching your linter with the language's official style guide.
99
- - Fix test/build pipelines with reproducible commands in CI.
113
+
114
+ **DO**:
115
+ - Follow language best practices
116
+ - Use latest stable tool versions
117
+ - Maintain test coverage ≥85%
118
+ - Document all public APIs
119
+
120
+ ❌ **DON'T**:
121
+ - Skip quality gates
122
+ - Use deprecated tools
123
+ - Ignore security warnings
124
+ - Mix testing frameworks
@@ -0,0 +1,29 @@
1
+ # moai-lang-kotlin - Working Examples
2
+
3
+ _Last updated: 2025-10-22_
4
+
5
+ ## Example 1: Basic Setup
6
+
7
+ ```bash
8
+ # Setup commands
9
+ # ...
10
+ ```
11
+
12
+ ## Example 2: TDD Workflow
13
+
14
+ ```bash
15
+ # RED: Write failing test
16
+ # GREEN: Implement feature
17
+ # REFACTOR: Improve code
18
+ ```
19
+
20
+ ## Example 3: Quality Gate
21
+
22
+ ```bash
23
+ # Run quality checks
24
+ # Verify coverage ≥85%
25
+ ```
26
+
27
+ ---
28
+
29
+ _For more examples, see SKILL.md reference section_
@@ -0,0 +1,31 @@
1
+ # moai-lang-kotlin - CLI Reference
2
+
3
+ _Last updated: 2025-10-22_
4
+
5
+ ## Quick Reference
6
+
7
+ ### Installation
8
+
9
+ ```bash
10
+ # Installation commands
11
+ ```
12
+
13
+ ### Common Commands
14
+
15
+ ```bash
16
+ # Test
17
+ # Lint
18
+ # Format
19
+ # Build
20
+ ```
21
+
22
+ ## Tool Versions (2025-10-22)
23
+
24
+ - **Kotlin**: 2.1.0
25
+ - **JUnit**: 5.11.0
26
+ - **Gradle**: 8.12.0
27
+ - **ktlint**: 1.5.0
28
+
29
+ ---
30
+
31
+ _For detailed usage, see SKILL.md_