moai-adk 0.15.1__py3-none-any.whl → 0.25.4__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 (417) hide show
  1. moai_adk/__init__.py +1 -2
  2. moai_adk/__main__.py +85 -2
  3. moai_adk/cli/__init__.py +0 -1
  4. moai_adk/cli/commands/__init__.py +0 -1
  5. moai_adk/cli/commands/analyze.py +127 -0
  6. moai_adk/cli/commands/backup.py +5 -3
  7. moai_adk/cli/commands/doctor.py +35 -11
  8. moai_adk/cli/commands/improve_user_experience.py +348 -0
  9. moai_adk/cli/commands/init.py +150 -23
  10. moai_adk/cli/commands/language.py +269 -0
  11. moai_adk/cli/commands/migrate.py +158 -0
  12. moai_adk/cli/commands/status.py +13 -12
  13. moai_adk/cli/commands/update.py +364 -60
  14. moai_adk/cli/commands/validate_links.py +118 -0
  15. moai_adk/cli/main.py +3 -2
  16. moai_adk/cli/prompts/init_prompts.py +79 -82
  17. moai_adk/core/__init__.py +0 -1
  18. moai_adk/core/analysis/__init__.py +9 -0
  19. moai_adk/core/analysis/session_analyzer.py +439 -0
  20. moai_adk/core/claude_integration.py +421 -0
  21. moai_adk/core/command_helpers.py +270 -0
  22. moai_adk/core/config/__init__.py +6 -0
  23. moai_adk/core/config/auto_spec_config.py +346 -0
  24. moai_adk/core/config/migration.py +133 -12
  25. moai_adk/core/context_manager.py +279 -0
  26. moai_adk/core/diagnostics/slash_commands.py +0 -1
  27. moai_adk/core/error_recovery_system.py +1289 -0
  28. moai_adk/core/git/__init__.py +0 -1
  29. moai_adk/core/git/branch.py +0 -1
  30. moai_adk/core/git/branch_manager.py +4 -4
  31. moai_adk/core/git/checkpoint.py +1 -5
  32. moai_adk/core/git/commit.py +0 -1
  33. moai_adk/core/git/event_detector.py +3 -5
  34. moai_adk/core/git/manager.py +0 -1
  35. moai_adk/core/hooks/post_tool_auto_spec_completion.py +925 -0
  36. moai_adk/core/integration/__init__.py +22 -0
  37. moai_adk/core/integration/engine.py +169 -0
  38. moai_adk/core/integration/integration_tester.py +225 -0
  39. moai_adk/core/integration/models.py +88 -0
  40. moai_adk/core/integration/utils.py +211 -0
  41. moai_adk/core/issue_creator.py +28 -18
  42. moai_adk/core/language_config.py +202 -0
  43. moai_adk/core/language_validator.py +556 -0
  44. moai_adk/core/mcp/setup.py +113 -0
  45. moai_adk/core/migration/__init__.py +18 -0
  46. moai_adk/core/migration/backup_manager.py +208 -0
  47. moai_adk/core/migration/file_migrator.py +218 -0
  48. moai_adk/core/migration/version_detector.py +143 -0
  49. moai_adk/core/migration/version_migrator.py +228 -0
  50. moai_adk/core/performance/__init__.py +6 -0
  51. moai_adk/core/performance/cache_system.py +318 -0
  52. moai_adk/core/performance/parallel_processor.py +116 -0
  53. moai_adk/core/project/__init__.py +0 -1
  54. moai_adk/core/project/backup_utils.py +2 -7
  55. moai_adk/core/project/checker.py +3 -3
  56. moai_adk/core/project/detector.py +20 -40
  57. moai_adk/core/project/initializer.py +42 -17
  58. moai_adk/core/project/phase_executor.py +415 -58
  59. moai_adk/core/project/validator.py +6 -25
  60. moai_adk/core/quality/__init__.py +1 -1
  61. moai_adk/core/quality/trust_checker.py +64 -110
  62. moai_adk/core/quality/validators/__init__.py +1 -1
  63. moai_adk/core/quality/validators/base_validator.py +1 -1
  64. moai_adk/core/rollback_manager.py +993 -0
  65. moai_adk/core/session_manager.py +667 -0
  66. moai_adk/core/spec/confidence_scoring.py +749 -0
  67. moai_adk/core/spec/ears_template_engine.py +1182 -0
  68. moai_adk/core/spec/quality_validator.py +721 -0
  69. moai_adk/core/spec_status_manager.py +488 -0
  70. moai_adk/core/template/__init__.py +0 -1
  71. moai_adk/core/template/backup.py +41 -1
  72. moai_adk/core/template/config.py +11 -12
  73. moai_adk/core/template/languages.py +0 -1
  74. moai_adk/core/template/merger.py +79 -22
  75. moai_adk/core/template/processor.py +614 -40
  76. moai_adk/core/template_engine.py +36 -27
  77. moai_adk/foundation/git/commit_templates.py +565 -0
  78. moai_adk/foundation/trust/trust_principles.py +725 -0
  79. moai_adk/foundation/trust/validation_checklist.py +1678 -0
  80. moai_adk/statusline/__init__.py +38 -0
  81. moai_adk/statusline/alfred_detector.py +107 -0
  82. moai_adk/statusline/config.py +364 -0
  83. moai_adk/statusline/enhanced_output_style_detector.py +364 -0
  84. moai_adk/statusline/git_collector.py +190 -0
  85. moai_adk/statusline/main.py +228 -0
  86. moai_adk/statusline/metrics_tracker.py +78 -0
  87. moai_adk/statusline/renderer.py +327 -0
  88. moai_adk/statusline/update_checker.py +135 -0
  89. moai_adk/statusline/version_reader.py +647 -0
  90. moai_adk/templates/.git-hooks/pre-commit +66 -0
  91. moai_adk/templates/.git-hooks/pre-push +116 -4
  92. moai_adk/templates/.github/workflows/moai-gitflow.yml +1 -7
  93. moai_adk/templates/.github/workflows/spec-issue-sync.yml +0 -1
  94. moai_adk/templates/.gitignore +44 -0
  95. moai_adk/templates/.mcp.json +22 -0
  96. moai_adk/templates/CLAUDE.md +450 -1071
  97. moai_adk/utils/__init__.py +0 -1
  98. moai_adk/utils/banner.py +0 -1
  99. moai_adk/utils/common.py +308 -0
  100. moai_adk/utils/link_validator.py +249 -0
  101. moai_adk/utils/logger.py +4 -9
  102. moai_adk/utils/safe_file_reader.py +210 -0
  103. moai_adk/utils/user_experience.py +531 -0
  104. moai_adk-0.25.4.dist-info/METADATA +2279 -0
  105. moai_adk-0.25.4.dist-info/RECORD +112 -0
  106. moai_adk/core/tags/__init__.py +0 -86
  107. moai_adk/core/tags/ci_validator.py +0 -463
  108. moai_adk/core/tags/cli.py +0 -283
  109. moai_adk/core/tags/generator.py +0 -109
  110. moai_adk/core/tags/inserter.py +0 -99
  111. moai_adk/core/tags/mapper.py +0 -126
  112. moai_adk/core/tags/parser.py +0 -76
  113. moai_adk/core/tags/pre_commit_validator.py +0 -393
  114. moai_adk/core/tags/reporter.py +0 -956
  115. moai_adk/core/tags/tags.py +0 -149
  116. moai_adk/core/tags/validator.py +0 -897
  117. moai_adk/templates/.claude/agents/alfred/backend-expert.md +0 -319
  118. moai_adk/templates/.claude/agents/alfred/cc-manager.md +0 -316
  119. moai_adk/templates/.claude/agents/alfred/debug-helper.md +0 -208
  120. moai_adk/templates/.claude/agents/alfred/devops-expert.md +0 -464
  121. moai_adk/templates/.claude/agents/alfred/doc-syncer.md +0 -214
  122. moai_adk/templates/.claude/agents/alfred/frontend-expert.md +0 -357
  123. moai_adk/templates/.claude/agents/alfred/git-manager.md +0 -406
  124. moai_adk/templates/.claude/agents/alfred/implementation-planner.md +0 -423
  125. moai_adk/templates/.claude/agents/alfred/project-manager.md +0 -312
  126. moai_adk/templates/.claude/agents/alfred/quality-gate.md +0 -343
  127. moai_adk/templates/.claude/agents/alfred/skill-factory.md +0 -865
  128. moai_adk/templates/.claude/agents/alfred/spec-builder.md +0 -426
  129. moai_adk/templates/.claude/agents/alfred/tag-agent.md +0 -361
  130. moai_adk/templates/.claude/agents/alfred/tdd-implementer.md +0 -428
  131. moai_adk/templates/.claude/agents/alfred/trust-checker.md +0 -375
  132. moai_adk/templates/.claude/agents/alfred/ui-ux-expert.md +0 -571
  133. moai_adk/templates/.claude/commands/alfred/0-project.md +0 -1854
  134. moai_adk/templates/.claude/commands/alfred/1-plan.md +0 -880
  135. moai_adk/templates/.claude/commands/alfred/2-run.md +0 -793
  136. moai_adk/templates/.claude/commands/alfred/3-sync.md +0 -1084
  137. moai_adk/templates/.claude/commands/alfred/9-feedback.md +0 -149
  138. moai_adk/templates/.claude/hooks/alfred/core/project.py +0 -748
  139. moai_adk/templates/.claude/hooks/alfred/core/timeout.py +0 -136
  140. moai_adk/templates/.claude/hooks/alfred/core/ttl_cache.py +0 -108
  141. moai_adk/templates/.claude/hooks/alfred/core/version_cache.py +0 -198
  142. moai_adk/templates/.claude/hooks/alfred/handlers/__init__.py +0 -29
  143. moai_adk/templates/.claude/hooks/alfred/post_tool__log_changes.py +0 -94
  144. moai_adk/templates/.claude/hooks/alfred/pre_tool__auto_checkpoint.py +0 -100
  145. moai_adk/templates/.claude/hooks/alfred/session_end__cleanup.py +0 -94
  146. moai_adk/templates/.claude/hooks/alfred/session_start__show_project_info.py +0 -94
  147. moai_adk/templates/.claude/hooks/alfred/shared/core/__init__.py +0 -170
  148. moai_adk/templates/.claude/hooks/alfred/shared/core/checkpoint.py +0 -271
  149. moai_adk/templates/.claude/hooks/alfred/shared/core/context.py +0 -67
  150. moai_adk/templates/.claude/hooks/alfred/shared/core/project.py +0 -749
  151. moai_adk/templates/.claude/hooks/alfred/shared/core/tags.py +0 -230
  152. moai_adk/templates/.claude/hooks/alfred/shared/core/version_cache.py +0 -198
  153. moai_adk/templates/.claude/hooks/alfred/shared/handlers/__init__.py +0 -21
  154. moai_adk/templates/.claude/hooks/alfred/shared/handlers/notification.py +0 -154
  155. moai_adk/templates/.claude/hooks/alfred/shared/handlers/session.py +0 -174
  156. moai_adk/templates/.claude/hooks/alfred/shared/handlers/tool.py +0 -87
  157. moai_adk/templates/.claude/hooks/alfred/shared/handlers/user.py +0 -61
  158. moai_adk/templates/.claude/hooks/alfred/user_prompt__jit_load_docs.py +0 -112
  159. moai_adk/templates/.claude/hooks/alfred/utils/__init__.py +0 -1
  160. moai_adk/templates/.claude/hooks/alfred/utils/timeout.py +0 -161
  161. moai_adk/templates/.claude/settings.json +0 -144
  162. moai_adk/templates/.claude/skills/moai-alfred-agent-guide/SKILL.md +0 -70
  163. moai_adk/templates/.claude/skills/moai-alfred-agent-guide/examples.md +0 -62
  164. moai_adk/templates/.claude/skills/moai-alfred-agent-guide/reference.md +0 -242
  165. moai_adk/templates/.claude/skills/moai-alfred-config-schema/SKILL.md +0 -56
  166. moai_adk/templates/.claude/skills/moai-alfred-config-schema/examples.md +0 -28
  167. moai_adk/templates/.claude/skills/moai-alfred-config-schema/reference.md +0 -444
  168. moai_adk/templates/.claude/skills/moai-alfred-context-budget/SKILL.md +0 -62
  169. moai_adk/templates/.claude/skills/moai-alfred-context-budget/examples.md +0 -28
  170. moai_adk/templates/.claude/skills/moai-alfred-context-budget/reference.md +0 -405
  171. moai_adk/templates/.claude/skills/moai-alfred-dev-guide/SKILL.md +0 -51
  172. moai_adk/templates/.claude/skills/moai-alfred-dev-guide/examples.md +0 -355
  173. moai_adk/templates/.claude/skills/moai-alfred-dev-guide/reference.md +0 -239
  174. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/SKILL.md +0 -113
  175. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/examples.md +0 -29
  176. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/reference.md +0 -28
  177. moai_adk/templates/.claude/skills/moai-alfred-expertise-detection/SKILL.md +0 -323
  178. moai_adk/templates/.claude/skills/moai-alfred-expertise-detection/examples.md +0 -286
  179. moai_adk/templates/.claude/skills/moai-alfred-expertise-detection/reference.md +0 -126
  180. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/SKILL.md +0 -122
  181. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/examples.md +0 -29
  182. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/reference.md +0 -29
  183. moai_adk/templates/.claude/skills/moai-alfred-gitflow-policy/SKILL.md +0 -74
  184. moai_adk/templates/.claude/skills/moai-alfred-gitflow-policy/examples.md +0 -4
  185. moai_adk/templates/.claude/skills/moai-alfred-gitflow-policy/reference.md +0 -269
  186. moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/SKILL.md +0 -237
  187. moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/examples.md +0 -615
  188. moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/reference.md +0 -653
  189. moai_adk/templates/.claude/skills/moai-alfred-issue-labels/SKILL.md +0 -19
  190. moai_adk/templates/.claude/skills/moai-alfred-issue-labels/examples.md +0 -4
  191. moai_adk/templates/.claude/skills/moai-alfred-issue-labels/reference.md +0 -150
  192. moai_adk/templates/.claude/skills/moai-alfred-language-detection/SKILL.md +0 -113
  193. moai_adk/templates/.claude/skills/moai-alfred-language-detection/examples.md +0 -29
  194. moai_adk/templates/.claude/skills/moai-alfred-language-detection/reference.md +0 -28
  195. moai_adk/templates/.claude/skills/moai-alfred-persona-roles/SKILL.md +0 -198
  196. moai_adk/templates/.claude/skills/moai-alfred-persona-roles/examples.md +0 -431
  197. moai_adk/templates/.claude/skills/moai-alfred-persona-roles/reference.md +0 -141
  198. moai_adk/templates/.claude/skills/moai-alfred-practices/SKILL.md +0 -89
  199. moai_adk/templates/.claude/skills/moai-alfred-practices/examples.md +0 -122
  200. moai_adk/templates/.claude/skills/moai-alfred-practices/reference.md +0 -369
  201. moai_adk/templates/.claude/skills/moai-alfred-proactive-suggestions/SKILL.md +0 -508
  202. moai_adk/templates/.claude/skills/moai-alfred-proactive-suggestions/examples.md +0 -481
  203. moai_adk/templates/.claude/skills/moai-alfred-proactive-suggestions/reference.md +0 -100
  204. moai_adk/templates/.claude/skills/moai-alfred-reporting/SKILL.md +0 -273
  205. moai_adk/templates/.claude/skills/moai-alfred-rules/SKILL.md +0 -77
  206. moai_adk/templates/.claude/skills/moai-alfred-rules/examples.md +0 -265
  207. moai_adk/templates/.claude/skills/moai-alfred-rules/reference.md +0 -539
  208. moai_adk/templates/.claude/skills/moai-alfred-session-state/SKILL.md +0 -19
  209. moai_adk/templates/.claude/skills/moai-alfred-session-state/examples.md +0 -4
  210. moai_adk/templates/.claude/skills/moai-alfred-session-state/reference.md +0 -84
  211. moai_adk/templates/.claude/skills/moai-alfred-spec-authoring/README.md +0 -137
  212. moai_adk/templates/.claude/skills/moai-alfred-spec-authoring/SKILL.md +0 -219
  213. moai_adk/templates/.claude/skills/moai-alfred-spec-authoring/examples/validate-spec.sh +0 -161
  214. moai_adk/templates/.claude/skills/moai-alfred-spec-authoring/examples.md +0 -541
  215. moai_adk/templates/.claude/skills/moai-alfred-spec-authoring/reference.md +0 -622
  216. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-extended/SKILL.md +0 -115
  217. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-extended/examples.md +0 -4
  218. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-extended/reference.md +0 -348
  219. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/SKILL.md +0 -113
  220. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/examples.md +0 -29
  221. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/reference.md +0 -28
  222. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/SKILL.md +0 -113
  223. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/examples.md +0 -29
  224. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/reference.md +0 -28
  225. moai_adk/templates/.claude/skills/moai-alfred-todowrite-pattern/SKILL.md +0 -19
  226. moai_adk/templates/.claude/skills/moai-alfred-todowrite-pattern/examples.md +0 -4
  227. moai_adk/templates/.claude/skills/moai-alfred-todowrite-pattern/reference.md +0 -211
  228. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/SKILL.md +0 -113
  229. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/examples.md +0 -29
  230. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/reference.md +0 -28
  231. moai_adk/templates/.claude/skills/moai-alfred-workflow/SKILL.md +0 -288
  232. moai_adk/templates/.claude/skills/moai-cc-agents/SKILL.md +0 -269
  233. moai_adk/templates/.claude/skills/moai-cc-agents/templates/agent-template.md +0 -32
  234. moai_adk/templates/.claude/skills/moai-cc-claude-md/SKILL.md +0 -298
  235. moai_adk/templates/.claude/skills/moai-cc-claude-md/templates/CLAUDE-template.md +0 -26
  236. moai_adk/templates/.claude/skills/moai-cc-commands/SKILL.md +0 -307
  237. moai_adk/templates/.claude/skills/moai-cc-commands/templates/command-template.md +0 -21
  238. moai_adk/templates/.claude/skills/moai-cc-hooks/SKILL.md +0 -252
  239. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/pre-bash-check.sh +0 -19
  240. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/preserve-permissions.sh +0 -19
  241. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/validate-bash-command.py +0 -24
  242. moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/SKILL.md +0 -199
  243. moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/templates/settings-mcp-template.json +0 -39
  244. moai_adk/templates/.claude/skills/moai-cc-memory/SKILL.md +0 -316
  245. moai_adk/templates/.claude/skills/moai-cc-memory/templates/session-summary-template.md +0 -18
  246. moai_adk/templates/.claude/skills/moai-cc-settings/SKILL.md +0 -263
  247. moai_adk/templates/.claude/skills/moai-cc-settings/templates/settings-complete-template.json +0 -30
  248. moai_adk/templates/.claude/skills/moai-cc-skill-descriptions/SKILL.md +0 -19
  249. moai_adk/templates/.claude/skills/moai-cc-skill-descriptions/examples.md +0 -4
  250. moai_adk/templates/.claude/skills/moai-cc-skill-descriptions/reference.md +0 -218
  251. moai_adk/templates/.claude/skills/moai-cc-skill-factory/CHECKLIST.md +0 -482
  252. moai_adk/templates/.claude/skills/moai-cc-skill-factory/EXAMPLES.md +0 -278
  253. moai_adk/templates/.claude/skills/moai-cc-skill-factory/INTERACTIVE-DISCOVERY.md +0 -524
  254. moai_adk/templates/.claude/skills/moai-cc-skill-factory/METADATA.md +0 -477
  255. moai_adk/templates/.claude/skills/moai-cc-skill-factory/PARALLEL-ANALYSIS-REPORT.md +0 -429
  256. moai_adk/templates/.claude/skills/moai-cc-skill-factory/PYTHON-VERSION-MATRIX.md +0 -391
  257. moai_adk/templates/.claude/skills/moai-cc-skill-factory/SKILL-FACTORY-WORKFLOW.md +0 -431
  258. moai_adk/templates/.claude/skills/moai-cc-skill-factory/SKILL-UPDATE-ADVISOR.md +0 -577
  259. moai_adk/templates/.claude/skills/moai-cc-skill-factory/SKILL.md +0 -271
  260. moai_adk/templates/.claude/skills/moai-cc-skill-factory/STEP-BY-STEP-GUIDE.md +0 -466
  261. moai_adk/templates/.claude/skills/moai-cc-skill-factory/STRUCTURE.md +0 -583
  262. moai_adk/templates/.claude/skills/moai-cc-skill-factory/WEB-RESEARCH.md +0 -526
  263. moai_adk/templates/.claude/skills/moai-cc-skill-factory/reference.md +0 -465
  264. moai_adk/templates/.claude/skills/moai-cc-skill-factory/scripts/generate-structure.sh +0 -328
  265. moai_adk/templates/.claude/skills/moai-cc-skill-factory/scripts/validate-skill.sh +0 -312
  266. moai_adk/templates/.claude/skills/moai-cc-skill-factory/templates/SKILL_TEMPLATE.md +0 -245
  267. moai_adk/templates/.claude/skills/moai-cc-skill-factory/templates/examples-template.md +0 -285
  268. moai_adk/templates/.claude/skills/moai-cc-skill-factory/templates/reference-template.md +0 -278
  269. moai_adk/templates/.claude/skills/moai-cc-skill-factory/templates/scripts-template.sh +0 -303
  270. moai_adk/templates/.claude/skills/moai-cc-skills/SKILL.md +0 -291
  271. moai_adk/templates/.claude/skills/moai-cc-skills/templates/SKILL-template.md +0 -15
  272. moai_adk/templates/.claude/skills/moai-design-systems/SKILL.md +0 -802
  273. moai_adk/templates/.claude/skills/moai-design-systems/examples.md +0 -1238
  274. moai_adk/templates/.claude/skills/moai-design-systems/reference.md +0 -673
  275. moai_adk/templates/.claude/skills/moai-domain-backend/SKILL.md +0 -290
  276. moai_adk/templates/.claude/skills/moai-domain-backend/examples.md +0 -1633
  277. moai_adk/templates/.claude/skills/moai-domain-backend/reference.md +0 -660
  278. moai_adk/templates/.claude/skills/moai-domain-cli-tool/SKILL.md +0 -123
  279. moai_adk/templates/.claude/skills/moai-domain-cli-tool/examples.md +0 -29
  280. moai_adk/templates/.claude/skills/moai-domain-cli-tool/reference.md +0 -30
  281. moai_adk/templates/.claude/skills/moai-domain-data-science/SKILL.md +0 -123
  282. moai_adk/templates/.claude/skills/moai-domain-data-science/examples.md +0 -29
  283. moai_adk/templates/.claude/skills/moai-domain-data-science/reference.md +0 -30
  284. moai_adk/templates/.claude/skills/moai-domain-database/SKILL.md +0 -123
  285. moai_adk/templates/.claude/skills/moai-domain-database/examples.md +0 -29
  286. moai_adk/templates/.claude/skills/moai-domain-database/reference.md +0 -30
  287. moai_adk/templates/.claude/skills/moai-domain-devops/SKILL.md +0 -124
  288. moai_adk/templates/.claude/skills/moai-domain-devops/examples.md +0 -29
  289. moai_adk/templates/.claude/skills/moai-domain-devops/reference.md +0 -31
  290. moai_adk/templates/.claude/skills/moai-domain-frontend/SKILL.md +0 -128
  291. moai_adk/templates/.claude/skills/moai-domain-frontend/examples.md +0 -29
  292. moai_adk/templates/.claude/skills/moai-domain-frontend/reference.md +0 -31
  293. moai_adk/templates/.claude/skills/moai-domain-ml/SKILL.md +0 -123
  294. moai_adk/templates/.claude/skills/moai-domain-ml/examples.md +0 -29
  295. moai_adk/templates/.claude/skills/moai-domain-ml/reference.md +0 -30
  296. moai_adk/templates/.claude/skills/moai-domain-mobile-app/SKILL.md +0 -123
  297. moai_adk/templates/.claude/skills/moai-domain-mobile-app/examples.md +0 -29
  298. moai_adk/templates/.claude/skills/moai-domain-mobile-app/reference.md +0 -30
  299. moai_adk/templates/.claude/skills/moai-domain-security/SKILL.md +0 -123
  300. moai_adk/templates/.claude/skills/moai-domain-security/examples.md +0 -29
  301. moai_adk/templates/.claude/skills/moai-domain-security/reference.md +0 -30
  302. moai_adk/templates/.claude/skills/moai-domain-web-api/SKILL.md +0 -123
  303. moai_adk/templates/.claude/skills/moai-domain-web-api/examples.md +0 -29
  304. moai_adk/templates/.claude/skills/moai-domain-web-api/reference.md +0 -30
  305. moai_adk/templates/.claude/skills/moai-essentials-debug/SKILL.md +0 -303
  306. moai_adk/templates/.claude/skills/moai-essentials-debug/examples.md +0 -1064
  307. moai_adk/templates/.claude/skills/moai-essentials-debug/reference.md +0 -1047
  308. moai_adk/templates/.claude/skills/moai-essentials-perf/SKILL.md +0 -113
  309. moai_adk/templates/.claude/skills/moai-essentials-perf/examples.md +0 -29
  310. moai_adk/templates/.claude/skills/moai-essentials-perf/reference.md +0 -28
  311. moai_adk/templates/.claude/skills/moai-essentials-refactor/SKILL.md +0 -113
  312. moai_adk/templates/.claude/skills/moai-essentials-refactor/examples.md +0 -29
  313. moai_adk/templates/.claude/skills/moai-essentials-refactor/reference.md +0 -28
  314. moai_adk/templates/.claude/skills/moai-essentials-review/SKILL.md +0 -113
  315. moai_adk/templates/.claude/skills/moai-essentials-review/examples.md +0 -29
  316. moai_adk/templates/.claude/skills/moai-essentials-review/reference.md +0 -28
  317. moai_adk/templates/.claude/skills/moai-foundation-ears/SKILL.md +0 -116
  318. moai_adk/templates/.claude/skills/moai-foundation-ears/examples.md +0 -29
  319. moai_adk/templates/.claude/skills/moai-foundation-ears/reference.md +0 -28
  320. moai_adk/templates/.claude/skills/moai-foundation-git/SKILL.md +0 -122
  321. moai_adk/templates/.claude/skills/moai-foundation-git/examples.md +0 -29
  322. moai_adk/templates/.claude/skills/moai-foundation-git/reference.md +0 -29
  323. moai_adk/templates/.claude/skills/moai-foundation-langs/SKILL.md +0 -113
  324. moai_adk/templates/.claude/skills/moai-foundation-langs/examples.md +0 -29
  325. moai_adk/templates/.claude/skills/moai-foundation-langs/reference.md +0 -28
  326. moai_adk/templates/.claude/skills/moai-foundation-specs/SKILL.md +0 -113
  327. moai_adk/templates/.claude/skills/moai-foundation-specs/examples.md +0 -29
  328. moai_adk/templates/.claude/skills/moai-foundation-specs/reference.md +0 -28
  329. moai_adk/templates/.claude/skills/moai-foundation-tags/SKILL.md +0 -113
  330. moai_adk/templates/.claude/skills/moai-foundation-tags/examples.md +0 -29
  331. moai_adk/templates/.claude/skills/moai-foundation-tags/reference.md +0 -28
  332. moai_adk/templates/.claude/skills/moai-foundation-trust/SKILL.md +0 -307
  333. moai_adk/templates/.claude/skills/moai-foundation-trust/examples.md +0 -0
  334. moai_adk/templates/.claude/skills/moai-foundation-trust/reference.md +0 -1099
  335. moai_adk/templates/.claude/skills/moai-lang-c/SKILL.md +0 -124
  336. moai_adk/templates/.claude/skills/moai-lang-c/examples.md +0 -29
  337. moai_adk/templates/.claude/skills/moai-lang-c/reference.md +0 -31
  338. moai_adk/templates/.claude/skills/moai-lang-cpp/SKILL.md +0 -124
  339. moai_adk/templates/.claude/skills/moai-lang-cpp/examples.md +0 -29
  340. moai_adk/templates/.claude/skills/moai-lang-cpp/reference.md +0 -31
  341. moai_adk/templates/.claude/skills/moai-lang-csharp/SKILL.md +0 -123
  342. moai_adk/templates/.claude/skills/moai-lang-csharp/examples.md +0 -29
  343. moai_adk/templates/.claude/skills/moai-lang-csharp/reference.md +0 -30
  344. moai_adk/templates/.claude/skills/moai-lang-dart/SKILL.md +0 -123
  345. moai_adk/templates/.claude/skills/moai-lang-dart/examples.md +0 -29
  346. moai_adk/templates/.claude/skills/moai-lang-dart/reference.md +0 -30
  347. moai_adk/templates/.claude/skills/moai-lang-go/SKILL.md +0 -127
  348. moai_adk/templates/.claude/skills/moai-lang-go/examples.md +0 -29
  349. moai_adk/templates/.claude/skills/moai-lang-go/reference.md +0 -31
  350. moai_adk/templates/.claude/skills/moai-lang-java/SKILL.md +0 -126
  351. moai_adk/templates/.claude/skills/moai-lang-java/examples.md +0 -29
  352. moai_adk/templates/.claude/skills/moai-lang-java/reference.md +0 -31
  353. moai_adk/templates/.claude/skills/moai-lang-javascript/SKILL.md +0 -125
  354. moai_adk/templates/.claude/skills/moai-lang-javascript/examples.md +0 -29
  355. moai_adk/templates/.claude/skills/moai-lang-javascript/reference.md +0 -32
  356. moai_adk/templates/.claude/skills/moai-lang-kotlin/SKILL.md +0 -124
  357. moai_adk/templates/.claude/skills/moai-lang-kotlin/examples.md +0 -29
  358. moai_adk/templates/.claude/skills/moai-lang-kotlin/reference.md +0 -31
  359. moai_adk/templates/.claude/skills/moai-lang-php/SKILL.md +0 -126
  360. moai_adk/templates/.claude/skills/moai-lang-php/examples.md +0 -29
  361. moai_adk/templates/.claude/skills/moai-lang-php/reference.md +0 -30
  362. moai_adk/templates/.claude/skills/moai-lang-python/SKILL.md +0 -433
  363. moai_adk/templates/.claude/skills/moai-lang-python/examples.md +0 -624
  364. moai_adk/templates/.claude/skills/moai-lang-python/reference.md +0 -316
  365. moai_adk/templates/.claude/skills/moai-lang-r/SKILL.md +0 -123
  366. moai_adk/templates/.claude/skills/moai-lang-r/examples.md +0 -29
  367. moai_adk/templates/.claude/skills/moai-lang-r/reference.md +0 -30
  368. moai_adk/templates/.claude/skills/moai-lang-ruby/SKILL.md +0 -124
  369. moai_adk/templates/.claude/skills/moai-lang-ruby/examples.md +0 -29
  370. moai_adk/templates/.claude/skills/moai-lang-ruby/reference.md +0 -31
  371. moai_adk/templates/.claude/skills/moai-lang-rust/SKILL.md +0 -127
  372. moai_adk/templates/.claude/skills/moai-lang-rust/examples.md +0 -29
  373. moai_adk/templates/.claude/skills/moai-lang-rust/reference.md +0 -31
  374. moai_adk/templates/.claude/skills/moai-lang-scala/SKILL.md +0 -125
  375. moai_adk/templates/.claude/skills/moai-lang-scala/examples.md +0 -29
  376. moai_adk/templates/.claude/skills/moai-lang-scala/reference.md +0 -30
  377. moai_adk/templates/.claude/skills/moai-lang-shell/SKILL.md +0 -123
  378. moai_adk/templates/.claude/skills/moai-lang-shell/examples.md +0 -29
  379. moai_adk/templates/.claude/skills/moai-lang-shell/reference.md +0 -30
  380. moai_adk/templates/.claude/skills/moai-lang-sql/SKILL.md +0 -124
  381. moai_adk/templates/.claude/skills/moai-lang-sql/examples.md +0 -29
  382. moai_adk/templates/.claude/skills/moai-lang-sql/reference.md +0 -31
  383. moai_adk/templates/.claude/skills/moai-lang-swift/SKILL.md +0 -123
  384. moai_adk/templates/.claude/skills/moai-lang-swift/examples.md +0 -29
  385. moai_adk/templates/.claude/skills/moai-lang-swift/reference.md +0 -30
  386. moai_adk/templates/.claude/skills/moai-lang-typescript/SKILL.md +0 -133
  387. moai_adk/templates/.claude/skills/moai-lang-typescript/examples.md +0 -29
  388. moai_adk/templates/.claude/skills/moai-lang-typescript/reference.md +0 -34
  389. moai_adk/templates/.claude/skills/moai-project-documentation.md +0 -622
  390. moai_adk/templates/.github/workflows/c-tag-validation.yml +0 -11
  391. moai_adk/templates/.github/workflows/cpp-tag-validation.yml +0 -11
  392. moai_adk/templates/.github/workflows/csharp-tag-validation.yml +0 -11
  393. moai_adk/templates/.github/workflows/dart-tag-validation.yml +0 -11
  394. moai_adk/templates/.github/workflows/go-tag-validation.yml +0 -130
  395. moai_adk/templates/.github/workflows/java-tag-validation.yml +0 -11
  396. moai_adk/templates/.github/workflows/javascript-tag-validation.yml +0 -135
  397. moai_adk/templates/.github/workflows/kotlin-tag-validation.yml +0 -11
  398. moai_adk/templates/.github/workflows/php-tag-validation.yml +0 -11
  399. moai_adk/templates/.github/workflows/python-tag-validation.yml +0 -118
  400. moai_adk/templates/.github/workflows/release.yml +0 -118
  401. moai_adk/templates/.github/workflows/ruby-tag-validation.yml +0 -11
  402. moai_adk/templates/.github/workflows/rust-tag-validation.yml +0 -11
  403. moai_adk/templates/.github/workflows/shell-tag-validation.yml +0 -11
  404. moai_adk/templates/.github/workflows/swift-tag-validation.yml +0 -11
  405. moai_adk/templates/.github/workflows/tag-report.yml +0 -269
  406. moai_adk/templates/.github/workflows/tag-validation.yml +0 -186
  407. moai_adk/templates/.github/workflows/typescript-tag-validation.yml +0 -154
  408. moai_adk/templates/.moai/config.json +0 -115
  409. moai_adk/templates/workflows/go-tag-validation.yml +0 -30
  410. moai_adk/templates/workflows/javascript-tag-validation.yml +0 -41
  411. moai_adk/templates/workflows/python-tag-validation.yml +0 -42
  412. moai_adk/templates/workflows/typescript-tag-validation.yml +0 -31
  413. moai_adk-0.15.1.dist-info/METADATA +0 -3094
  414. moai_adk-0.15.1.dist-info/RECORD +0 -365
  415. {moai_adk-0.15.1.dist-info → moai_adk-0.25.4.dist-info}/WHEEL +0 -0
  416. {moai_adk-0.15.1.dist-info → moai_adk-0.25.4.dist-info}/entry_points.txt +0 -0
  417. {moai_adk-0.15.1.dist-info → moai_adk-0.25.4.dist-info}/licenses/LICENSE +0 -0
