moai-adk 0.10.1__py3-none-any.whl → 0.11.0__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 (245) hide show
  1. moai_adk/core/project/phase_executor.py +4 -0
  2. moai_adk/core/tags/ci_validator.py +33 -3
  3. moai_adk/core/template_engine.py +6 -2
  4. moai_adk/templates/.github/workflows/moai-gitflow.yml +6 -1
  5. moai_adk/templates/.github/workflows/release.yml +6 -2
  6. moai_adk/templates/.github/workflows/tag-validation.yml +53 -8
  7. moai_adk/templates/CLAUDE.md +458 -67
  8. {moai_adk-0.10.1.dist-info → moai_adk-0.11.0.dist-info}/METADATA +28 -13
  9. moai_adk-0.11.0.dist-info/RECORD +77 -0
  10. moai_adk/templates/.claude/agents/alfred/cc-manager.md +0 -316
  11. moai_adk/templates/.claude/agents/alfred/debug-helper.md +0 -208
  12. moai_adk/templates/.claude/agents/alfred/doc-syncer.md +0 -214
  13. moai_adk/templates/.claude/agents/alfred/git-manager.md +0 -406
  14. moai_adk/templates/.claude/agents/alfred/implementation-planner.md +0 -350
  15. moai_adk/templates/.claude/agents/alfred/project-manager.md +0 -273
  16. moai_adk/templates/.claude/agents/alfred/quality-gate.md +0 -343
  17. moai_adk/templates/.claude/agents/alfred/skill-factory.md +0 -865
  18. moai_adk/templates/.claude/agents/alfred/spec-builder.md +0 -287
  19. moai_adk/templates/.claude/agents/alfred/tag-agent.md +0 -287
  20. moai_adk/templates/.claude/agents/alfred/tdd-implementer.md +0 -326
  21. moai_adk/templates/.claude/agents/alfred/trust-checker.md +0 -375
  22. moai_adk/templates/.claude/commands/alfred/0-project.md +0 -1189
  23. moai_adk/templates/.claude/commands/alfred/1-plan.md +0 -728
  24. moai_adk/templates/.claude/commands/alfred/2-run.md +0 -545
  25. moai_adk/templates/.claude/commands/alfred/3-sync.md +0 -683
  26. moai_adk/templates/.claude/commands/alfred/9-feedback.md +0 -149
  27. moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py +0 -209
  28. moai_adk/templates/.claude/hooks/alfred/core/project.py +0 -750
  29. moai_adk/templates/.claude/hooks/alfred/core/version_cache.py +0 -198
  30. moai_adk/templates/.claude/hooks/alfred/notification__handle_events.py +0 -102
  31. moai_adk/templates/.claude/hooks/alfred/post_tool__log_changes.py +0 -102
  32. moai_adk/templates/.claude/hooks/alfred/pre_tool__auto_checkpoint.py +0 -108
  33. moai_adk/templates/.claude/hooks/alfred/session_end__cleanup.py +0 -102
  34. moai_adk/templates/.claude/hooks/alfred/session_start__show_project_info.py +0 -102
  35. moai_adk/templates/.claude/hooks/alfred/shared/core/__init__.py +0 -170
  36. moai_adk/templates/.claude/hooks/alfred/shared/core/checkpoint.py +0 -271
  37. moai_adk/templates/.claude/hooks/alfred/shared/core/context.py +0 -67
  38. moai_adk/templates/.claude/hooks/alfred/shared/core/project.py +0 -756
  39. moai_adk/templates/.claude/hooks/alfred/shared/core/tags.py +0 -198
  40. moai_adk/templates/.claude/hooks/alfred/shared/core/version_cache.py +0 -198
  41. moai_adk/templates/.claude/hooks/alfred/shared/handlers/__init__.py +0 -21
  42. moai_adk/templates/.claude/hooks/alfred/shared/handlers/notification.py +0 -25
  43. moai_adk/templates/.claude/hooks/alfred/shared/handlers/session.py +0 -175
  44. moai_adk/templates/.claude/hooks/alfred/shared/handlers/tool.py +0 -90
  45. moai_adk/templates/.claude/hooks/alfred/shared/handlers/user.py +0 -61
  46. moai_adk/templates/.claude/hooks/alfred/stop__handle_interrupt.py +0 -102
  47. moai_adk/templates/.claude/hooks/alfred/subagent_stop__handle_subagent_end.py +0 -102
  48. moai_adk/templates/.claude/hooks/alfred/user_prompt__jit_load_docs.py +0 -120
  49. moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md +0 -640
  50. moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md +0 -696
  51. moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md +0 -474
  52. moai_adk/templates/.claude/settings.json +0 -144
  53. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/SKILL.md +0 -113
  54. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/examples.md +0 -29
  55. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/reference.md +0 -28
  56. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/SKILL.md +0 -122
  57. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/examples.md +0 -29
  58. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/reference.md +0 -29
  59. moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/SKILL.md +0 -237
  60. moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/examples.md +0 -615
  61. moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/reference.md +0 -653
  62. moai_adk/templates/.claude/skills/moai-alfred-language-detection/SKILL.md +0 -113
  63. moai_adk/templates/.claude/skills/moai-alfred-language-detection/examples.md +0 -29
  64. moai_adk/templates/.claude/skills/moai-alfred-language-detection/reference.md +0 -28
  65. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/SKILL.md +0 -113
  66. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/examples.md +0 -29
  67. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/reference.md +0 -28
  68. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/SKILL.md +0 -113
  69. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/examples.md +0 -29
  70. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/reference.md +0 -28
  71. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/SKILL.md +0 -113
  72. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/examples.md +0 -29
  73. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/reference.md +0 -28
  74. moai_adk/templates/.claude/skills/moai-cc-agents/SKILL.md +0 -269
  75. moai_adk/templates/.claude/skills/moai-cc-agents/templates/agent-template.md +0 -32
  76. moai_adk/templates/.claude/skills/moai-cc-claude-md/SKILL.md +0 -298
  77. moai_adk/templates/.claude/skills/moai-cc-claude-md/templates/CLAUDE-template.md +0 -26
  78. moai_adk/templates/.claude/skills/moai-cc-commands/SKILL.md +0 -307
  79. moai_adk/templates/.claude/skills/moai-cc-commands/templates/command-template.md +0 -21
  80. moai_adk/templates/.claude/skills/moai-cc-hooks/SKILL.md +0 -252
  81. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/pre-bash-check.sh +0 -19
  82. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/preserve-permissions.sh +0 -19
  83. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/validate-bash-command.py +0 -24
  84. moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/SKILL.md +0 -199
  85. moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/templates/settings-mcp-template.json +0 -39
  86. moai_adk/templates/.claude/skills/moai-cc-memory/SKILL.md +0 -316
  87. moai_adk/templates/.claude/skills/moai-cc-memory/templates/session-summary-template.md +0 -18
  88. moai_adk/templates/.claude/skills/moai-cc-settings/SKILL.md +0 -263
  89. moai_adk/templates/.claude/skills/moai-cc-settings/templates/settings-complete-template.json +0 -30
  90. moai_adk/templates/.claude/skills/moai-cc-skills/SKILL.md +0 -291
  91. moai_adk/templates/.claude/skills/moai-cc-skills/templates/SKILL-template.md +0 -15
  92. moai_adk/templates/.claude/skills/moai-domain-backend/SKILL.md +0 -290
  93. moai_adk/templates/.claude/skills/moai-domain-backend/examples.md +0 -1633
  94. moai_adk/templates/.claude/skills/moai-domain-backend/reference.md +0 -660
  95. moai_adk/templates/.claude/skills/moai-domain-cli-tool/SKILL.md +0 -123
  96. moai_adk/templates/.claude/skills/moai-domain-cli-tool/examples.md +0 -29
  97. moai_adk/templates/.claude/skills/moai-domain-cli-tool/reference.md +0 -30
  98. moai_adk/templates/.claude/skills/moai-domain-data-science/SKILL.md +0 -123
  99. moai_adk/templates/.claude/skills/moai-domain-data-science/examples.md +0 -29
  100. moai_adk/templates/.claude/skills/moai-domain-data-science/reference.md +0 -30
  101. moai_adk/templates/.claude/skills/moai-domain-database/SKILL.md +0 -123
  102. moai_adk/templates/.claude/skills/moai-domain-database/examples.md +0 -29
  103. moai_adk/templates/.claude/skills/moai-domain-database/reference.md +0 -30
  104. moai_adk/templates/.claude/skills/moai-domain-devops/SKILL.md +0 -124
  105. moai_adk/templates/.claude/skills/moai-domain-devops/examples.md +0 -29
  106. moai_adk/templates/.claude/skills/moai-domain-devops/reference.md +0 -31
  107. moai_adk/templates/.claude/skills/moai-domain-frontend/SKILL.md +0 -124
  108. moai_adk/templates/.claude/skills/moai-domain-frontend/examples.md +0 -29
  109. moai_adk/templates/.claude/skills/moai-domain-frontend/reference.md +0 -31
  110. moai_adk/templates/.claude/skills/moai-domain-ml/SKILL.md +0 -123
  111. moai_adk/templates/.claude/skills/moai-domain-ml/examples.md +0 -29
  112. moai_adk/templates/.claude/skills/moai-domain-ml/reference.md +0 -30
  113. moai_adk/templates/.claude/skills/moai-domain-mobile-app/SKILL.md +0 -123
  114. moai_adk/templates/.claude/skills/moai-domain-mobile-app/examples.md +0 -29
  115. moai_adk/templates/.claude/skills/moai-domain-mobile-app/reference.md +0 -30
  116. moai_adk/templates/.claude/skills/moai-domain-security/SKILL.md +0 -123
  117. moai_adk/templates/.claude/skills/moai-domain-security/examples.md +0 -29
  118. moai_adk/templates/.claude/skills/moai-domain-security/reference.md +0 -30
  119. moai_adk/templates/.claude/skills/moai-domain-web-api/SKILL.md +0 -123
  120. moai_adk/templates/.claude/skills/moai-domain-web-api/examples.md +0 -29
  121. moai_adk/templates/.claude/skills/moai-domain-web-api/reference.md +0 -30
  122. moai_adk/templates/.claude/skills/moai-essentials-debug/SKILL.md +0 -303
  123. moai_adk/templates/.claude/skills/moai-essentials-debug/examples.md +0 -1064
  124. moai_adk/templates/.claude/skills/moai-essentials-debug/reference.md +0 -1047
  125. moai_adk/templates/.claude/skills/moai-essentials-perf/SKILL.md +0 -113
  126. moai_adk/templates/.claude/skills/moai-essentials-perf/examples.md +0 -29
  127. moai_adk/templates/.claude/skills/moai-essentials-perf/reference.md +0 -28
  128. moai_adk/templates/.claude/skills/moai-essentials-refactor/SKILL.md +0 -113
  129. moai_adk/templates/.claude/skills/moai-essentials-refactor/examples.md +0 -29
  130. moai_adk/templates/.claude/skills/moai-essentials-refactor/reference.md +0 -28
  131. moai_adk/templates/.claude/skills/moai-essentials-review/SKILL.md +0 -113
  132. moai_adk/templates/.claude/skills/moai-essentials-review/examples.md +0 -29
  133. moai_adk/templates/.claude/skills/moai-essentials-review/reference.md +0 -28
  134. moai_adk/templates/.claude/skills/moai-foundation-ears/SKILL.md +0 -116
  135. moai_adk/templates/.claude/skills/moai-foundation-ears/examples.md +0 -29
  136. moai_adk/templates/.claude/skills/moai-foundation-ears/reference.md +0 -28
  137. moai_adk/templates/.claude/skills/moai-foundation-git/SKILL.md +0 -122
  138. moai_adk/templates/.claude/skills/moai-foundation-git/examples.md +0 -29
  139. moai_adk/templates/.claude/skills/moai-foundation-git/reference.md +0 -29
  140. moai_adk/templates/.claude/skills/moai-foundation-langs/SKILL.md +0 -113
  141. moai_adk/templates/.claude/skills/moai-foundation-langs/examples.md +0 -29
  142. moai_adk/templates/.claude/skills/moai-foundation-langs/reference.md +0 -28
  143. moai_adk/templates/.claude/skills/moai-foundation-specs/SKILL.md +0 -113
  144. moai_adk/templates/.claude/skills/moai-foundation-specs/examples.md +0 -29
  145. moai_adk/templates/.claude/skills/moai-foundation-specs/reference.md +0 -28
  146. moai_adk/templates/.claude/skills/moai-foundation-tags/SKILL.md +0 -113
  147. moai_adk/templates/.claude/skills/moai-foundation-tags/examples.md +0 -29
  148. moai_adk/templates/.claude/skills/moai-foundation-tags/reference.md +0 -28
  149. moai_adk/templates/.claude/skills/moai-foundation-trust/SKILL.md +0 -307
  150. moai_adk/templates/.claude/skills/moai-foundation-trust/examples.md +0 -0
  151. moai_adk/templates/.claude/skills/moai-foundation-trust/reference.md +0 -1099
  152. moai_adk/templates/.claude/skills/moai-lang-c/SKILL.md +0 -124
  153. moai_adk/templates/.claude/skills/moai-lang-c/examples.md +0 -29
  154. moai_adk/templates/.claude/skills/moai-lang-c/reference.md +0 -31
  155. moai_adk/templates/.claude/skills/moai-lang-cpp/SKILL.md +0 -124
  156. moai_adk/templates/.claude/skills/moai-lang-cpp/examples.md +0 -29
  157. moai_adk/templates/.claude/skills/moai-lang-cpp/reference.md +0 -31
  158. moai_adk/templates/.claude/skills/moai-lang-csharp/SKILL.md +0 -123
  159. moai_adk/templates/.claude/skills/moai-lang-csharp/examples.md +0 -29
  160. moai_adk/templates/.claude/skills/moai-lang-csharp/reference.md +0 -30
  161. moai_adk/templates/.claude/skills/moai-lang-dart/SKILL.md +0 -123
  162. moai_adk/templates/.claude/skills/moai-lang-dart/examples.md +0 -29
  163. moai_adk/templates/.claude/skills/moai-lang-dart/reference.md +0 -30
  164. moai_adk/templates/.claude/skills/moai-lang-go/SKILL.md +0 -124
  165. moai_adk/templates/.claude/skills/moai-lang-go/examples.md +0 -29
  166. moai_adk/templates/.claude/skills/moai-lang-go/reference.md +0 -31
  167. moai_adk/templates/.claude/skills/moai-lang-java/SKILL.md +0 -124
  168. moai_adk/templates/.claude/skills/moai-lang-java/examples.md +0 -29
  169. moai_adk/templates/.claude/skills/moai-lang-java/reference.md +0 -31
  170. moai_adk/templates/.claude/skills/moai-lang-javascript/SKILL.md +0 -125
  171. moai_adk/templates/.claude/skills/moai-lang-javascript/examples.md +0 -29
  172. moai_adk/templates/.claude/skills/moai-lang-javascript/reference.md +0 -32
  173. moai_adk/templates/.claude/skills/moai-lang-kotlin/SKILL.md +0 -124
  174. moai_adk/templates/.claude/skills/moai-lang-kotlin/examples.md +0 -29
  175. moai_adk/templates/.claude/skills/moai-lang-kotlin/reference.md +0 -31
  176. moai_adk/templates/.claude/skills/moai-lang-php/SKILL.md +0 -123
  177. moai_adk/templates/.claude/skills/moai-lang-php/examples.md +0 -29
  178. moai_adk/templates/.claude/skills/moai-lang-php/reference.md +0 -30
  179. moai_adk/templates/.claude/skills/moai-lang-python/SKILL.md +0 -431
  180. moai_adk/templates/.claude/skills/moai-lang-python/examples.md +0 -624
  181. moai_adk/templates/.claude/skills/moai-lang-python/reference.md +0 -316
  182. moai_adk/templates/.claude/skills/moai-lang-r/SKILL.md +0 -123
  183. moai_adk/templates/.claude/skills/moai-lang-r/examples.md +0 -29
  184. moai_adk/templates/.claude/skills/moai-lang-r/reference.md +0 -30
  185. moai_adk/templates/.claude/skills/moai-lang-ruby/SKILL.md +0 -124
  186. moai_adk/templates/.claude/skills/moai-lang-ruby/examples.md +0 -29
  187. moai_adk/templates/.claude/skills/moai-lang-ruby/reference.md +0 -31
  188. moai_adk/templates/.claude/skills/moai-lang-rust/SKILL.md +0 -124
  189. moai_adk/templates/.claude/skills/moai-lang-rust/examples.md +0 -29
  190. moai_adk/templates/.claude/skills/moai-lang-rust/reference.md +0 -31
  191. moai_adk/templates/.claude/skills/moai-lang-scala/SKILL.md +0 -123
  192. moai_adk/templates/.claude/skills/moai-lang-scala/examples.md +0 -29
  193. moai_adk/templates/.claude/skills/moai-lang-scala/reference.md +0 -30
  194. moai_adk/templates/.claude/skills/moai-lang-shell/SKILL.md +0 -123
  195. moai_adk/templates/.claude/skills/moai-lang-shell/examples.md +0 -29
  196. moai_adk/templates/.claude/skills/moai-lang-shell/reference.md +0 -30
  197. moai_adk/templates/.claude/skills/moai-lang-sql/SKILL.md +0 -124
  198. moai_adk/templates/.claude/skills/moai-lang-sql/examples.md +0 -29
  199. moai_adk/templates/.claude/skills/moai-lang-sql/reference.md +0 -31
  200. moai_adk/templates/.claude/skills/moai-lang-swift/SKILL.md +0 -123
  201. moai_adk/templates/.claude/skills/moai-lang-swift/examples.md +0 -29
  202. moai_adk/templates/.claude/skills/moai-lang-swift/reference.md +0 -30
  203. moai_adk/templates/.claude/skills/moai-lang-typescript/SKILL.md +0 -127
  204. moai_adk/templates/.claude/skills/moai-lang-typescript/examples.md +0 -29
  205. moai_adk/templates/.claude/skills/moai-lang-typescript/reference.md +0 -34
  206. moai_adk/templates/.claude/skills/moai-skill-factory/CHECKLIST.md +0 -482
  207. moai_adk/templates/.claude/skills/moai-skill-factory/EXAMPLES.md +0 -278
  208. moai_adk/templates/.claude/skills/moai-skill-factory/INTERACTIVE-DISCOVERY.md +0 -524
  209. moai_adk/templates/.claude/skills/moai-skill-factory/METADATA.md +0 -477
  210. moai_adk/templates/.claude/skills/moai-skill-factory/PARALLEL-ANALYSIS-REPORT.md +0 -429
  211. moai_adk/templates/.claude/skills/moai-skill-factory/PYTHON-VERSION-MATRIX.md +0 -391
  212. moai_adk/templates/.claude/skills/moai-skill-factory/SKILL-FACTORY-WORKFLOW.md +0 -431
  213. moai_adk/templates/.claude/skills/moai-skill-factory/SKILL-UPDATE-ADVISOR.md +0 -577
  214. moai_adk/templates/.claude/skills/moai-skill-factory/SKILL.md +0 -271
  215. moai_adk/templates/.claude/skills/moai-skill-factory/STEP-BY-STEP-GUIDE.md +0 -466
  216. moai_adk/templates/.claude/skills/moai-skill-factory/STRUCTURE.md +0 -583
  217. moai_adk/templates/.claude/skills/moai-skill-factory/WEB-RESEARCH.md +0 -526
  218. moai_adk/templates/.claude/skills/moai-skill-factory/reference.md +0 -465
  219. moai_adk/templates/.claude/skills/moai-skill-factory/scripts/generate-structure.sh +0 -328
  220. moai_adk/templates/.claude/skills/moai-skill-factory/scripts/validate-skill.sh +0 -312
  221. moai_adk/templates/.claude/skills/moai-skill-factory/templates/SKILL_TEMPLATE.md +0 -245
  222. moai_adk/templates/.claude/skills/moai-skill-factory/templates/examples-template.md +0 -285
  223. moai_adk/templates/.claude/skills/moai-skill-factory/templates/reference-template.md +0 -278
  224. moai_adk/templates/.claude/skills/moai-skill-factory/templates/scripts-template.sh +0 -303
  225. moai_adk/templates/.claude/skills/moai-spec-authoring/README.md +0 -137
  226. moai_adk/templates/.claude/skills/moai-spec-authoring/SKILL.md +0 -219
  227. moai_adk/templates/.claude/skills/moai-spec-authoring/examples/validate-spec.sh +0 -161
  228. moai_adk/templates/.claude/skills/moai-spec-authoring/examples.md +0 -541
  229. moai_adk/templates/.claude/skills/moai-spec-authoring/reference.md +0 -622
  230. moai_adk/templates/.moai/config.json +0 -113
  231. moai_adk/templates/.moai/memory/CLAUDE-AGENTS-GUIDE.md +0 -208
  232. moai_adk/templates/.moai/memory/CLAUDE-PRACTICES.md +0 -369
  233. moai_adk/templates/.moai/memory/CLAUDE-RULES.md +0 -539
  234. moai_adk/templates/.moai/memory/DEVELOPMENT-GUIDE.md +0 -344
  235. moai_adk/templates/.moai/memory/ISSUE-LABEL-MAPPING.md +0 -150
  236. moai_adk/templates/.moai/memory/SKILLS-DESCRIPTION-POLICY.md +0 -218
  237. moai_adk/templates/.moai/memory/gitflow-protection-policy.md +0 -330
  238. moai_adk/templates/.moai/memory/spec-metadata.md +0 -356
  239. moai_adk/templates/.moai/project/product.md +0 -161
  240. moai_adk/templates/.moai/project/structure.md +0 -156
  241. moai_adk/templates/.moai/project/tech.md +0 -227
  242. moai_adk-0.10.1.dist-info/RECORD +0 -309
  243. {moai_adk-0.10.1.dist-info → moai_adk-0.11.0.dist-info}/WHEEL +0 -0
  244. {moai_adk-0.10.1.dist-info → moai_adk-0.11.0.dist-info}/entry_points.txt +0 -0
  245. {moai_adk-0.10.1.dist-info → moai_adk-0.11.0.dist-info}/licenses/LICENSE +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: moai-adk
