moai-adk 0.4.5__py3-none-any.whl → 0.20.1__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 (433) hide show
  1. moai_adk/__init__.py +1 -1
  2. moai_adk/__main__.py +74 -1
  3. moai_adk/cli/commands/__init__.py +1 -1
  4. moai_adk/cli/commands/analyze.py +119 -0
  5. moai_adk/cli/commands/backup.py +25 -1
  6. moai_adk/cli/commands/doctor.py +31 -5
  7. moai_adk/cli/commands/improve_user_experience.py +307 -0
  8. moai_adk/cli/commands/init.py +111 -10
  9. moai_adk/cli/commands/status.py +33 -3
  10. moai_adk/cli/commands/update.py +921 -130
  11. moai_adk/cli/commands/validate_links.py +120 -0
  12. moai_adk/cli/prompts/init_prompts.py +22 -87
  13. moai_adk/core/analysis/__init__.py +9 -0
  14. moai_adk/core/analysis/session_analyzer.py +388 -0
  15. moai_adk/core/analysis/tag_chain_analyzer.py +344 -0
  16. moai_adk/core/analysis/tag_chain_repair.py +879 -0
  17. moai_adk/core/config/__init__.py +19 -0
  18. moai_adk/core/config/migration.py +235 -0
  19. moai_adk/core/git/__init__.py +1 -1
  20. moai_adk/core/git/branch.py +1 -1
  21. moai_adk/core/git/commit.py +1 -1
  22. moai_adk/core/git/manager.py +1 -1
  23. moai_adk/core/issue_creator.py +313 -0
  24. moai_adk/core/mcp/setup.py +56 -0
  25. moai_adk/core/mcp/setup_old.py +296 -0
  26. moai_adk/core/project/backup_utils.py +1 -1
  27. moai_adk/core/project/checker.py +2 -2
  28. moai_adk/core/project/detector.py +211 -12
  29. moai_adk/core/project/initializer.py +85 -15
  30. moai_adk/core/project/phase_executor.py +76 -13
  31. moai_adk/core/project/validator.py +13 -13
  32. moai_adk/core/quality/__init__.py +1 -1
  33. moai_adk/core/quality/trust_checker.py +1 -1
  34. moai_adk/core/quality/validators/__init__.py +1 -1
  35. moai_adk/core/quality/validators/base_validator.py +1 -1
  36. moai_adk/core/tags/__init__.py +86 -0
  37. moai_adk/core/tags/auto_corrector.py +693 -0
  38. moai_adk/core/tags/ci_validator.py +463 -0
  39. moai_adk/core/tags/cli.py +283 -0
  40. moai_adk/core/tags/generator.py +109 -0
  41. moai_adk/core/tags/inserter.py +99 -0
  42. moai_adk/core/tags/mapper.py +126 -0
  43. moai_adk/core/tags/parser.py +76 -0
  44. moai_adk/core/tags/policy_validator.py +580 -0
  45. moai_adk/core/tags/pre_commit_validator.py +421 -0
  46. moai_adk/core/tags/reporter.py +956 -0
  47. moai_adk/core/tags/rollback_manager.py +525 -0
  48. moai_adk/core/tags/tags.py +149 -0
  49. moai_adk/core/tags/validator.py +897 -0
  50. moai_adk/core/template/__init__.py +1 -1
  51. moai_adk/core/template/backup.py +1 -1
  52. moai_adk/core/template/merger.py +50 -1
  53. moai_adk/core/template/processor.py +119 -13
  54. moai_adk/core/template_engine.py +268 -0
  55. moai_adk/templates/.claude/agents/alfred/backend-expert.md +348 -0
  56. moai_adk/templates/.claude/agents/alfred/cc-manager.md +209 -944
  57. moai_adk/templates/.claude/agents/alfred/database-expert.md +352 -0
  58. moai_adk/templates/.claude/agents/alfred/debug-helper.md +34 -5
  59. moai_adk/templates/.claude/agents/alfred/devops-expert.md +464 -0
  60. moai_adk/templates/.claude/agents/alfred/doc-syncer.md +38 -8
  61. moai_adk/templates/.claude/agents/alfred/format-expert.md +469 -0
  62. moai_adk/templates/.claude/agents/alfred/frontend-expert.md +357 -0
  63. moai_adk/templates/.claude/agents/alfred/git-manager.md +128 -9
  64. moai_adk/templates/.claude/agents/alfred/implementation-planner.md +104 -6
  65. moai_adk/templates/.claude/agents/alfred/project-manager.md +88 -16
  66. moai_adk/templates/.claude/agents/alfred/quality-gate.md +36 -9
  67. moai_adk/templates/.claude/agents/alfred/security-expert.md +270 -0
  68. moai_adk/templates/.claude/agents/alfred/skill-factory.md +865 -0
  69. moai_adk/templates/.claude/agents/alfred/spec-builder.md +214 -43
  70. moai_adk/templates/.claude/agents/alfred/tag-agent.md +111 -9
  71. moai_adk/templates/.claude/agents/alfred/tdd-implementer.md +309 -160
  72. moai_adk/templates/.claude/agents/alfred/trust-checker.md +36 -7
  73. moai_adk/templates/.claude/agents/alfred/ui-ux-expert.md +605 -0
  74. moai_adk/templates/.claude/commands/alfred/0-project.md +393 -966
  75. moai_adk/templates/.claude/commands/alfred/1-plan.md +651 -367
  76. moai_adk/templates/.claude/commands/alfred/2-run.md +388 -241
  77. moai_adk/templates/.claude/commands/alfred/3-sync.md +1921 -410
  78. moai_adk/templates/.claude/commands/alfred/9-feedback.md +153 -0
  79. moai_adk/templates/.claude/commands/alfred/release-new.md +3604 -0
  80. moai_adk/templates/.claude/hooks/alfred/core/project.py +484 -20
  81. moai_adk/templates/.claude/hooks/alfred/core/timeout.py +136 -0
  82. moai_adk/templates/.claude/hooks/alfred/core/ttl_cache.py +108 -0
  83. moai_adk/templates/.claude/hooks/alfred/core/version_cache.py +198 -0
  84. moai_adk/templates/.claude/hooks/alfred/handlers/__init__.py +14 -6
  85. moai_adk/templates/.claude/hooks/alfred/post_tool__enable_streaming_ui.py +50 -0
  86. moai_adk/templates/.claude/hooks/alfred/post_tool__log_changes.py +93 -0
  87. moai_adk/templates/.claude/hooks/alfred/post_tool__tag_auto_corrector.py +407 -0
  88. moai_adk/templates/.claude/hooks/alfred/pre_tool__auto_checkpoint.py +99 -0
  89. moai_adk/templates/.claude/hooks/alfred/pre_tool__realtime_tag_monitor.py +335 -0
  90. moai_adk/templates/.claude/hooks/alfred/pre_tool__tag_policy_validator.py +325 -0
  91. moai_adk/templates/.claude/hooks/alfred/session_end__cleanup.py +93 -0
  92. moai_adk/templates/.claude/hooks/alfred/session_start__auto_cleanup.py +580 -0
  93. moai_adk/templates/.claude/hooks/alfred/session_start__show_project_info.py +298 -0
  94. moai_adk/templates/.claude/hooks/alfred/shared/core/__init__.py +170 -0
  95. moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/checkpoint.py +3 -3
  96. moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/context.py +5 -5
  97. moai_adk/templates/.claude/hooks/alfred/shared/core/project.py +749 -0
  98. moai_adk/templates/.claude/hooks/alfred/shared/core/tags.py +230 -0
  99. moai_adk/templates/.claude/hooks/alfred/shared/core/version_cache.py +198 -0
  100. moai_adk/templates/.claude/hooks/alfred/shared/handlers/__init__.py +21 -0
  101. moai_adk/templates/.claude/hooks/alfred/shared/handlers/daily_analysis.py +351 -0
  102. moai_adk/templates/.claude/hooks/alfred/shared/handlers/notification.py +154 -0
  103. moai_adk/templates/.claude/hooks/alfred/shared/handlers/session.py +174 -0
  104. moai_adk/templates/.claude/hooks/alfred/shared/handlers/tool.py +87 -0
  105. moai_adk/templates/.claude/hooks/alfred/shared/handlers/user.py +61 -0
  106. moai_adk/templates/.claude/hooks/alfred/user_prompt__jit_load_docs.py +111 -0
  107. moai_adk/templates/.claude/hooks/alfred/utils/__init__.py +1 -0
  108. moai_adk/templates/.claude/hooks/alfred/utils/hook_config.py +94 -0
  109. moai_adk/templates/.claude/hooks/alfred/utils/timeout.py +161 -0
  110. moai_adk/templates/.claude/output-styles/alfred/alfred-moai-adk-beginner.md +267 -0
  111. moai_adk/templates/.claude/output-styles/alfred/keating-personal-tutor.md +440 -0
  112. moai_adk/templates/.claude/output-styles/alfred/r2d2-agentic-coding.md +583 -0
  113. moai_adk/templates/.claude/settings.json +96 -14
  114. moai_adk/templates/.claude/skills/moai-alfred-agent-guide/SKILL.md +70 -0
  115. moai_adk/templates/.claude/skills/moai-alfred-agent-guide/examples.md +62 -0
  116. moai_adk/templates/.claude/skills/moai-alfred-agent-guide/reference.md +242 -0
  117. moai_adk/templates/.claude/skills/moai-alfred-ask-user-questions/SKILL.md +237 -0
  118. moai_adk/templates/.claude/skills/moai-alfred-ask-user-questions/examples.md +871 -0
  119. moai_adk/templates/.claude/skills/moai-alfred-ask-user-questions/reference.md +653 -0
  120. moai_adk/templates/.claude/skills/moai-alfred-clone-pattern/README.md +162 -0
  121. moai_adk/templates/.claude/skills/moai-alfred-clone-pattern/SKILL.md +227 -0
  122. moai_adk/templates/.claude/skills/moai-alfred-clone-pattern/examples.md +354 -0
  123. moai_adk/templates/.claude/skills/moai-alfred-clone-pattern/reference.md +158 -0
  124. moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/SKILL.md +179 -79
  125. moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/examples.md +117 -0
  126. moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/scripts/pre-review-check.sh +62 -0
  127. moai_adk/templates/.claude/skills/moai-alfred-config-schema/SKILL.md +132 -0
  128. moai_adk/templates/.claude/skills/moai-alfred-config-schema/examples.md +28 -0
  129. moai_adk/templates/.claude/skills/moai-alfred-config-schema/reference.md +444 -0
  130. moai_adk/templates/.claude/skills/moai-alfred-context-budget/SKILL.md +62 -0
  131. moai_adk/templates/.claude/skills/moai-alfred-context-budget/examples.md +28 -0
  132. moai_adk/templates/.claude/skills/moai-alfred-context-budget/reference.md +405 -0
  133. moai_adk/templates/.claude/skills/moai-alfred-dev-guide/SKILL.md +51 -0
  134. moai_adk/templates/.claude/skills/moai-alfred-dev-guide/examples.md +355 -0
  135. moai_adk/templates/.claude/skills/moai-alfred-dev-guide/reference.md +239 -0
  136. moai_adk/templates/.claude/skills/moai-alfred-expertise-detection/SKILL.md +323 -0
  137. moai_adk/templates/.claude/skills/moai-alfred-expertise-detection/examples.md +286 -0
  138. moai_adk/templates/.claude/skills/moai-alfred-expertise-detection/reference.md +126 -0
  139. moai_adk/templates/.claude/skills/moai-alfred-issue-labels/SKILL.md +229 -0
  140. moai_adk/templates/.claude/skills/moai-alfred-issue-labels/examples.md +4 -0
  141. moai_adk/templates/.claude/skills/moai-alfred-issue-labels/reference.md +150 -0
  142. moai_adk/templates/.claude/skills/moai-alfred-language-detection/SKILL.md +87 -73
  143. moai_adk/templates/.claude/skills/moai-alfred-language-detection/examples.md +29 -0
  144. moai_adk/templates/.claude/skills/moai-alfred-language-detection/reference.md +28 -0
  145. moai_adk/templates/.claude/skills/moai-alfred-personas/README.md +42 -0
  146. moai_adk/templates/.claude/skills/moai-alfred-personas/SKILL.md +429 -0
  147. moai_adk/templates/.claude/skills/moai-alfred-personas/examples.md +520 -0
  148. moai_adk/templates/.claude/skills/moai-alfred-personas/reference.md +405 -0
  149. moai_adk/templates/.claude/skills/moai-alfred-practices/SKILL.md +89 -0
  150. moai_adk/templates/.claude/skills/moai-alfred-practices/examples.md +122 -0
  151. moai_adk/templates/.claude/skills/moai-alfred-practices/reference.md +369 -0
  152. moai_adk/templates/.claude/skills/moai-alfred-proactive-suggestions/SKILL.md +508 -0
  153. moai_adk/templates/.claude/skills/moai-alfred-proactive-suggestions/examples.md +481 -0
  154. moai_adk/templates/.claude/skills/moai-alfred-proactive-suggestions/reference.md +100 -0
  155. moai_adk/templates/.claude/skills/moai-alfred-rules/SKILL.md +77 -0
  156. moai_adk/templates/.claude/skills/moai-alfred-rules/examples.md +265 -0
  157. moai_adk/templates/.claude/skills/moai-alfred-rules/reference.md +539 -0
  158. moai_adk/templates/.claude/skills/moai-alfred-session-state/SKILL.md +320 -0
  159. moai_adk/templates/.claude/skills/moai-alfred-session-state/examples.md +4 -0
  160. moai_adk/templates/.claude/skills/moai-alfred-session-state/reference.md +84 -0
  161. moai_adk/templates/.claude/skills/moai-alfred-spec-authoring/README.md +137 -0
  162. moai_adk/templates/.claude/skills/moai-alfred-spec-authoring/SKILL.md +219 -0
  163. moai_adk/templates/.claude/skills/moai-alfred-spec-authoring/examples/validate-spec.sh +161 -0
  164. moai_adk/templates/.claude/skills/moai-alfred-spec-authoring/examples.md +541 -0
  165. moai_adk/templates/.claude/skills/moai-alfred-spec-authoring/reference.md +622 -0
  166. moai_adk/templates/.claude/skills/moai-alfred-todowrite-pattern/SKILL.md +19 -0
  167. moai_adk/templates/.claude/skills/moai-alfred-todowrite-pattern/examples.md +4 -0
  168. moai_adk/templates/.claude/skills/moai-alfred-todowrite-pattern/reference.md +211 -0
  169. moai_adk/templates/.claude/skills/moai-alfred-workflow/SKILL.md +288 -0
  170. moai_adk/templates/.claude/skills/moai-cc-agents/SKILL.md +269 -0
  171. moai_adk/templates/.claude/skills/moai-cc-agents/templates/agent-template.md +32 -0
  172. moai_adk/templates/.claude/skills/moai-cc-claude-md/SKILL.md +298 -0
  173. moai_adk/templates/.claude/skills/moai-cc-claude-md/templates/CLAUDE-template.md +26 -0
  174. moai_adk/templates/.claude/skills/moai-cc-commands/SKILL.md +307 -0
  175. moai_adk/templates/.claude/skills/moai-cc-commands/templates/command-template.md +21 -0
  176. moai_adk/templates/.claude/skills/moai-cc-hooks/SKILL.md +252 -0
  177. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/pre-bash-check.sh +19 -0
  178. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/preserve-permissions.sh +19 -0
  179. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/validate-bash-command.py +24 -0
  180. moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/SKILL.md +199 -0
  181. moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/templates/settings-mcp-template.json +39 -0
  182. moai_adk/templates/.claude/skills/moai-cc-memory/SKILL.md +316 -0
  183. moai_adk/templates/.claude/skills/moai-cc-memory/templates/session-summary-template.md +18 -0
  184. moai_adk/templates/.claude/skills/moai-cc-settings/SKILL.md +263 -0
  185. moai_adk/templates/.claude/skills/moai-cc-settings/templates/settings-complete-template.json +30 -0
  186. moai_adk/templates/.claude/skills/moai-cc-skill-factory/CHECKLIST.md +482 -0
  187. moai_adk/templates/.claude/skills/moai-cc-skill-factory/EXAMPLES.md +303 -0
  188. moai_adk/templates/.claude/skills/moai-cc-skill-factory/INTERACTIVE-DISCOVERY.md +524 -0
  189. moai_adk/templates/.claude/skills/moai-cc-skill-factory/METADATA.md +477 -0
  190. moai_adk/templates/.claude/skills/moai-cc-skill-factory/PARALLEL-ANALYSIS-REPORT.md +429 -0
  191. moai_adk/templates/.claude/skills/moai-cc-skill-factory/PYTHON-VERSION-MATRIX.md +391 -0
  192. moai_adk/templates/.claude/skills/moai-cc-skill-factory/SKILL-FACTORY-WORKFLOW.md +431 -0
  193. moai_adk/templates/.claude/skills/moai-cc-skill-factory/SKILL-UPDATE-ADVISOR.md +577 -0
  194. moai_adk/templates/.claude/skills/moai-cc-skill-factory/SKILL.md +273 -0
  195. moai_adk/templates/.claude/skills/moai-cc-skill-factory/STEP-BY-STEP-GUIDE.md +466 -0
  196. moai_adk/templates/.claude/skills/moai-cc-skill-factory/STRUCTURE.md +583 -0
  197. moai_adk/templates/.claude/skills/moai-cc-skill-factory/WEB-RESEARCH.md +526 -0
  198. moai_adk/templates/.claude/skills/moai-cc-skill-factory/reference.md +608 -0
  199. moai_adk/templates/.claude/skills/moai-cc-skill-factory/scripts/generate-structure.sh +328 -0
  200. moai_adk/templates/.claude/skills/moai-cc-skill-factory/scripts/validate-skill.sh +312 -0
  201. moai_adk/templates/.claude/skills/moai-cc-skill-factory/templates/SKILL_TEMPLATE.md +245 -0
  202. moai_adk/templates/.claude/skills/moai-cc-skill-factory/templates/examples-template.md +285 -0
  203. moai_adk/templates/.claude/skills/moai-cc-skill-factory/templates/reference-template.md +278 -0
  204. moai_adk/templates/.claude/skills/moai-cc-skill-factory/templates/scripts-template.sh +303 -0
  205. moai_adk/templates/.claude/skills/moai-cc-skills/SKILL.md +291 -0
  206. moai_adk/templates/.claude/skills/moai-cc-skills/templates/SKILL-template.md +15 -0
  207. moai_adk/templates/.claude/skills/moai-change-logger/SKILL.md +563 -0
  208. moai_adk/templates/.claude/skills/moai-design-systems/SKILL.md +802 -0
  209. moai_adk/templates/.claude/skills/moai-design-systems/examples.md +1238 -0
  210. moai_adk/templates/.claude/skills/moai-design-systems/reference.md +673 -0
  211. moai_adk/templates/.claude/skills/moai-domain-backend/SKILL.md +234 -43
  212. moai_adk/templates/.claude/skills/moai-domain-backend/examples.md +1633 -0
  213. moai_adk/templates/.claude/skills/moai-domain-backend/reference.md +660 -0
  214. moai_adk/templates/.claude/skills/moai-domain-cli-tool/SKILL.md +97 -69
  215. moai_adk/templates/.claude/skills/moai-domain-cli-tool/examples.md +29 -0
  216. moai_adk/templates/.claude/skills/moai-domain-cli-tool/reference.md +30 -0
  217. moai_adk/templates/.claude/skills/moai-domain-data-science/SKILL.md +97 -72
  218. moai_adk/templates/.claude/skills/moai-domain-data-science/examples.md +29 -0
  219. moai_adk/templates/.claude/skills/moai-domain-data-science/reference.md +30 -0
  220. moai_adk/templates/.claude/skills/moai-domain-database/SKILL.md +97 -74
  221. moai_adk/templates/.claude/skills/moai-domain-database/examples.md +29 -0
  222. moai_adk/templates/.claude/skills/moai-domain-database/reference.md +30 -0
  223. moai_adk/templates/.claude/skills/moai-domain-devops/SKILL.md +98 -74
  224. moai_adk/templates/.claude/skills/moai-domain-devops/examples.md +29 -0
  225. moai_adk/templates/.claude/skills/moai-domain-devops/reference.md +31 -0
  226. moai_adk/templates/.claude/skills/moai-domain-frontend/SKILL.md +102 -73
  227. moai_adk/templates/.claude/skills/moai-domain-frontend/examples.md +29 -0
  228. moai_adk/templates/.claude/skills/moai-domain-frontend/reference.md +31 -0
  229. moai_adk/templates/.claude/skills/moai-domain-ml/SKILL.md +97 -73
  230. moai_adk/templates/.claude/skills/moai-domain-ml/examples.md +29 -0
  231. moai_adk/templates/.claude/skills/moai-domain-ml/reference.md +30 -0
  232. moai_adk/templates/.claude/skills/moai-domain-mobile-app/SKILL.md +97 -67
  233. moai_adk/templates/.claude/skills/moai-domain-mobile-app/examples.md +29 -0
  234. moai_adk/templates/.claude/skills/moai-domain-mobile-app/reference.md +30 -0
  235. moai_adk/templates/.claude/skills/moai-domain-security/SKILL.md +97 -79
  236. moai_adk/templates/.claude/skills/moai-domain-security/examples.md +29 -0
  237. moai_adk/templates/.claude/skills/moai-domain-security/reference.md +30 -0
  238. moai_adk/templates/.claude/skills/moai-domain-web-api/SKILL.md +97 -71
  239. moai_adk/templates/.claude/skills/moai-domain-web-api/examples.md +29 -0
  240. moai_adk/templates/.claude/skills/moai-domain-web-api/reference.md +30 -0
  241. moai_adk/templates/.claude/skills/moai-essentials-debug/SKILL.md +265 -64
  242. moai_adk/templates/.claude/skills/moai-essentials-debug/examples.md +1064 -0
  243. moai_adk/templates/.claude/skills/moai-essentials-debug/reference.md +1047 -0
  244. moai_adk/templates/.claude/skills/moai-essentials-perf/SKILL.md +87 -78
  245. moai_adk/templates/.claude/skills/moai-essentials-perf/examples.md +29 -0
  246. moai_adk/templates/.claude/skills/moai-essentials-perf/reference.md +28 -0
  247. moai_adk/templates/.claude/skills/moai-essentials-refactor/SKILL.md +87 -70
  248. moai_adk/templates/.claude/skills/moai-essentials-refactor/examples.md +29 -0
  249. moai_adk/templates/.claude/skills/moai-essentials-refactor/reference.md +28 -0
  250. moai_adk/templates/.claude/skills/moai-essentials-review/SKILL.md +87 -86
  251. moai_adk/templates/.claude/skills/moai-essentials-review/examples.md +29 -0
  252. moai_adk/templates/.claude/skills/moai-essentials-review/reference.md +28 -0
  253. moai_adk/templates/.claude/skills/moai-foundation-ears/SKILL.md +80 -62
  254. moai_adk/templates/.claude/skills/moai-foundation-ears/examples.md +29 -0
  255. moai_adk/templates/.claude/skills/moai-foundation-ears/reference.md +28 -0
  256. moai_adk/templates/.claude/skills/moai-foundation-git/SKILL.md +207 -50
  257. moai_adk/templates/.claude/skills/moai-foundation-git/examples.md +29 -0
  258. moai_adk/templates/.claude/skills/moai-foundation-git/reference.md +29 -0
  259. moai_adk/templates/.claude/skills/moai-foundation-langs/SKILL.md +90 -71
  260. moai_adk/templates/.claude/skills/moai-foundation-langs/examples.md +29 -0
  261. moai_adk/templates/.claude/skills/moai-foundation-langs/reference.md +28 -0
  262. moai_adk/templates/.claude/skills/moai-foundation-specs/SKILL.md +78 -58
  263. moai_adk/templates/.claude/skills/moai-foundation-specs/examples.md +29 -0
  264. moai_adk/templates/.claude/skills/moai-foundation-specs/reference.md +28 -0
  265. moai_adk/templates/.claude/skills/moai-foundation-tags/SKILL.md +78 -51
  266. moai_adk/templates/.claude/skills/moai-foundation-tags/examples.md +29 -0
  267. moai_adk/templates/.claude/skills/moai-foundation-tags/reference.md +28 -0
  268. moai_adk/templates/.claude/skills/moai-foundation-trust/.!11330!examples.md +0 -0
  269. moai_adk/templates/.claude/skills/moai-foundation-trust/SKILL.md +253 -32
  270. moai_adk/templates/.claude/skills/moai-foundation-trust/examples.md +0 -0
  271. moai_adk/templates/.claude/skills/moai-foundation-trust/reference.md +1099 -0
  272. moai_adk/templates/.claude/skills/moai-jit-docs-enhanced/SKILL.md +460 -0
  273. moai_adk/templates/.claude/skills/moai-lang-c/SKILL.md +98 -74
  274. moai_adk/templates/.claude/skills/moai-lang-c/examples.md +29 -0
  275. moai_adk/templates/.claude/skills/moai-lang-c/reference.md +31 -0
  276. moai_adk/templates/.claude/skills/moai-lang-cpp/SKILL.md +98 -76
  277. moai_adk/templates/.claude/skills/moai-lang-cpp/examples.md +29 -0
  278. moai_adk/templates/.claude/skills/moai-lang-cpp/reference.md +31 -0
  279. moai_adk/templates/.claude/skills/moai-lang-csharp/SKILL.md +2358 -70
  280. moai_adk/templates/.claude/skills/moai-lang-csharp/examples.md +29 -0
  281. moai_adk/templates/.claude/skills/moai-lang-csharp/reference.md +30 -0
  282. moai_adk/templates/.claude/skills/moai-lang-dart/SKILL.md +2962 -68
  283. moai_adk/templates/.claude/skills/moai-lang-dart/examples.md +29 -0
  284. moai_adk/templates/.claude/skills/moai-lang-dart/reference.md +30 -0
  285. moai_adk/templates/.claude/skills/moai-lang-go/SKILL.md +1898 -70
  286. moai_adk/templates/.claude/skills/moai-lang-go/examples.md +29 -0
  287. moai_adk/templates/.claude/skills/moai-lang-go/reference.md +31 -0
  288. moai_adk/templates/.claude/skills/moai-lang-java/SKILL.md +1465 -68
  289. moai_adk/templates/.claude/skills/moai-lang-java/examples.md +29 -0
  290. moai_adk/templates/.claude/skills/moai-lang-java/reference.md +31 -0
  291. moai_adk/templates/.claude/skills/moai-lang-javascript/SKILL.md +2364 -66
  292. moai_adk/templates/.claude/skills/moai-lang-javascript/examples.md +29 -0
  293. moai_adk/templates/.claude/skills/moai-lang-javascript/reference.md +32 -0
  294. moai_adk/templates/.claude/skills/moai-lang-kotlin/SKILL.md +1630 -69
  295. moai_adk/templates/.claude/skills/moai-lang-kotlin/examples.md +29 -0
  296. moai_adk/templates/.claude/skills/moai-lang-kotlin/reference.md +31 -0
  297. moai_adk/templates/.claude/skills/moai-lang-php/SKILL.md +89 -61
  298. moai_adk/templates/.claude/skills/moai-lang-php/examples.md +29 -0
  299. moai_adk/templates/.claude/skills/moai-lang-php/reference.md +30 -0
  300. moai_adk/templates/.claude/skills/moai-lang-python/SKILL.md +735 -66
  301. moai_adk/templates/.claude/skills/moai-lang-python/examples.md +624 -0
  302. moai_adk/templates/.claude/skills/moai-lang-python/reference.md +316 -0
  303. moai_adk/templates/.claude/skills/moai-lang-r/SKILL.md +97 -73
  304. moai_adk/templates/.claude/skills/moai-lang-r/examples.md +29 -0
  305. moai_adk/templates/.claude/skills/moai-lang-r/reference.md +30 -0
  306. moai_adk/templates/.claude/skills/moai-lang-ruby/SKILL.md +98 -73
  307. moai_adk/templates/.claude/skills/moai-lang-ruby/examples.md +29 -0
  308. moai_adk/templates/.claude/skills/moai-lang-ruby/reference.md +31 -0
  309. moai_adk/templates/.claude/skills/moai-lang-rust/SKILL.md +1834 -70
  310. moai_adk/templates/.claude/skills/moai-lang-rust/examples.md +29 -0
  311. moai_adk/templates/.claude/skills/moai-lang-rust/reference.md +31 -0
  312. moai_adk/templates/.claude/skills/moai-lang-scala/SKILL.md +99 -74
  313. moai_adk/templates/.claude/skills/moai-lang-scala/examples.md +29 -0
  314. moai_adk/templates/.claude/skills/moai-lang-scala/reference.md +30 -0
  315. moai_adk/templates/.claude/skills/moai-lang-shell/SKILL.md +97 -74
  316. moai_adk/templates/.claude/skills/moai-lang-shell/examples.md +29 -0
  317. moai_adk/templates/.claude/skills/moai-lang-shell/reference.md +30 -0
  318. moai_adk/templates/.claude/skills/moai-lang-sql/SKILL.md +98 -74
  319. moai_adk/templates/.claude/skills/moai-lang-sql/examples.md +29 -0
  320. moai_adk/templates/.claude/skills/moai-lang-sql/reference.md +31 -0
  321. moai_adk/templates/.claude/skills/moai-lang-swift/SKILL.md +1959 -69
  322. moai_adk/templates/.claude/skills/moai-lang-swift/examples.md +29 -0
  323. moai_adk/templates/.claude/skills/moai-lang-swift/reference.md +30 -0
  324. moai_adk/templates/.claude/skills/moai-lang-template/SKILL.md +348 -0
  325. moai_adk/templates/.claude/skills/moai-lang-template/VARIABLES.md +98 -0
  326. moai_adk/templates/.claude/skills/moai-lang-typescript/SKILL.md +1230 -66
  327. moai_adk/templates/.claude/skills/moai-lang-typescript/examples.md +29 -0
  328. moai_adk/templates/.claude/skills/moai-lang-typescript/reference.md +34 -0
  329. moai_adk/templates/.claude/skills/moai-learning-optimizer/SKILL.md +575 -0
  330. moai_adk/templates/.claude/skills/moai-project-batch-questions/README.md +50 -0
  331. moai_adk/templates/.claude/skills/moai-project-batch-questions/SKILL.md +304 -0
  332. moai_adk/templates/.claude/skills/moai-project-batch-questions/examples.md +417 -0
  333. moai_adk/templates/.claude/skills/moai-project-batch-questions/reference.md +704 -0
  334. moai_adk/templates/.claude/skills/moai-project-config-manager/README.md +87 -0
  335. moai_adk/templates/.claude/skills/moai-project-config-manager/SKILL.md +552 -0
  336. moai_adk/templates/.claude/skills/moai-project-config-manager/examples.md +1109 -0
  337. moai_adk/templates/.claude/skills/moai-project-config-manager/reference.md +514 -0
  338. moai_adk/templates/.claude/skills/moai-project-config-manager/validate.py +106 -0
  339. moai_adk/templates/.claude/skills/moai-project-documentation/README.md +11 -0
  340. moai_adk/templates/.claude/skills/moai-project-documentation/SKILL.md +622 -0
  341. moai_adk/templates/.claude/skills/moai-project-documentation/examples.md +20 -0
  342. moai_adk/templates/.claude/skills/moai-project-documentation/reference.md +12 -0
  343. moai_adk/templates/.claude/skills/moai-project-language-initializer/README.md +152 -0
  344. moai_adk/templates/.claude/skills/moai-project-language-initializer/SKILL.md +285 -0
  345. moai_adk/templates/.claude/skills/moai-project-language-initializer/examples.md +333 -0
  346. moai_adk/templates/.claude/skills/moai-project-language-initializer/reference.md +386 -0
  347. moai_adk/templates/.claude/skills/moai-project-template-optimizer/README.md +49 -0
  348. moai_adk/templates/.claude/skills/moai-project-template-optimizer/SKILL.md +319 -0
  349. moai_adk/templates/.claude/skills/moai-project-template-optimizer/examples.md +58 -0
  350. moai_adk/templates/.claude/skills/moai-project-template-optimizer/reference.md +123 -0
  351. moai_adk/templates/.claude/skills/moai-session-info/SKILL.md +314 -0
  352. moai_adk/templates/.claude/skills/moai-streaming-ui/SKILL.md +552 -0
  353. moai_adk/templates/.claude/skills/moai-tag-policy-validator/SKILL.md +570 -0
  354. moai_adk/templates/.git-hooks/pre-commit +66 -0
  355. moai_adk/templates/.git-hooks/pre-push +255 -0
  356. moai_adk/templates/.github/workflows/c-tag-validation.yml +11 -0
  357. moai_adk/templates/.github/workflows/cpp-tag-validation.yml +11 -0
  358. moai_adk/templates/.github/workflows/csharp-tag-validation.yml +11 -0
  359. moai_adk/templates/.github/workflows/dart-tag-validation.yml +11 -0
  360. moai_adk/templates/.github/workflows/go-tag-validation.yml +130 -0
  361. moai_adk/templates/.github/workflows/java-tag-validation.yml +11 -0
  362. moai_adk/templates/.github/workflows/javascript-tag-validation.yml +135 -0
  363. moai_adk/templates/.github/workflows/kotlin-tag-validation.yml +11 -0
  364. moai_adk/templates/.github/workflows/moai-gitflow.yml +166 -3
  365. moai_adk/templates/.github/workflows/moai-release-create.yml +100 -0
  366. moai_adk/templates/.github/workflows/moai-release-pipeline.yml +188 -0
  367. moai_adk/templates/.github/workflows/php-tag-validation.yml +11 -0
  368. moai_adk/templates/.github/workflows/python-tag-validation.yml +118 -0
  369. moai_adk/templates/.github/workflows/release.yml +118 -0
  370. moai_adk/templates/.github/workflows/ruby-tag-validation.yml +11 -0
  371. moai_adk/templates/.github/workflows/rust-tag-validation.yml +11 -0
  372. moai_adk/templates/.github/workflows/shell-tag-validation.yml +11 -0
  373. moai_adk/templates/.github/workflows/spec-issue-sync.yml +338 -0
  374. moai_adk/templates/.github/workflows/swift-tag-validation.yml +11 -0
  375. moai_adk/templates/.github/workflows/tag-report.yml +269 -0
  376. moai_adk/templates/.github/workflows/tag-validation.yml +186 -0
  377. moai_adk/templates/.github/workflows/typescript-tag-validation.yml +154 -0
  378. moai_adk/templates/.mcp.json +31 -0
  379. moai_adk/templates/.moai/config.json +80 -7
  380. moai_adk/templates/CLAUDE.md +562 -546
  381. moai_adk/utils/banner.py +5 -5
  382. moai_adk/utils/common.py +294 -0
  383. moai_adk/utils/link_validator.py +235 -0
  384. moai_adk/utils/logger.py +8 -8
  385. moai_adk/utils/user_experience.py +451 -0
  386. moai_adk-0.20.1.dist-info/METADATA +233 -0
  387. moai_adk-0.20.1.dist-info/RECORD +404 -0
  388. moai_adk/templates/.claude/hooks/alfred/README.md +0 -230
  389. moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py +0 -156
  390. moai_adk/templates/.claude/hooks/alfred/core/__init__.py +0 -85
  391. moai_adk/templates/.claude/hooks/alfred/handlers/notification.py +0 -25
  392. moai_adk/templates/.claude/hooks/alfred/handlers/session.py +0 -92
  393. moai_adk/templates/.claude/hooks/alfred/handlers/tool.py +0 -70
  394. moai_adk/templates/.claude/hooks/alfred/handlers/user.py +0 -41
  395. moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md +0 -636
  396. moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md +0 -692
  397. moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md +0 -470
  398. moai_adk/templates/.claude/skills/moai-alfred-debugger-pro/SKILL.md +0 -103
  399. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/SKILL.md +0 -103
  400. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/SKILL.md +0 -95
  401. moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/SKILL.md +0 -105
  402. moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/SKILL.md +0 -97
  403. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/SKILL.md +0 -97
  404. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/SKILL.md +0 -90
  405. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/SKILL.md +0 -99
  406. moai_adk/templates/.claude/skills/moai-alfred-tui-survey/SKILL.md +0 -87
  407. moai_adk/templates/.claude/skills/moai-alfred-tui-survey/examples.md +0 -62
  408. moai_adk/templates/.claude/skills/moai-claude-code/SKILL.md +0 -94
  409. moai_adk/templates/.claude/skills/moai-claude-code/examples.md +0 -513
  410. moai_adk/templates/.claude/skills/moai-claude-code/reference.md +0 -433
  411. moai_adk/templates/.claude/skills/moai-claude-code/templates/agent-full.md +0 -332
  412. moai_adk/templates/.claude/skills/moai-claude-code/templates/command-full.md +0 -384
  413. moai_adk/templates/.claude/skills/moai-claude-code/templates/plugin-full.json +0 -363
  414. moai_adk/templates/.claude/skills/moai-claude-code/templates/settings-full.json +0 -595
  415. moai_adk/templates/.claude/skills/moai-claude-code/templates/skill-full.md +0 -496
  416. moai_adk/templates/.claude/skills/moai-lang-clojure/SKILL.md +0 -100
  417. moai_adk/templates/.claude/skills/moai-lang-elixir/SKILL.md +0 -99
  418. moai_adk/templates/.claude/skills/moai-lang-haskell/SKILL.md +0 -100
  419. moai_adk/templates/.claude/skills/moai-lang-julia/SKILL.md +0 -98
  420. moai_adk/templates/.claude/skills/moai-lang-lua/SKILL.md +0 -98
  421. moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md +0 -69
  422. moai_adk/templates/.moai/memory/development-guide.md +0 -344
  423. moai_adk/templates/.moai/memory/gitflow-protection-policy.md +0 -220
  424. moai_adk/templates/.moai/memory/spec-metadata.md +0 -356
  425. moai_adk/templates/.moai/project/product.md +0 -161
  426. moai_adk/templates/.moai/project/structure.md +0 -156
  427. moai_adk/templates/.moai/project/tech.md +0 -227
  428. moai_adk/templates/__init__.py +0 -2
  429. moai_adk-0.4.5.dist-info/METADATA +0 -369
  430. moai_adk-0.4.5.dist-info/RECORD +0 -152
  431. {moai_adk-0.4.5.dist-info → moai_adk-0.20.1.dist-info}/WHEEL +0 -0
  432. {moai_adk-0.4.5.dist-info → moai_adk-0.20.1.dist-info}/entry_points.txt +0 -0
  433. {moai_adk-0.4.5.dist-info → moai_adk-0.20.1.dist-info}/licenses/LICENSE +0 -0