@@ -1,144 +0,0 @@
1
- {
2
- "env": {
3
- "MOAI_RUNTIME": "python",
4
- "MOAI_AUTO_ROUTING": "true",
5
- "MOAI_PERFORMANCE_MONITORING": "true",
6
- "PYTHON_ENV": "{{PROJECT_MODE}}"
7
- },
8
- "hooks": {
9
- "SessionStart": [
10
- {
11
- "hooks": [
12
- {
13
- "command": "uv run .claude/hooks/alfred/session_start__show_project_info.py",
14
- "type": "command"
15
- }
16
- ]
17
- }
18
- ],
19
- "PreToolUse": [
20
- {
21
- "hooks": [
22
- {
23
- "command": "uv run .claude/hooks/alfred/pre_tool__auto_checkpoint.py",
24
- "type": "command"
25
- }
26
- ],
27
- "matcher": "Edit|Write|MultiEdit"
28
- }
29
- ],
30
- "UserPromptSubmit": [
31
- {
32
- "hooks": [
33
- {
34
- "command": "uv run .claude/hooks/alfred/user_prompt__jit_load_docs.py",
35
- "type": "command"
36
- }
37
- ]
38
- }
39
- ],
40
- "SessionEnd": [
41
- {
42
- "hooks": [
43
- {
44
- "command": "uv run .claude/hooks/alfred/session_end__cleanup.py",
45
- "type": "command"
46
- }
47
- ]
48
- }
49
- ],
50
- "PostToolUse": [
51
- {
52
- "hooks": [
53
- {
54
- "command": "uv run .claude/hooks/alfred/post_tool__log_changes.py",
55
- "type": "command"
56
- }
57
- ],
58
- "matcher": "Edit|Write|MultiEdit"
59
- }
60
- ]
61
- },
62
- "permissions": {
63
- "defaultMode": "default",
64
- "allow": [
65
- "Task",
66
- "Read",
67
- "Write",
68
- "Edit",
69
- "MultiEdit",
70
- "NotebookEdit",
71
- "Grep",
72
- "Glob",
73
- "TodoWrite",
74
- "WebFetch",
75
- "WebSearch",
76
- "BashOutput",
77
- "KillShell",
78
- "Bash(git:*)",
79
- "Bash(rg:*)",
80
- "Bash(ls:*)",
81
- "Bash(echo:*)",
82
- "Bash(which:*)",
83
- "Bash(make:*)",
84
- "Bash(python:*)",
85
- "Bash(python3:*)",
86
- "Bash(uv:*)",
87
- "Bash(pytest:*)",
88
- "Bash(mypy:*)",
89
- "Bash(ruff:*)",
90
- "Bash(black:*)",
91
- "Bash(coverage:*)",
92
- "Bash(moai-adk:*)",
93
- "Bash(alfred:*)",
94
- "Bash(gh pr create:*)",
95
- "Bash(gh pr view:*)",
96
- "Bash(gh pr list:*)",
97
- "Bash(gh pr merge:*)",
98
- "Bash(gh repo view:*)",
99
- "Bash(gh issue:*)",
100
- "Bash(mkdir:*)",
101
- "Bash(touch:*)",
102
- "Bash(cp:*)",
103
- "Bash(mv:*)",
104
- "Bash(tree:*)",
105
- "Bash(diff:*)",
106
- "Bash(wc:*)",
107
- "Bash(sort:*)",
108
- "Bash(uniq:*)"
109
- ],
110
- "ask": [
111
- "Bash(git push:*)",
112
- "Bash(git merge:*)",
113
- "Bash(gh pr merge:*)",
114
- "Bash(uv add:*)",
115
- "Bash(uv remove:*)",
116
- "Bash(pip install:*)",
117
- "Bash(pip3 install:*)",
118
- "Bash(rm:*)",
119
- "Bash(sudo:*)",
120
- "Bash(rm -rf:*)"
121
- ],
122
- "deny": [
123
- "Read(./.env)",
124
- "Read(./.env.*)",
125
- "Read(./secrets/**)",
126
- "Read(~/.ssh/**)",
127
- "Read(~/.aws/**)",
128
- "Read(~/.config/gcloud/**)",
129
- "Bash(rm -rf /:*)",
130
- "Bash(rm -rf /*:*)",
131
- "Bash(rm -rf C\\:/:*)",
132
- "Bash(rm -rf C\\:/*:*)",
133
- "Bash(del /S /Q C\\:/:*)",
134
- "Bash(rmdir /S /Q C\\:/:*)",
135
- "Bash(format:*)",
136
- "Bash(chmod -R 777:*)",
137
- "Bash(dd:*)",
138
- "Bash(mkfs:*)",
139
- "Bash(fdisk:*)",
140
- "Bash(reboot:*)",
141
- "Bash(shutdown:*)"
142
- ]
143
- }
144
- }
@@ -1,70 +0,0 @@
1
- ---
2
- name: moai-alfred-agent-guide
3
- description: "19-agent team structure, decision trees for agent selection, Haiku vs Sonnet model selection, and agent collaboration principles. Use when deciding which sub-agent to invoke, understanding team responsibilities, or learning multi-agent orchestration."
4
- allowed-tools: "Read, Glob, Grep"
5
- ---
6
-
7
- ## What It Does
8
-
9
- MoAI-ADK의 19개 Sub-agent 아키텍처, 어떤 agent를 선택할지 결정하는 트리, Haiku/Sonnet 모델 선택 기준을 정의합니다.
10
-
11
- ## When to Use
12
-
13
- - ✅ 어떤 sub-agent를 invoke할지 불명확
14
- - ✅ Agent 책임 범위 학습
15
- - ✅ Haiku vs Sonnet 모델 선택 필요
16
- - ✅ Multi-agent 협업 패턴 이해
17
-
18
- ## Agent Team at a Glance
19
-
20
- ### 10 Core Sub-agents (Sonnet)
21
- - spec-builder: SPEC 작성
22
- - tdd-implementer: TDD 구현 (RED → GREEN → REFACTOR)
23
- - doc-syncer: 문서 동기화
24
- - implementation-planner: 구현 전략
25
- - debug-helper: 오류 분석
26
- - quality-gate: TRUST 5 검증
27
- - tag-agent: TAG 체인 검증
28
- - git-manager: Git 워크플로우
29
- - Explore: 코드베이스 탐색
30
- - Plan: 작업 계획
31
-
32
- ### 4 Expert Agents (Sonnet - Proactively Triggered)
33
- - **backend-expert**: Backend 아키텍처, API 설계, 데이터베이스
34
- - **frontend-expert**: Frontend 아키텍처, 컴포넌트 설계, 상태 관리
35
- - **devops-expert**: DevOps 전략, 배포, 인프라
36
- - **ui-ux-expert**: UI/UX 설계, 접근성, 디자인 시스템 (Figma MCP)
37
-
38
- ### 6 Specialist Agents (Haiku)
39
- - project-manager: 프로젝트 초기화
40
- - skill-factory: Skill 생성/최적화
41
- - cc-manager: Claude Code 설정
42
- - cc-hooks: Hook 시스템
43
- - cc-mcp-plugins: MCP 서버
44
- - trust-checker: TRUST 검증
45
-
46
- ## Agent Selection Decision Tree
47
-
48
- ```
49
- Task Type?
50
- ├─ SPEC 작성/검증 → spec-builder
51
- ├─ TDD 구현 → tdd-implementer
52
- ├─ 문서 동기화 → doc-syncer
53
- ├─ 구현 계획 → implementation-planner
54
- ├─ 오류 분석 → debug-helper
55
- ├─ 품질 검증 → quality-gate + Skill("moai-foundation-trust")
56
- ├─ 코드베이스 탐색 → Explore
57
- ├─ Git 워크플로우 → git-manager
58
- └─ 전체 프로젝트 계획 → Plan
59
- ```
60
-
61
- ## Model Selection
62
-
63
- - **Sonnet**: Complex reasoning (spec-builder, tdd-implementer, implementation-planner)
64
- - **Haiku**: Fast execution (project-manager, quality-gate, git-manager)
65
-
66
- ---
67
-
68
- Learn more in `reference.md` for complete agent responsibilities, collaboration patterns, and advanced orchestration strategies.
69
-
70
- **Related Skills**: moai-alfred-rules, moai-alfred-practices
@@ -1,62 +0,0 @@
1
- # Agent Selection Examples
2
-
3
- ## Example 1: New Feature Request
4
-
5
- **User**: "Add two-factor authentication"
6
-
7
- **Decision Tree**:
8
- ```
9
- Task = Feature Implementation
10
-
11
- Create SPEC first? → YES
12
- Invoke: spec-builder
13
-
14
- Write Tests? → YES
15
- Invoke: tdd-implementer
16
-
17
- Need Code Review? → YES
18
- Invoke: quality-gate + Skill("moai-foundation-trust")
19
-
20
- Update Documentation? → YES
21
- Invoke: doc-syncer
22
- ```
23
-
24
- **Result**: Proper agent sequence avoids rework
25
-
26
- ---
27
-
28
- ## Example 2: Bug Fix Triage
29
-
30
- **Error**: "TypeError: undefined is not a function"
31
-
32
- **Agent Sequence**:
33
- 1. Invoke: debug-helper
34
- - Analyze stack trace
35
- - Identify root cause
36
- 2. Invoke: tdd-implementer
37
- - Write regression test
38
- - Fix implementation
39
- 3. Invoke: git-manager
40
- - Commit with @TAG
41
-
42
- ---
43
-
44
- ## Example 3: Large Codebase Exploration
45
-
46
- **Task**: "How is authentication implemented?"
47
-
48
- ✅ Correct:
49
- ```
50
- Invoke: Explore(prompt="Find auth flow, entry points, models")
51
- Result: Clear architecture map
52
- ```
53
-
54
- ❌ Wrong:
55
- ```
56
- Manual grep for 20+ files
57
- Result: Bloated context, still confused
58
- ```
59
-
60
- ---
61
-
62
- Learn more in `reference.md` for complete decision tree and multi-agent patterns.
@@ -1,242 +0,0 @@
1
- # CLAUDE-AGENTS-GUIDE.md
2
-
3
- > MoAI-ADK Agent Architecture & Decision Guide
4
-
5
- ---
6
-
7
- ## For Alfred: Why This Document Matters
8
-
9
- When Alfred reads this document:
10
-
11
- 1. Upon receiving a new task - Decide "Which Sub-agent should I invoke?"
12
- 2. When complex tasks are required - Determine sequence and collaboration patterns among multiple agents
13
- 3. When reviewing team structure - Verify responsibility scope of each agent
14
-
15
- Alfred's Decision Making:
16
-
17
- - "Should this task be handled by spec-builder or code-builder?"
18
- - "When should I invoke the Explore agent and when should I not?"
19
- - "Is the Haiku model sufficient for this task, or do I need Sonnet?"
20
-
21
- After reading this document:
22
-
23
- - Clearly understand the responsibility scope of 19 Sub-agents
24
- - Grasp how 55 Skills are organized by tier
25
- - Master Agent collaboration principles (Command Precedence, Single Responsibility, etc.)
26
- - Learn Haiku vs Sonnet model selection criteria
27
-
28
- ---
29
-
30
- → Related Documents:
31
-
32
- - [For Alfred's decision-making rules, see CLAUDE-RULES.md](./CLAUDE-RULES.md#skill-invocation-rules)
33
- - [For actual Agent invocation examples, see CLAUDE-PRACTICES.md](./CLAUDE-PRACTICES.md#practical-workflow-examples)
34
-
35
- ---
36
-
37
- ## 4-Layer Architecture
38
-
39
- | Layer | Owner | Purpose | Examples |
40
- | --------------- | ------------------ | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
41
- | **Commands** | User ↔ Alfred | Workflow entry points that establish the Plan → Run → Sync cadence | `/alfred:0-project`, `/alfred:1-plan`, `/alfred:2-run`, `/alfred:3-sync` |
42
- | **Sub-agents** | Alfred | Deep reasoning and decision making for each phase | project-manager, spec-builder, code-builder pipeline, doc-syncer |
43
- | **Skills (55)** | Claude Skills | Reusable knowledge capsules loaded just-in-time | Foundation (TRUST/TAG/Git), Essentials (debug/refactor/review), Alfred workflow, Domain & Language packs |
44
- | **Hooks** | Runtime guardrails | Fast validation + JIT context hints (<100 ms) | SessionStart status card, PreToolUse destructive-command blocker |
45
-
46
- ---
47
-
48
- ## Core Sub-agent Roster
49
-
50
- > Alfred + 10 core sub-agents + 6 zero-project specialists + 2 built-in Claude agents = **19-member team**
51
- >
52
- > **Note on Counting**: The "code-builder pipeline" is counted as 1 conceptual agent but implemented as 2 physical files (`implementation-planner` + `tdd-implementer`) for sequential RED → GREEN → REFACTOR execution. This maintains the 19-member team concept while acknowledging that 20 distinct agent files exist in `.claude/agents/alfred/`.
53
-
54
- | Sub-agent | Model | Phase | Responsibility | Trigger |
55
- | ---------------------------- | ------ | ----------- | ---------------------------------------------------------------------------------------------- | ---------------------------- |
56
- | **project-manager** 📋 | Sonnet | Init | Project bootstrap, metadata interview, mode selection | `/alfred:0-project` |
57
- | **spec-builder** 🏗️ | Sonnet | Plan | Plan board consolidation, EARS-based SPEC authoring | `/alfred:1-plan` |
58
- | **code-builder pipeline** 💎 | Sonnet | Run | Phase 1 `implementation-planner` → Phase 2 `tdd-implementer` to execute RED → GREEN → REFACTOR | `/alfred:2-run` |
59
- | **doc-syncer** 📖 | Haiku | Sync | Living documentation, README/CHANGELOG updates | `/alfred:3-sync` |
60
- | **tag-agent** 🏷️ | Haiku | Sync | TAG inventory, orphan detection, chain repair | `@agent-tag-agent` |
61
- | **git-manager** 🚀 | Haiku | Plan · Sync | GitFlow automation, Draft→Ready PR, auto-merge policy | `@agent-git-manager` |
62
- | **debug-helper** 🔍 | Sonnet | Run | Failure diagnosis, fix-forward guidance | `@agent-debug-helper` |
63
- | **trust-checker** ✅ | Haiku | All phases | TRUST 5 principle enforcement and risk flags | `@agent-trust-checker` |
64
- | **quality-gate** 🛡️ | Haiku | Sync | Coverage delta review, release gate validation | Auto during `/alfred:3-sync` |
65
- | **cc-manager** 🛠️ | Sonnet | Ops | Claude Code session tuning, Skill lifecycle management | `@agent-cc-manager` |
66
-
67
- The **code-builder pipeline** runs two Sonnet specialists in sequence: **implementation-planner** (strategy, libraries, TAG design) followed by **tdd-implementer** (RED → GREEN → REFACTOR execution).
68
-
69
- ---
70
-
71
- ## Expert Agents (Proactively Triggered by SPEC Keywords)
72
-
73
- | Expert Agent | Model | Specialty | Trigger Keywords | Trigger Source |
74
- | ----------------------- | ------ | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------- |
75
- | **backend-expert** 🔧 | Sonnet | Backend architecture, API design, database schema, microservices, authentication | 'backend', 'api', 'server', 'database', 'microservice', 'deployment', 'authentication' | implementation-planner |
76
- | **frontend-expert** 💻 | Sonnet | Frontend architecture, component design, state management, UI/UX implementation | 'frontend', 'ui', 'page', 'component', 'client-side', 'browser', 'web interface' | implementation-planner |
77
- | **devops-expert** 🚀 | Sonnet | DevOps strategy, deployment automation, containerization, CI/CD, cloud infrastructure | 'deployment', 'docker', 'kubernetes', 'ci/cd', 'pipeline', 'infrastructure', 'railway', 'vercel', 'aws' | implementation-planner |
78
- | **ui-ux-expert** 🎨 | Sonnet | UI/UX design, accessibility (WCAG 2.1 AA/AAA), design systems, Figma MCP, design-to-code | 'design', 'ux', 'ui', 'accessibility', 'a11y', 'user experience', 'wireframe', 'prototype', 'design system', 'figma', 'user research', 'persona', 'journey map' | implementation-planner |
79
-
80
- ### How Expert Agents Work
81
-
82
- 1. **Automatic Keyword Detection**: When `implementation-planner` analyzes a SPEC, it scans for expert trigger keywords
83
- 2. **Proactive Delegation**: If keywords match, `implementation-planner` automatically invokes the relevant expert agent(s)
84
- 3. **Expert Consultation**: Each expert provides domain-specific architecture guidance, technology recommendations, and risk analysis
85
- 4. **Integration**: Expert feedback is integrated into the implementation plan and tagged with `@EXPERT:DOMAIN` for traceability
86
-
87
- ### Example: Full-Stack Authentication SPEC
88
-
89
- ```
90
- SPEC Keywords: 'api', 'authentication', 'design', 'accessibility'
91
-
92
- → Trigger backend-expert (for API & auth architecture)
93
- → Trigger ui-ux-expert (for login UI & accessibility)
94
-
95
- Result:
96
- @SPEC:AUTH-001 | @EXPERT:BACKEND | @EXPERT:UIUX
97
-
98
- Implementation Plan includes:
99
- - Backend: JWT token strategy, rate limiting, audit logging
100
- - UI/UX: Accessible login form (WCAG 2.1 AA), error messaging
101
- ```
102
-
103
- ---
104
-
105
- ## Zero-project Specialists
106
-
107
- | Sub-agent | Model | Focus | Trigger |
108
- | -------------------------- | ------ | ----------------------------------------------------------- | ------------------------------- |
109
- | **language-detector** 🔍 | Haiku | Stack detection, language matrix | Auto during `/alfred:0-project` |
110
- | **backup-merger** 📦 | Sonnet | Backup restore, checkpoint diff | `@agent-backup-merger` |
111
- | **project-interviewer** 💬 | Sonnet | Requirement interviews, persona capture | `/alfred:0-project` Q&A |
112
- | **document-generator** 📝 | Haiku | Project docs seed (`product.md`, `structure.md`, `tech.md`) | `/alfred:0-project` |
113
- | **feature-selector** 🎯 | Haiku | Skill pack recommendation | `/alfred:0-project` |
114
- | **template-optimizer** ⚙️ | Haiku | Template cleanup, migration helpers | `/alfred:0-project` |
115
-
116
- > **Implementation Note**: Zero-project specialists may be embedded within other agents (e.g., functionality within `project-manager`) or implemented as dedicated Skills (e.g., `moai-alfred-language-detection`). For example, `language-detector` functionality is provided by the `moai-alfred-language-detection` Skill during `/alfred:0-project` initialization.
117
-
118
- ---
119
-
120
- ## Built-in Claude Agents
121
-
122
- | Agent | Model | Specialty | Invocation |
123
- | ------------------- | ------ | --------------------------------------------- | ---------------- |
124
- | **Explore** 🔍 | Haiku | Repository-wide search & architecture mapping | `@agent-Explore` |
125
- | **general-purpose** | Sonnet | General assistance | Automatic |
126
-
127
- ### Explore Agent Guide
128
-
129
- The **Explore** agent excels at navigating large codebases.
130
-
131
- **Use cases**:
132
-
133
- - ✅ **Code analysis** (understand complex implementations, trace dependencies, study architecture)
134
- - ✅ Search for specific keywords or patterns (e.g., "API endpoints", "authentication logic")
135
- - ✅ Locate files (e.g., `src/components/**/*.tsx`)
136
- - ✅ Understand codebase structure (e.g., "explain the project architecture")
137
- - ✅ Search across many files (Glob + Grep patterns)
138
-
139
- **Recommend Explore when**:
140
-
141
- - 🔍 You need to understand a complex structure
142
- - 🔍 The implementation spans multiple files
143
- - 🔍 You want the end-to-end flow of a feature
144
- - 🔍 Dependency relationships must be analyzed
145
- - 🔍 You're planning a refactor and need impact analysis
146
-
147
- **Usage**: Use `Task(subagent_type="Explore", ...)` for deep codebase analysis. Declare `thoroughness: quick|medium|very thorough` in the prompt.
148
-
149
- **Examples**:
150
-
151
- - Deep analysis: "Analyze TemplateProcessor class and its dependencies" (thoroughness: very thorough)
152
- - Domain search: "Find all AUTH-related files in SPEC/tests/src/docs" (thoroughness: medium)
153
- - Natural language: "Where is JWT authentication implemented?" → Alfred auto-delegates
154
-
155
- ---
156
-
157
- ## Claude Skills (55 packs)
158
-
159
- Alfred relies on 55 Claude Skills grouped by tier. Skills load via Progressive Disclosure: metadata is available at session start, full `SKILL.md` content loads when a sub-agent references it, and supporting templates stream only when required.
160
-
161
- **Skills Distribution by Tier**:
162
-
163
- | Tier | Count | Purpose |
164
- | --------------- | ------ | -------------------------------------------- |
165
- | Foundation | 6 | Core TRUST/TAG/SPEC/Git/EARS/Lang principles |
166
- | Essentials | 4 | Debug/Perf/Refactor/Review workflows |
167
- | Alfred | 11 | Internal workflow orchestration |
168
- | Domain | 10 | Specialized domain expertise |
169
- | Language | 23 | Language-specific best practices |
170
- | Claude Code Ops | 1 | Session management |
171
- | **Total** | **55** | Complete knowledge capsule library |
172
-
173
- **Foundation Tier (6)**: `moai-foundation-trust`, `moai-foundation-tags`, `moai-foundation-specs`, `moai-foundation-ears`, `moai-foundation-git`, `moai-foundation-langs` (TRUST/TAG/SPEC/EARS/Git/language detection)
174
-
175
- **Essentials Tier (4)**: `moai-essentials-debug`, `moai-essentials-perf`, `moai-essentials-refactor`, `moai-essentials-review` (Debug/Perf/Refactor/Review workflows)
176
-
177
- **Alfred Tier (11)**: `moai-alfred-code-reviewer`, `moai-alfred-debugger-pro`, `moai-alfred-ears-authoring`, `moai-alfred-git-workflow`, `moai-alfred-language-detection`, `moai-alfred-performance-optimizer`, `moai-alfred-refactoring-coach`, `moai-alfred-spec-metadata-validation`, `moai-alfred-tag-scanning`, `moai-alfred-trust-validation`, `moai-alfred-interactive-questions` (code review, debugging, EARS, Git, language detection, performance, refactoring, metadata, TAG scanning, trust validation, interactive questions)
178
-
179
- **Domain Tier (10)** — `moai-domain-backend`, `web-api`, `frontend`, `mobile-app`, `security`, `devops`, `database`, `data-science`, `ml`, `cli-tool`.
180
-
181
- **Language Tier (23)** — Python, TypeScript, Go, Rust, Java, Kotlin, Swift, Dart, C/C++, C#, Scala, Haskell, Elixir, Clojure, Lua, Ruby, PHP, JavaScript, SQL, Shell, Julia, R, plus supporting stacks.
182
-
183
- **Claude Code Ops (1)** — `moai-claude-code` manages session settings, output styles, and Skill deployment.
184
-
185
- Skills keep the core knowledge lightweight while allowing Alfred to assemble the right expertise for each request.
186
-
187
- ---
188
-
189
- ## Agent Collaboration Principles
190
-
191
- - **Command precedence**: Command instructions outrank agent guidelines; follow the command if conflicts occur.
192
- - **Single responsibility**: Each agent handles only its specialty.
193
- - **Zero overlapping ownership**: When unsure, hand off to the agent with the most direct expertise.
194
- - **Confidence reporting**: Always share confidence levels and identified risks when completing a task.
195
- - **Escalation path**: When blocked, escalate to Alfred with context, attempted steps, and suggested next actions.
196
-
197
- ---
198
-
199
- ## Model Selection Guide
200
-
201
- | Model | Primary use cases | Representative sub-agents | Why it fits |
202
- | --------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
203
- | **Claude 4.5 Haiku** | Documentation sync, TAG inventory, Git automation, rule-based checks | doc-syncer, tag-agent, git-manager, trust-checker, quality-gate, Explore | Fast, deterministic output for patterned or string-heavy work |
204
- | **Claude 4.5 Sonnet** | Planning, implementation, troubleshooting, session ops | Alfred, project-manager, spec-builder, code-builder pipeline, debug-helper, cc-manager | Deep reasoning, multi-step synthesis, creative problem solving |
205
-
206
- **Guidelines**:
207
-
208
- - Default to **Haiku** when the task is pattern-driven or requires rapid iteration; escalate to **Sonnet** for novel design, architecture, or ambiguous problem solving.
209
- - Record any manual model switch in the task notes (who, why, expected benefit).
210
- - Combine both models when needed: e.g., Sonnet plans a refactor, Haiku formats and validates the resulting docs.
211
-
212
- ---
213
-
214
- ## Agent Selection Decision Tree
215
-
216
- | Situation | Recommended Agent | Reason |
217
- | --------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------ |
218
- | Need codebase understanding | **Explore** | Specialized in rapid analysis of large projects. Understand entire structure with Glob + Grep patterns |
219
- | Write SPEC for new feature | **spec-builder** | Expert in EARS syntax + SPEC structure. Auto-manage YAML metadata + HISTORY |
220
- | Analyze bug causes | **debug-helper** | Expert in stack trace + error pattern analysis. Recommends fix-forward vs rollback |
221
- | Code implementation (TDD) | **code-builder pipeline** | Automates RED → GREEN → REFACTOR. Sequential execution of implementation-planner + tdd-implementer |
222
- | Need document sync | **doc-syncer** | Automates Living Documents. Generates README + CHANGELOG, verifies TAG chain |
223
- | Git/PR management | **git-manager** | Automates GitFlow + Draft→Ready. Creates feature branches + PRs |
224
- | Version release | **git-manager** | Automates releases. Generates CHANGELOG + creates tags + merges PR |
225
- | Verify TAG integrity | **tag-agent** | Specializes in TAG chain verification. Detects orphan TAGs + recommends fixes |
226
- | Verify code quality | **trust-checker** | Verifies TRUST 5 principles. Checks Test/Readable/Unified/Secured/Trackable |
227
- | Verify release gate | **quality-gate** | Coverage delta + security scan. Final verification before release |
228
- | Project initialization | **project-manager** | Metadata interview + mode selection. Dedicated to `/alfred:0-project` |
229
- | Claude Code session mgmt | **cc-manager** | Skill lifecycle + output style management. Specialized in session tuning |
230
-
231
- ---
232
-
233
- **Usage Examples**:
234
-
235
- - "User requests 'Add login feature'" → **spec-builder** (Write SPEC) → **code-builder pipeline** (Implement) → **doc-syncer** (Document)
236
- - "Tests are failing" → **debug-helper** (Analyze cause) → **code-builder pipeline** (Fix) → **trust-checker** (Re-verify quality)
237
- - "Prepare for release" → **quality-gate** (Final verification) → **git-manager** (PR merge + tag)
238
-
239
- ---
240
-
241
- **Last Updated**: 2025-10-27
242
- **Document Version**: v1.0.0
@@ -1,56 +0,0 @@
1
- ---
2
- name: moai-alfred-config-schema
3
- description: ".moai/config.json official schema documentation, structure validation, project metadata, language settings, and configuration migration guide. Use when setting up project configuration or understanding config.json structure."
4
- allowed-tools: "Read, Grep"
5
- ---
6
-
7
- ## What It Does
8
-
9
- `.moai/config.json` 파일의 공식 스키마와 각 필드의 목적, 유효한 값, 마이그레이션 규칙을 정의합니다.
10
-
11
- ## When to Use
12
-
13
- - ✅ Project 초기화 후 config.json 설정
14
- - ✅ config.json 스키마 이해
15
- - ✅ Language settings, git strategy, TAG configuration 변경
16
- - ✅ Legacy config 마이그레이션
17
-
18
- ## Schema Overview
19
-
20
- ```json
21
- {
22
- "version": "0.7.0",
23
- "project": {
24
- "name": "ProjectName",
25
- "codebase_language": "python",
26
- "conversation_language": "ko",
27
- "conversation_language_name": "Korean"
28
- },
29
- "language": {
30
- "conversation_language": "ko",
31
- "conversation_language_name": "Korean"
32
- },
33
- "git": {
34
- "strategy": "github-pr",
35
- "main_branch": "main",
36
- "protected": true
37
- },
38
- "tag": {
39
- "prefix_style": "DOMAIN-###"
40
- }
41
- }
42
- ```
43
-
44
- ## Top-Level Sections
45
-
46
- - **version**: Configuration version (do not edit)
47
- - **project**: Name, codebase language, conversation language
48
- - **language**: Multi-language support settings
49
- - **git**: GitHub workflow strategy
50
- - **tag**: TAG system configuration
51
-
52
- ---
53
-
54
- Learn more in `reference.md` for complete schema reference, validation rules, and migration examples.
55
-
56
- **Related Skills**: moai-alfred-dev-guide, moai-foundation-specs
@@ -1,28 +0,0 @@
1
- # Config.json Examples
2
-
3
- ## Example: Korean Project Setup
4
-
5
- ```json
6
- {
7
- "version": "0.7.0",
8
- "project": {
9
- "name": "MyKoreanProject",
10
- "codebase_language": "python",
11
- "conversation_language": "ko",
12
- "conversation_language_name": "Korean"
13
- },
14
- "language": {
15
- "conversation_language": "ko",
16
- "conversation_language_name": "Korean"
17
- },
18
- "git": {
19
- "strategy": "github-pr",
20
- "main_branch": "main",
21
- "protected": true
22
- }
23
- }
24
- ```
25
-
26
- ---
27
-
28
- Learn more in `reference.md`.