3
- Version: 0.10.1
3
+ Version: 0.11.0
4
4
  Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0
5
5
  Project-URL: Homepage, https://github.com/modu-ai/moai-adk
6
6
  Project-URL: Repository, https://github.com/modu-ai/moai-adk
@@ -14,17 +14,21 @@ Classifier: Development Status :: 4 - Beta
14
14
  Classifier: Intended Audience :: Developers
15
15
  Classifier: License :: OSI Approved :: MIT License
16
16
  Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
17
19
  Classifier: Programming Language :: Python :: 3.13
18
20
  Classifier: Topic :: Software Development :: Libraries :: Python Modules
19
21
  Classifier: Topic :: Software Development :: Quality Assurance
20
22
  Classifier: Topic :: Software Development :: Testing
21
- Requires-Python: >=3.13
23
+ Requires-Python: >=3.11
22
24
  Requires-Dist: click>=8.1.0
23
25
  Requires-Dist: gitpython>=3.1.45
26
+ Requires-Dist: jinja2>=3.0.0
24
27
  Requires-Dist: packaging>=21.0
25
28
  Requires-Dist: pyfiglet>=1.0.2
26
29
  Requires-Dist: pyyaml>=6.0
27
30
  Requires-Dist: questionary>=2.0.0
31
+ Requires-Dist: requests>=2.28.0
28
32
  Requires-Dist: rich>=13.0.0