@@ -0,0 +1,29 @@
1
+ # moai-lang-rust - 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-rust - 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
+ - **Rust**: 1.84.0
25
+ - **cargo**: 1.84.0
26
+ - **clippy**: 1.84.0
27
+ - **rustfmt**: 1.84.0
28
+
29
+ ---
30
+
31
+ _For detailed usage, see SKILL.md_
@@ -1,100 +1,125 @@
1
1
  ---
2
-
3
2
  name: moai-lang-scala
4
- description: Scala best practices with ScalaTest, sbt, and functional programming patterns. Use when writing or reviewing Scala code in project workflows.
3
+ version: 2.1.0
4
+ created: 2025-10-22
5
+ updated: 2025-11-02
6
+ status: active
7
+ description: Scala 3.6+ best practices with ScalaTest 3.2, sbt 1.10, functional programming patterns, and Play Framework.
8
+ keywords: ['scala', 'scalatest', 'sbt', 'functional', 'play-framework']
5
9
  allowed-tools:
6
10
  - Read
7
11
  - Bash
8
12
  ---
9
13
 
10
- # Scala Expert
14
+ # Lang Scala 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 | Scala code discussions, framework guidance, or file extensions such as .scala. |
18
- | Tier | 3 |
19
-
20
- ## What it does
21
-
22
- Provides Scala-specific expertise for TDD development, including ScalaTest framework, sbt build tool, and functional programming patterns.
23
-
24
- ## When to use
25
-
26
- - Engages when the conversation references Scala work, frameworks, or files like .scala.
27
- - “Writing Scala tests”, “How to use ScalaTest”, “Functional programming”
28
- - Automatically invoked when working with Scala projects
29
- - Scala SPEC implementation (`/alfred:2-run`)
30
-
31
- ## How it works
32
-
33
- **TDD Framework**:
34
- - **ScalaTest**: Flexible testing framework
35
- - **specs2**: BDD-style testing
36
- - **ScalaCheck**: Property-based testing
37
- - Test coverage with sbt-scoverage
38
-
39
- **Build Tools**:
40
- - **sbt**: Scala build tool
41
- - **build.sbt**: Build configuration
42
- - Multi-project builds
43
-
44
- **Code Quality**:
45
- - **Scalafmt**: Code formatting
46
- - **Scalafix**: Linting and refactoring
47
- - **WartRemover**: Code linting
48
-
49
- **Functional Programming**:
50
- - **Immutable data structures**
51
- - **Higher-order functions**
52
- - **Pattern matching**
53
- - **For-comprehensions**
54
- - **Monads (Option, Either, Try)**
55
-
56
- **Best Practices**:
57
- - File ≤300 LOC, method ≤50 LOC
58
- - Prefer immutable vals over mutable vars
59
- - Case classes for data modeling
60
- - Tail recursion for loops
61
- - Avoid null, use Option
62
-
63
- ## Examples
64
- ```bash
65
- sbt test && sbt scalafmtCheck
66
- ```
20
+ | **Skill Name** | moai-lang-scala |
21
+ | **Version** | 2.1.0 (2025-11-02) |
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
+ Scala 3.6+ best practices with ScalaTest 3.2, sbt 1.10, functional programming patterns, and Play Framework.
31
+
32
+ **Key capabilities**:
33
+ - Best practices enforcement for language domain
34
+ - TRUST 5 principles integration
35
+ - ✅ Latest tool versions (2025-11-02)
36
+ - TDD workflow support
37
+ - ✅ Play Framework web application patterns
38
+
39
+ ---
40
+
41
+ ## When to Use
42
+
43
+ **Automatic triggers**:
44
+ - Related code discussions and file patterns
45
+ - SPEC implementation (`/alfred:2-run`)
46
+ - Code review requests
47
+
48
+ **Manual invocation**:
49
+ - Review code for TRUST 5 compliance
50
+ - Design new features
51
+ - Troubleshoot issues
52
+
53
+ ---
54
+
55
+ ## Tool Version Matrix (2025-11-02)
56
+
57
+ | Tool | Version | Purpose | Status |
58
+ |------|---------|---------|--------|
59
+ | **Scala** | 3.6.0 | Runtime | ✅ Current |
60
+ | **ScalaTest** | 3.2.19 | Testing | ✅ Current |
61
+ | **sbt** | 1.10.0 | Build tool | ✅ Current |
62
+ | **Play Framework** | 3.0.9 | Web framework | ✅ Current |
63
+
64
+ ---
67
65
 
68
66
  ## Inputs
69
- - Language-specific source directories (e.g. `src/`, `app/`).
70
- - Language-specific build/test configuration files (e.g. `package.json`, `pyproject.toml`, `go.mod`).
71
- - Relevant test suites and sample data.
67
+
68
+ - Language-specific source directories
69
+ - Configuration files
70
+ - Test suites and sample data
72
71
 
73
72
  ## Outputs
74
- - Test/lint execution plan tailored to the selected language.
75
- - List of key language idioms and review checkpoints.
73
+
74
+ - Test/lint execution plan
75
+ - TRUST 5 review checkpoints
76
+ - Migration guidance
76
77
 
77
78
  ## Failure Modes
78
- - When the language runtime or package manager is not installed.
79
- - When the main language cannot be determined in a multilingual project.
79
+
80
+ - When required tools are not installed
81
+ - When dependencies are missing
82
+ - When test coverage falls below 85%
80
83
 
81
84
  ## Dependencies
82
- - Access to the project file is required using the Read/Grep tool.
83
- - When used with `Skill("moai-foundation-langs")`, it is easy to share cross-language conventions.
84
85
 
85
- ## References
86
- - Lightbend. "Scala Documentation." https://docs.scala-lang.org/ (accessed 2025-03-29).
87
- - Scalameta. "scalafmt." https://scalameta.org/scalafmt/ (accessed 2025-03-29).
86
+ - Access to project files via Read/Bash tools
87
+ - Integration with `moai-foundation-langs` for language detection
88
+ - Integration with `moai-foundation-trust` for quality gates
89
+
90
+ ---
91
+
92
+ ## References (Latest Documentation)
93
+
94
+ _Documentation links updated 2025-10-22_
95
+
96
+ ---
88
97
 