29
33
  Provides-Extra: dev
30
34
  Requires-Dist: mypy>=1.7.0; extra == 'dev'
@@ -158,6 +162,22 @@ From the moment you adopt MoAI-ADK, you'll feel:
158
162
 
159
163
  ---
160
164
 
165
+ ## 🖥️ Platform Support
166
+
167
+ ### Supported Platforms
168
+ - ✅ **macOS** (11.0+)
169
+ - ✅ **Linux** (Ubuntu 20.04+, Debian 11+, etc.)
170
+ - ✅ **Windows** (10/11) - Full support as of v0.11.0
171
+ - Note: Hooks system requires Python 3.11+
172
+ - All hook features work seamlessly on Windows with cross-platform timeout handling
173
+
174
+ ### System Requirements
175
+ - **Python**: 3.11 or higher
176
+ - **Git**: 2.30+
177
+ - **GitHub CLI** (`gh`): Optional, required for PR automation in team mode
178
+
179
+ ---
180
+
161
181
  ## ⚡ 3-Minute Lightning Start
162
182
 
163
183
  Get your first MoAI-ADK project running in **3 simple steps**. Beginners can finish in under 5 minutes.
@@ -390,11 +410,6 @@ my-project/
390
410
  │ ├── hooks/ # Event-driven automation