89
98
  ## Changelog
90
- - 2025-03-29: Input/output/failure response/reference information for each language has been specified.
91
99
 
92
- ## Works well with
100
+ - **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
101
+ - **v1.0.0** (2025-03-29): Initial Skill release
102
+
103
+ ---
104
+
105
+ ## Works Well With
106
+
107
+ - `moai-foundation-trust` (quality gates)
108
+ - `moai-alfred-code-reviewer` (code review)
109
+ - `moai-essentials-debug` (debugging support)
93
110
 
94
- - alfred-trust-validation (coverage verification)
95
- - alfred-code-reviewer (Scala-specific review)
96
- - alfred-refactoring-coach (functional refactoring)
111
+ ---
97
112
 
98
113
  ## Best Practices
99
- - Enable automatic validation by matching your linter with the language's official style guide.
100
- - Fix test/build pipelines with reproducible commands in CI.
114
+
115
+ **DO**:
116
+ - Follow language best practices
117
+ - Use latest stable tool versions
118
+ - Maintain test coverage ≥85%
119
+ - Document all public APIs
120
+
121
+ ❌ **DON'T**:
122
+ - Skip quality gates
123
+ - Use deprecated tools
124
+ - Ignore security warnings
125
+ - Mix testing frameworks
@@ -0,0 +1,29 @@
1
+ # moai-lang-scala - 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-scala - 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
+ - **Scala**: 3.6.0
25
+ - **ScalaTest**: 3.2.19
26
+ - **sbt**: 1.10.0
27
+
28
+ ---
29
+
30
+ _For detailed usage, see SKILL.md_
@@ -1,100 +1,123 @@
1
1
  ---
2
-
3
2
  name: moai-lang-shell
4
- description: Shell scripting best practices with bats, shellcheck, and POSIX compliance. Use when writing or reviewing Shell scripts code in project workflows.
3
+ version: 2.0.0
4
+ created: 2025-10-22
5
+ updated: 2025-10-22
6
+ status: active
7
+ description: Shell scripting best practices with bats-core 1.11, shellcheck 0.10, and POSIX compliance.
8
+ keywords: ['shell', 'bash', 'shellcheck', 'bats', 'posix']
5
9
  allowed-tools:
6
10
  - Read
7
11
  - Bash
8
12
  ---
9
13
 
10
- # Shell Expert
14
+ # Lang Shell 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 | Shell code discussions, framework guidance, or file extensions such as .sh/.bash. |
18
- | Tier | 3 |
19
-
20
- ## What it does
21
-
22
- Provides shell scripting expertise for TDD development, including bats testing framework, shellcheck linting, and POSIX compliance for portable scripts.
23
-
24
- ## When to use
25
-
26
- - Engages when the conversation references Shell work, frameworks, or files like .sh/.bash.
27
- - "Writing shell scripts", "bats testing", "POSIX compatibility"
28
- - Automatically invoked when working with shell script projects
29
- - Shell SPEC implementation (`/alfred:2-run`)
30
-
31
- ## How it works
32
-
33
- **TDD Framework**:
34
- - **bats**: Bash Automated Testing System
35
- - **shunit2**: xUnit-style shell testing
36
- - **assert.sh**: Shell assertion library
37
- - Test-driven shell development
38
-
39
- **Code Quality**:
40
- - **shellcheck**: Static analysis for shell scripts
41
- - **shfmt**: Shell script formatting
42
- - **bashate**: Style checker
43
-
44
- **POSIX Compliance**:
45
- - Portable shell features (sh vs bash)
46
- - Avoid bashisms for portability
47
- - Use `[ ]` instead of `[[ ]]` for POSIX
48
- - Standard utilities (no GNU extensions)
49
-
50
- **Shell Patterns**:
51
- - **Error handling**: set -e, set -u, set -o pipefail
52
- - **Exit codes**: Proper use of 0 (success) and non-zero
53
- - **Quoting**: Always quote variables ("$var")
54
- - **Functions**: Modular script organization
55
-
56
- **Best Practices**:
57
- - File ≤300 LOC, function ≤50 LOC
58
- - Use `#!/bin/sh` for POSIX, `#!/bin/bash` for Bash
59
- - Check command existence with `command -v`
60
- - Use `$()` over backticks
61
- - Validate input arguments
62
-
63
- ## Examples
64
- ```bash
65
- bats tests && shellcheck scripts/*.sh
66
- ```
20
+ | **Skill Name** | moai-lang-shell |
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
+ Shell scripting best practices with bats-core 1.11, shellcheck 0.10, and POSIX compliance.
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
+ | **Bash** | 5.2.37 | Primary | ✅ Current |
59
+ | **ShellCheck** | 0.10.0 | Primary | ✅ Current |
60
+ | **bats-core** | 1.11.0 | Primary | ✅ Current |
61
+
62
+ ---
67
63
 