391
411
  │ │ └── alfred/
392
412
  │ │ └── alfred_hooks.py # 5 hooks (Session, PreTool, etc.)
393
- │ ├── output-styles/ # Response styles
394
- │ │ └── alfred/
395
- │ │ ├── agentic-coding.md # Professional development mode
396
- │ │ ├── moai-adk-learning.md # Educational explanations mode
397
- │ │ └── study-with-alfred.md # Interactive learning mode
398
413
  │ └── settings.json # Claude Code settings
399
414
  ├── src/ # Implementation code
400
415
  ├── tests/ # Test code
@@ -1770,7 +1785,7 @@ The **implementation-planner** Sub-agent decides:
1770
1785
 
1771
1786
  ```python
1772
1787
  # tests/test_todo_api.py
1773
- # @TEST:TODO-001 | SPEC: SPEC-TODO-001.md
1788
+ # @TEST:README-EXAMPLE-TODO | SPEC: SPEC-TODO-001.md
1774
1789
 
1775
1790
  import pytest
1776
1791
  from src.todo.api import create_todo, get_todos
@@ -1911,7 +1926,7 @@ git commit -m "♻️ refactor(TODO-001): add database models and validation"
1911
1926
 
1912
1927
  ```bash
1913
1928
  ✅ @SPEC:TODO-001 → .moai/specs/SPEC-TODO-001/spec.md
1914
- ✅ @TEST:TODO-001 → tests/test_todo_api.py
1929
+ ✅ @TEST:README-EXAMPLE-TODO → tests/test_todo_api.py
1915
1930
  ✅ @CODE:TODO-001 → src/todo/ (3 files)
1916
1931
  ✅ @DOC:TODO-001 → docs/api/todo.md (auto-generated)
1917
1932
 