68
64
  ## Inputs
69
- - Language-specific source directories (e.g. `src/`, `app/`).
70
- - Language-specific build/test configuration files (e.g. `package.json`, `pyproject.toml`, `go.mod`).
71
- - Relevant test suites and sample data.
65
+
66
+ - Language-specific source directories
67
+ - Configuration files
68
+ - Test suites and sample data
72
69
 
73
70
  ## Outputs
74
- - Test/lint execution plan tailored to the selected language.
75
- - List of key language idioms and review checkpoints.
71
+
72
+ - Test/lint execution plan
73
+ - TRUST 5 review checkpoints
74
+ - Migration guidance
76
75
 
77
76
  ## Failure Modes
78
- - When the language runtime or package manager is not installed.
79
- - 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%
80
81
 
81
82
  ## Dependencies
82
- - Access to the project file is required using the Read/Grep tool.
83
- - When used with `Skill("moai-foundation-langs")`, it is easy to share cross-language conventions.
84
83
 
85
- ## References
86
- - GNU. "Bash Reference Manual." https://www.gnu.org/software/bash/manual/bash.html (accessed 2025-03-29).
87
- - koalaman. "ShellCheck." https://www.shellcheck.net/ (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
+ ---
88
95
 
89
96
  ## Changelog
90
- - 2025-03-29: Input/output/failure response/reference information for each language has been specified.
91
97
 
92
- ## 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
100
+
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)
93
108
 
94
- - alfred-trust-validation (coverage verification)
95
- - alfred-code-reviewer (Shell-specific review)
96
- - devops-expert (Deployment scripts)
109
+ ---
97
110
 
98
111
  ## Best Practices
99
- - Enable automatic validation by matching your linter with the language's official style guide.
100
- - 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-shell - 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-shell - 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
+ - **Bash**: 5.2.37
25
+ - **ShellCheck**: 0.10.0
26
+ - **bats-core**: 1.11.0
27
+
28
+ ---
29
+
30
+ _For detailed usage, see SKILL.md_