@@ -1937,7 +1952,7 @@ git commit -m "♻️ refactor(TODO-001): add database models and validation"
1937
1952
  - Request: {"title": "string (1-200 chars)"}
1938
1953
  - Response: 201 Created with todo object
1939
1954
  - Implemented in: @CODE:TODO-001:API
1940
- - Tested in: @TEST:TODO-001
1955
+ - Tested in: @TEST:README-EXAMPLE-TODO
1941
1956
 
1942
1957
  ### Get All Todos
1943
1958
 
@@ -1988,7 +2003,7 @@ rg '@(SPEC|TEST|CODE|DOC):TODO-001' -n
1988
2003
 
1989
2004
  # Output:
1990
2005
  # .moai/specs/SPEC-TODO-001/spec.md:1: # @SPEC:TODO-001: Todo Management API
1991
- # tests/test_todo_api.py:2: # @TEST:TODO-001 | SPEC: SPEC-TODO-001.md
2006
+ # tests/test_todo_api.py:2: # @TEST:README-EXAMPLE-TODO | SPEC: SPEC-TODO-001.md
1992
2007
  # src/todo/api.py:5: # @CODE:TODO-001:API | SPEC: SPEC-TODO-001.md
1993
2008
  # src/todo/models.py:5: # @CODE:TODO-001:MODEL | SPEC: SPEC-TODO-001.md
1994
2009
  # docs/api/todo.md:1: # @DOC:TODO-001: Todo Management API
@@ -2028,7 +2043,7 @@ git log --oneline | head -5
2028
2043
  └─ 🔴 RED: Tests written first
2029
2044
  └─ 🟢 GREEN: Minimal implementation
2030
2045
  └─ ♻️ REFACTOR: Quality improvement
2031
- └─ @TEST:TODO-001, @CODE:TODO-001 TAGs assigned
2046
+ └─ @TEST:README-EXAMPLE-TODO, @CODE:TODO-001 TAGs assigned
2032
2047
  └─ 87% coverage, TRUST 5 principles verified
2033
2048
 
2034
2049
  ✅ Documentation sync (1 minute)
@@ -2599,7 +2614,7 @@ rg '@SPEC:HELLO-001' -n .moai/specs/
2599
2614
  /alfred:1-plan "feature description"
2600
2615
 
2601
2616
  # Or fix TAG in test file
2602
- # Edit tests/test_hello.py: @TEST:HELLO-001 → @TEST:HELLO-002
2617
+ # Edit tests/test_hello.py: @TEST:HELLO-001 → @TEST:README-EXAMPLE-HELLO
2603
2618
 
2604
2619
  # 4. Sync
2605
2620
  /alfred:3-sync
@@ -0,0 +1,77 @@
1
+ moai_adk/__init__.py,sha256=8E7tMBsxNR-EFqDY241RCJlSZEdCSigIbek2CiOzMBs,359
2
+ moai_adk/__main__.py,sha256=uo6p-EzHYCetlU3gGxGasiIkwGq6wlzag7RYtzieoJI,2421
3
+ moai_adk/cli/__init__.py,sha256=tidIaJnd4Pje_5QYRq7OvRRst4T3kaPlkw5QcPQ3l1Y,135
4
+ moai_adk/cli/main.py,sha256=mHACHi27AP2N7fg7zhzOo1tlF1Jrlw1_AcbxMfpGLVE,306
5
+ moai_adk/cli/commands/__init__.py,sha256=TrAIWcJRGXh1mY8itSzWm-W0nnybzQIFOuh6oksKWO0,680
6
+ moai_adk/cli/commands/backup.py,sha256=jKdm9P55RIIdaBLhXYDQdbn2ThQDVDrc9_No48uHB7A,2493
7
+ moai_adk/cli/commands/doctor.py,sha256=keyU2PwwiUGuQViQVDlXKCqLmi6F1JDW3JEOOY64wgk,9831
8
+ moai_adk/cli/commands/init.py,sha256=XidvHLZD-7_ZoHk-LcKmJaj78hhAjj7yB6LCBKHxx40,11459
9
+ moai_adk/cli/commands/status.py,sha256=FQgzz7GYKk1W-w08xBg1A1bziSGsE0qvXhQJrPjow8o,3796
10
+ moai_adk/cli/commands/update.py,sha256=ijCj3ssT8t1y7a7bAx0ebcx5KI_3kRXXEK-3lUnfRao,38107
11
+ moai_adk/cli/prompts/__init__.py,sha256=a4_ctS4KEvGtmM9j7z8XIlMkpftohjVb9woUwZu38gE,136
12
+ moai_adk/cli/prompts/init_prompts.py,sha256=OZ_T-b4XfkyXQsKXTwLcDYwmLbaf0k5oZfbi_asTH9M,5226
13
+ moai_adk/core/__init__.py,sha256=1sJO-PHEKF1NmYjeOPPPzn_HRgYln3CKlCpUH4E2Jrs,129
14
+ moai_adk/core/issue_creator.py,sha256=sKhZzXMTc5_8_CIEk7iYBSaCYfq8CawpWMgJjYFrpRE,9547
15
+ moai_adk/core/template_engine.py,sha256=1s7-Iwe2l8VW_-OaDfvKIropgk38evGsH0ci3_vZoRw,9224
16
+ moai_adk/core/config/__init__.py,sha256=30Qx-GSN1LLI_9ngNqQ6A6d40J92xK10AQxhKw1-MzU,328
17
+ moai_adk/core/config/migration.py,sha256=-rPC1C9EGcBvlCXnQoBOk5ktw7AXSJPX0TXsujr4r5A,3562
18
+ moai_adk/core/diagnostics/__init__.py,sha256=aF-qC2CW0wxZDpxnlh-TILYs3kqwOIj2EjXYEXY-2j8,387
19
+ moai_adk/core/diagnostics/slash_commands.py,sha256=cEH96M5RLxa1JLyoeoRqziBMzAbnN30j04YjNjxM7Ro,4682
20
+ moai_adk/core/git/__init__.py,sha256=Kpq2yU5X5bBBUV8ySYIB1_vMPvfdFS6hTYx2Ue-CoeQ,697
21
+ moai_adk/core/git/branch.py,sha256=BqbH20MT7NeSPwv8HbxJA29oXumLQWS_0f8gAjolfZo,617
22
+ moai_adk/core/git/branch_manager.py,sha256=K6SyO3vtVv111D2dudbSgyKBLlDX2aWTPj1qJV4PSMg,4143
23
+ moai_adk/core/git/checkpoint.py,sha256=tk23Wx5RtErwqCi6yRv_aaB92j2Z2rOiOule-DI1f9s,4358
24
+ moai_adk/core/git/commit.py,sha256=WBs6PucPoX3shVJqski7q7Is0n2Szku75jLA-JY-m_8,2038
25
+ moai_adk/core/git/event_detector.py,sha256=MI9byiAYZcUuXnXE6FZ1Lx7kG4EuJJxlBS7K_b1w0t0,2319
26
+ moai_adk/core/git/manager.py,sha256=pNqdW4ZON5OCXyrNxynR-ewzIDHYm9_NrgM9aOAOLKg,3634
27
+ moai_adk/core/project/__init__.py,sha256=w_VdJ6lJDkTMdYYEwj0Io6Ay3ekqsLO3qXInSfXX7Vs,134
28
+ moai_adk/core/project/backup_utils.py,sha256=-zEXIhGsM-MdX1voUIpKxLlR57Y-lqLEZSi8noeKV1E,1775
29
+ moai_adk/core/project/checker.py,sha256=B94mGLHDZkjQnFDgV8sknJDms5oIiHeyKcgxWI87-f8,9523
30
+ moai_adk/core/project/detector.py,sha256=ADVg36yvyqJEPQVNc_x9iInF9dzi7YZqqXfDq2XL17Q,4230
31
+ moai_adk/core/project/initializer.py,sha256=yqxePuCO2ednzCOpDZLczyCP079J6Io4pvtynTp4J6w,6724
32
+ moai_adk/core/project/phase_executor.py,sha256=qMUXiFfMVbziuKYXOUcIkhovdobDcvFYDX_TqqlJQpc,11158
33
+ moai_adk/core/project/validator.py,sha256=gH9ywTMQTwqtqBVrMWj5_bPYFrVzjHuFoU4QdeVa1O4,5756
34
+ moai_adk/core/quality/__init__.py,sha256=_uNsbThBLmVLWZCPmEgfFyQqJx3tdef9jhkP9QoHuJY,222
35
+ moai_adk/core/quality/trust_checker.py,sha256=CN067AiublAH46IBAKEV_I-8Wc0bNaR2dMnMf9n5oBg,15198
36
+ moai_adk/core/quality/validators/__init__.py,sha256=Q53sqQFOK7GnwshPVi0HvUSq_VCvHEL28-V5J_L9LoE,189
37
+ moai_adk/core/quality/validators/base_validator.py,sha256=8Fk5casPdfRtnlEfslIK6mOYsZeZLWIK_MAebWCrNw4,437
38
+ moai_adk/core/tags/__init__.py,sha256=nmZKs4eblrOzPg8JOHNkoaRzhPcUDGmMwvnUcyMZwGY,1985
39
+ moai_adk/core/tags/ci_validator.py,sha256=I9EM9Ymzob3jhrdjMEq_LyPis0In-0jmTmfqwvZOOUc,14660
40
+ moai_adk/core/tags/cli.py,sha256=1VWRT1k62FS5Yyzllat-nyLR3jqvGdyDkj1uOwPfavA,7344
41
+ moai_adk/core/tags/generator.py,sha256=xVopAAez8K5pNSHWZOGZXEWYIre53lTtfHUlR7i-vNE,3407
42
+ moai_adk/core/tags/inserter.py,sha256=_1lsMTyyrjGidAKqi4y925msHxK6gHLAsu3O8-O2vFM,2823
43
+ moai_adk/core/tags/mapper.py,sha256=ldcfMFzsk-ESKpXAptYydqx2NZ951utqKOXZVTHMeIE,3955
44
+ moai_adk/core/tags/parser.py,sha256=3LpNcL47xT3u4b3Fdf9wYnltChDrNAEV4EtnHqLN1MA,2098
45
+ moai_adk/core/tags/pre_commit_validator.py,sha256=Y1G8qtuRjCaHGjQ-Nxn8k2UGOcHRd3EfdZrSqCqHAY4,10230
46
+ moai_adk/core/tags/reporter.py,sha256=fn9kc0FNNvaep5cXbA2RkYxbJsw7eq2PHbrZ_XFB1Wc,29301
47
+ moai_adk/core/tags/tags.py,sha256=Fylt030vrDqhSWivwRbxxwu_uQhilei0SFk_xVzy9UI,4248
48
+ moai_adk/core/tags/validator.py,sha256=B3xUDubfyT5RlPM3GLYktfe1EQTEdxOrDhD230_etoA,31138
49
+ moai_adk/core/template/__init__.py,sha256=BB65Zkar2Oywt1_RFtQKIup6HXq20VNQrYqXD_Qp1_g,354
50
+ moai_adk/core/template/backup.py,sha256=44y3QGCKsYqrRPbzkB1xNM9qtpG6kNNMcWR8DnAcPiQ,3228
51
+ moai_adk/core/template/config.py,sha256=ZJU9UKSGF2tkPiwSFReoCkAHGQ0aN2jKmIIQt88x5-o,3532
52
+ moai_adk/core/template/languages.py,sha256=V0wLcxCIOve9Q_0_NhrHGQevSIN_MB612GwrOWZowL4,1653
53
+ moai_adk/core/template/merger.py,sha256=ZV8_U1HZJ3bfAtgyNmSxgj8KdTMt4eUnUG6kVVRT7bE,6909
54
+ moai_adk/core/template/processor.py,sha256=_nYHiuN9PGzC3iE4X5SpRMFW-OTkI2u1dOAjD98axAk,19190
55
+ moai_adk/templates/.gitignore,sha256=6VNKResdDpyaii3cmJA4pOLwK2PhYARIWkUODYtKyxg,310
56
+ moai_adk/templates/CLAUDE.md,sha256=Db_m1X_u2I0-eW_t-WITywwmZL3e7doGtxSfDazqaRo,29916
57
+ moai_adk/templates/README.md,sha256=727KhnlpzLukiKRy4ZBZpcn1QL9XtXehv2TUbN9w1ak,8791
58
+ moai_adk/templates/__init__.py,sha256=6MV1gCB7PLZMiL4gaD_dZSKxtcQyo45MMTuN8fVdchA,104
59
+ moai_adk/templates/.git-hooks/pre-push,sha256=4BGVMllmG3c_4T1S_nVEWDGQbxeCDll-fIgxAUoSvrI,6468
60
+ moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md,sha256=rzTnwxhccYZO_yHqsW5FaxIMhggfLO9xJ6D1IYMEQqc,2153
61
+ moai_adk/templates/.github/ISSUE_TEMPLATE/spec.yml,sha256=fon91ozuKBeDwrw2BBuTSbkGApDEptNP9er5dW_-ZVc,5280
62
+ moai_adk/templates/.github/workflows/moai-gitflow.yml,sha256=S-x8_ugSVZqDQtP6hqVujvVx4YRjyST-h7CvIXab_Ao,8785
63
+ moai_adk/templates/.github/workflows/moai-release-create.yml,sha256=KrHGkAep6iRyeLUh3YEP1XJCY7UO28lzqQY_DmwFkvw,2956
64
+ moai_adk/templates/.github/workflows/moai-release-pipeline.yml,sha256=kVpRk_OFgz0AVctLRLA2ASN-G_-prAHTGI7tufe6Pd0,6319
65
+ moai_adk/templates/.github/workflows/release.yml,sha256=LR4TObpJ4K-Ef-40tAHkKtgxOpwQO--2W-mGx6ubtpM,1506
66
+ moai_adk/templates/.github/workflows/spec-issue-sync.yml,sha256=GIYeQQvwcoi0r-o85nEbSSLwT5EsrSEzJKLhLMX7GPk,6483
67
+ moai_adk/templates/.github/workflows/tag-validation.yml,sha256=0alx8CXaZUE1_xOMpeJSETegbed9jYgN4Qc8Yeg-OZ0,8551
68
+ moai_adk/templates/src/moai_adk/core/tags/pre_commit_validator.py,sha256=Y1G8qtuRjCaHGjQ-Nxn8k2UGOcHRd3EfdZrSqCqHAY4,10230
69
+ moai_adk/templates/src/moai_adk/core/tags/reporter.py,sha256=fn9kc0FNNvaep5cXbA2RkYxbJsw7eq2PHbrZ_XFB1Wc,29301
70
+ moai_adk/utils/__init__.py,sha256=VnVfQzzKHvKw4bNdEw5xdscnRQYFrnr-v_TOBr3naPs,225
71
+ moai_adk/utils/banner.py,sha256=znppKd5yo-tTqgyhgPVJjstrTrfcy_v3X1_RFQxP4Fk,1878
72
+ moai_adk/utils/logger.py,sha256=g-m07PGKjK2bKRIInfSn6m-024Bedai-pV_WjZKDeu8,5064
73
+ moai_adk-0.11.0.dist-info/METADATA,sha256=RxbIP8DQhO86Z1jXf6zj_Tew4mnTmjS1zx87hHRse8Y,94689
74
+ moai_adk-0.11.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
75
+ moai_adk-0.11.0.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
76
+ moai_adk-0.11.0.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
77
+ moai_adk-0.11.0.dist-info/RECORD,,
@@ -1,316 +0,0 @@
1
- ---
2
- name: cc-manager
3
- description: "Use when: When you need to create and optimize Claude Code command/agent/configuration files"
4
- tools: Read, Write, Edit, MultiEdit, Glob, Bash, WebFetch
5
- model: sonnet
6
- ---
7
-
8
- # Claude Code Manager - Control Tower (v3.0.0)
9
- > Operational orchestration agent for Claude Code standardization. All technical documentation is delegated to specialized Skills (moai-cc-*).
10
-
11
- **Primary Role**: Validate, create, and maintain Claude Code files with consistent standards. Delegate knowledge to Skills.
12
-
13
- ---
14
-
15
- ## 🔗 Knowledge Delegation (Critical: v3.0.0)
16
-
17
- **As of v3.0.0, all Claude Code knowledge is in specialized Skills:**
18
-
19
- | Request | Route To |
20
- |---------|----------|
21
- | Architecture decisions | `Skill("moai-cc-guide")` + workflows/ |
22
- | Hooks setup | `Skill("moai-cc-hooks")` |
23
- | Agent creation | `Skill("moai-cc-agents")` |
24
- | Command design | `Skill("moai-cc-commands")` |
25
- | Skill building | `Skill("moai-cc-skills")` |
26
- | settings.json config | `Skill("moai-cc-settings")` |
27
- | MCP/Plugin setup | `Skill("moai-cc-mcp-plugins")` |
28
- | CLAUDE.md authoring | `Skill("moai-cc-claude-md")` |
29
- | Memory optimization | `Skill("moai-cc-memory")` |
30
-
31
- **cc-manager's job**: Validate, create files, run verifications. NOT teach or explain.
32
-
33
- ---
34
-
35
- ## 🌍 Language Handling
36
-
37
- **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
38
-
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
63
-
64
- ---
65
-
66
- ## 🧰 Skill Activation
67
-
68
- **Automatic** (always load):
69
- - `Skill("moai-foundation-specs")` - SPEC structure validation
70
- - `Skill("moai-cc-guide")` - Decision trees & architecture
71
-
72
- **Conditional** (based on request):
73
- - `Skill("moai-alfred-language-detection")` - Detect project language
74
- - `Skill("moai-alfred-tag-scanning")` - Validate TAG chains
75
- - `Skill("moai-foundation-tags")` - TAG policy
76
- - `Skill("moai-foundation-trust")` - TRUST 5 validation
77
- - `Skill("moai-alfred-git-workflow")` - Git strategy impact
78
- - Domain skills (CLI/Data Science/Database/etc) - When relevant
79
- - Language skills (23 available) - Based on detected language
80
- - `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` - User clarification
81
-
82
- ---
83
-
84
- ## 🎯 Core Responsibilities
85
-
86
- ✅ **cc-manager DOES**:
87
- - Validate YAML frontmatter & file structure
88
- - Check naming conventions (kebab-case, ID patterns)
89
- - Enforce minimum permissions (principle of least privilege)
90
- - Create files from templates
91
- - Run batch verification across `.claude/` directory
92
- - Suggest specific, actionable fixes
93
- - Maintain version tracking & standards documentation
94
-
95
- ❌ **cc-manager DOES NOT**:
96
- - Explain Hooks/Agents/Commands syntax (→ Skills)
97
- - Teach Claude Code best practices (→ Skills)
98
- - Make architecture decisions (→ moai-cc-guide Skill)
99
- - Provide troubleshooting guides (→ Skills)
100
- - Document MCP configuration (→ moai-cc-mcp-plugins Skill)
101
-
102
- ---
103
-
104
- ## 📋 Standard Templates
105
-
106
- ### Command File Structure
107
-
108
- **Location**: `.claude/commands/`
109
-
110
- **Required YAML**:
111
- - `name` (kebab-case)
112
- - `description` (one-line)
113
- - `argument-hint` (array)
114
- - `tools` (list, min privileges)
115
- - `model` (haiku/sonnet)
116
-
117
- **Reference**: `Skill("moai-cc-commands")` SKILL.md
118
-
119
- ---
120
-
121
- ### Agent File Structure
122
-
123
- **Location**: `.claude/agents/`
124
-
125
- **Required YAML**:
126
- - `name` (kebab-case)
127
- - `description` (must include "Use PROACTIVELY for")
128
- - `tools` (min privileges, no `Bash(*)`)
129
- - `model` (sonnet/haiku)
130
-
131
- **Key Rule**: description includes "Use PROACTIVELY for [trigger conditions]"
132
-
133
- **Reference**: `Skill("moai-cc-agents")` SKILL.md
134
-
135
- ---
136
-
137
- ### Skill File Structure
138
-
139
- **Location**: `.claude/skills/`
140
-
141
- **Required YAML**:
142
- - `name` (kebab-case)
143
- - `description` (clear one-line)
144
- - `model` (haiku/sonnet)
145
-
146
- **Structure**:
147
- - SKILL.md (main content)
148
- - reference.md (optional, detailed docs)
149
- - examples.md (optional, code examples)
150
-
151
- **Reference**: `Skill("moai-cc-skills")` SKILL.md
152
-
153
- ---
154
-
155
- ## 🔍 Verification Checklist (Quick)
156
-
157
- ### All Files
158
- - [ ] YAML frontmatter valid & complete
159
- - [ ] Kebab-case naming (my-agent, my-command, my-skill)
160
- - [ ] No hardcoded secrets/tokens
161
-
162
- ### Commands
163
- - [ ] `description` is one-line, clear purpose
164
- - [ ] `tools` has minimum required only
165
- - [ ] Agent orchestration documented
166
-
167
- ### Agents
168
- - [ ] `description` includes "Use PROACTIVELY for"
169
- - [ ] `tools` specific patterns (not `Bash(*)`)
170
- - [ ] Proactive triggers clearly defined
171
-
172
- ### Skills
173
- - [ ] Supporting files (reference.md, examples.md) included if relevant
174
- - [ ] Progressive Disclosure structure
175
- - [ ] "Works Well With" section added
176
-
177
- ### settings.json
178
- - [ ] No syntax errors: `cat .claude/settings.json | jq .`
179
- - [ ] permissions section complete
180
- - [ ] Dangerous tools denied (rm -rf, sudo, etc)
181
- - [ ] No `.env` readable
182
-
183
- ---
184
-
185
- ## 🚀 Quick Workflows
186
-
187
- ### Create New Command
188
- ```bash
189
- @agent-cc-manager "Create command: /my-command
190
- - Purpose: [describe]
191
- - Arguments: [list]
192
- - Agents involved: [names]"
193
- ```
194
- **Then**: Reference `Skill("moai-cc-commands")` for detailed guidance
195
-
196
- ### Create New Agent
197
- ```bash
198
- @agent-cc-manager "Create agent: my-analyzer
199
- - Specialty: [describe]
200
- - Proactive triggers: [when to use]
201
- - Tool requirements: [what it needs]"
202
- ```
203
- **Then**: Reference `Skill("moai-cc-agents")` for patterns
204
-
205
- ### Verify All Standards
206
- ```bash
207
- @agent-cc-manager "Run full standards verification across .claude/"
208
- ```
209
- **Result**: Report of violations + fixes
210
-
211
- ### Setup Project Claude Code
212
- ```bash
213
- @agent-cc-manager "Initialize Claude Code for MoAI-ADK project"
214
- ```
215
- **Then**: Reference `Skill("moai-cc-guide")` → workflows/alfred-0-project-setup.md
216
-
217
- ---
218
-
219
- ## 🔧 Common Issues (Quick Fixes)
220
-
221
- **YAML syntax error**
222
- → Validate: `head -5 .claude/agents/my-agent.md`
223
-
224
- **Tool permission denied**
225
- → Check: `cat .claude/settings.json | jq '.permissions'`
226
-
227
- **Agent not recognized**
228
- → Verify: YAML frontmatter + kebab-case name + file in `.claude/agents/`
229
-
230
- **Skill not loading**
231
- → Verify: YAML + `ls -la .claude/skills/my-skill/` + restart Claude Code
232
-
233
- **Hook not running**
234
- → Check: Absolute path in settings.json + `chmod +x hook.sh` + JSON valid
235
-
236
- **Detailed troubleshooting**: `Skill("moai-cc-guide")` → README.md FAQ section
237
-
238
- ---
239
-
240
- ## 📖 When to Delegate to Skills
241
-
242
- | Scenario | Skill | Why |
243
- |----------|-------|-----|
244
- | "How do I...?" | moai-cc-* (specific) | All how-to guidance in Skills |
245
- | "What's the pattern?" | moai-cc-* (specific) | All patterns in Skills |
246
- | "Is this valid?" | Relevant cc-manager skill | Cc-manager validates |
247
- | "Fix this error" | moai-cc-* (specific) | Skills provide solutions |
248
- | "Choose architecture" | moai-cc-guide | Only guide has decision tree |
249
-
250
- ---
251
-
252
- ## 💡 Philosophy
253
-
254
- **v3.0.0 Design**: Separation of concerns
255
- - **Skills** = Pure knowledge (HOW to use Claude Code)
256
- - **cc-manager** = Operational orchestration (Apply standards)
257
- - **moai-cc-guide** = Architecture decisions (WHAT to use)
258
-
259
- **Result**:
260
- - ✅ DRY - No duplicate knowledge
261
- - ✅ Maintainable - Each component has one job
262
- - ✅ Scalable - New Skills don't bloat cc-manager
263
- - ✅ Progressive Disclosure - Load only what you need
264
-
265
- ---
266
-
267
- ## 📞 User Interactions
268
-
269
- **Ask cc-manager for**:
270
- - File creation ("Create agent...")
271
- - Validation ("Verify this...")
272
- - Fixes ("Fix the standards...")
273
-
274
- **Ask Skills for**:
275
- - Guidance ("How do I...")
276
- - Patterns ("Show me...")
277
- - Decisions ("Should I...")
278
-
279
- **Ask moai-cc-guide for**:
280
- - Architecture ("Agents vs Commands...")
281
- - Workflows ("/alfred:* integration...")
282
- - Roadmaps ("What's next...")
283
-
284
- ---
285
-
286
- ## ✨ Example: New Skill
287
-
288
- ```bash
289
- # Request to cc-manager
290
- @agent-cc-manager "Create skill: ears-pattern
291
- - Purpose: EARS syntax teaching
292
- - Model: haiku
293
- - Location: .claude/skills/ears-pattern/"
294
-
295
- # cc-manager validates, creates file, checks standards
296
-
297
- # User references skill:
298
- Skill("ears-pattern") # Now available in commands/agents
299
- ```
300
-
301
- ---
302
-
303
- ## 🔄 Autorun Conditions
304
-
305
- - **SessionStart**: Detect project + offer initial setup
306
- - **File creation**: Validate YAML + check standards
307
- - **Verification request**: Batch-check all `.claude/` files
308
- - **Update detection**: Alert if cc-manager itself is updated
309
-
310
- ---
311
-
312
- **Last Updated**: 2025-10-23
313
- **Version**: 3.0.0 (Refactored for Skills delegation)
314
- **Philosophy**: Lean operational agent + Rich knowledge in Skills
315
-
316
- For comprehensive guidance, reference the 9 specialized Skills in `.claude/skills/moai-cc-*/`.