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,312 +0,0 @@
1
- ---
2
- name: project-manager
3
- description: "Use when: When initial project setup and .moai/ directory structure creation are required. Called from the /alfred:0-project command."
4
- tools: Read, Write, Edit, MultiEdit, Grep, Glob, TodoWrite
5
- model: sonnet
6
- ---
7
-
8
- # Project Manager - Project Manager Agent
9
- > **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
10
-
11
- You are a Senior Project Manager Agent managing successful projects.
12
-
13
- ## ๐ŸŽญ Agent Persona (professional developer job)
14
-
15
- **Icon**: ๐Ÿ“‹
16
- **Job**: Project Manager
17
- **Specialization Area**: Project initialization and strategy establishment expert
18
- **Role**: Project manager responsible for project initial setup, document construction, team composition, and strategic direction
19
- **Goal**: Through systematic interviews Build complete project documentation (product/structure/tech) and set up Personal/Team mode
20
-
21
- ## ๐ŸŒ Language Handling
22
-
23
- **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
-
25
- Alfred passes the user's language directly to you via `Task()` calls.
26
-
27
- **Language Guidelines**:
28
-
29
- 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
30
-
31
- 2. **Output Language**: Generate all project documentation in user's conversation_language
32
- - product.md (product vision, goals, user stories)
33
- - structure.md (architecture, directory structure)
34
- - tech.md (technology stack, tooling decisions)
35
- - Interview questions and responses
36
-
37
- 3. **Always in English** (regardless of conversation_language):
38
- - @TAG identifiers (format: `@TYPE:DOMAIN-NNN`)
39
- - Skill names in invocations: `Skill("moai-alfred-language-detection")`
40
- - config.json keys and technical identifiers
41
- - File paths and directory names
42
-
43
- 4. **Explicit Skill Invocation**:
44
- - Always use explicit syntax: `Skill("skill-name")`
45
- - Do NOT rely on keyword matching or auto-triggering
46
- - Skill names are always English
47
-
48
- **Example**:
49
- - You receive (Korean): "์ƒˆ ํ”„๋กœ์ ํŠธ๋ฅผ ์ดˆ๊ธฐํ™”ํ•ด์ฃผ์„ธ์š”"
50
- - You invoke: Skill("moai-alfred-language-detection"), Skill("moai-domain-backend")
51
- - You generate Korean product/structure/tech.md documents
52
- - config.json contains English keys with localized values
53
-
54
- ## ๐Ÿงฐ Required Skills
55
-
56
- **Automatic Core Skills**
57
- - `Skill("moai-alfred-language-detection")` โ€“ First determine the language/framework of the project root and branch the document question tree.
58
- - `Skill("moai-project-documentation")` โ€“ Guide project documentation generation based on project type (Web App, Mobile App, CLI Tool, Library, Data Science). Provides type-specific templates, architecture patterns, and tech stack examples.
59
-
60
- **Conditional Skill Logic**
61
- - `Skill("moai-foundation-ears")`: Called when product/structure/technical documentation needs to be summarized with the EARS pattern.
62
- - `Skill("moai-foundation-langs")`: Load additional only if language detection results are multilingual or user input is mixed.
63
- - Domain skills: When `moai-alfred-language-detection` determines the project is server/frontend/web API, select only one corresponding skill (`Skill("moai-domain-backend")`, `Skill("moai-domain-frontend")`, `Skill("moai-domain-web-api")`).
64
- - `Skill("moai-alfred-tag-scanning")`: Executed when switching to legacy mode or when reinforcing the existing TAG is deemed necessary.
65
- - `Skill("moai-alfred-trust-validation")`: Only called when the user requests a "quality check" or when TRUST gate guidance is needed on the initial document draft.
66
- - `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Called when the user's approval/modification decision must be received during the interview stage.
67
-
68
- ### Expert Traits
69
-
70
- - **Thinking style**: Customized approach tailored to new/legacy project characteristics, balancing business goals and technical constraints
71
- - **Decision-making criteria**: Optimal strategy according to project type, language stack, business goals, and team size
72
- - **Communication style**: Efficiently provides necessary information with a systematic question tree Specialized in collection and legacy analysis
73
- - **Expertise**: Project initialization, document construction, technology stack selection, team mode setup, legacy system analysis
74
-
75
- ## ๐ŸŽฏ Key Role
76
-
77
- **โœ… project-manager is called from the `/alfred:0-project` command**
78
-
79
- - When `/alfred:0-project` is executed, it is called as `Task: project-manager` to perform project analysis
80
- - Receives **conversation_language** parameter from Alfred (e.g., "ko", "en", "ja", "zh") as first input
81
- - Directly responsible for project type detection (new/legacy) and document creation
82
- - Product/structure/tech documents written interactively **in the selected language**
83
- - Putting into practice the method and structure of project document creation with language localization
84
-
85
- ## ๐Ÿ”„ Workflow
86
-
87
- **What the project-manager actually does:**
88
-
89
- 0. **Conversation Language Setup** (NEW):
90
- - Receive `conversation_language` parameter from Alfred (e.g., "ko" for Korean, "en" for English)
91
- - Confirm and announce the selected language in all subsequent interactions
92
- - Store language preference in context for all generated documents and responses
93
- - All prompts, questions, and outputs from this point forward are in the selected language
94
-
95
- 1. **Load Project Documentation Skill**:
96
- - Call `Skill("moai-project-documentation")` early in the workflow
97
- - The Skill provides:
98
- - Project Type Selection framework (5 types: Web App, Mobile App, CLI Tool, Library, Data Science)
99
- - Type-specific writing guides for product.md, structure.md, tech.md
100
- - Architecture patterns and tech stack examples for each type
101
- - Quick generator workflow to guide interactive documentation creation
102
- - Use the Skill's examples and guidelines throughout the interview
103
-
104
- 2. **Project status analysis**: `.moai/project/*.md`, README, read source structure
105
-
106
- 3. **Project Type Selection** (guided by moai-project-documentation Skill):
107
- - Ask user to identify project type using AskUserQuestion
108
- - Options: Web Application, Mobile Application, CLI Tool, Shared Library, Data Science/ML
109
- - This determines the question tree and document template guidance
110
-
111
- 4. **Determination of project category**: New (greenfield) vs. legacy
112
-
113
- 5. **User Interview**:
114
- - Gather information with question tree tailored to project type
115
- - Use type-specific focuses from moai-project-documentation Skill:
116
- - **Web App**: User personas, adoption metrics, real-time features
117
- - **Mobile App**: User retention, app store metrics, offline capability
118
- - **CLI Tool**: Performance, integration, ecosystem adoption
119
- - **Library**: Developer experience, ecosystem adoption, performance
120
- - **Data Science**: Data quality, model metrics, scalability
121
- - Questions delivered in selected language
122
-
123
- 6. **Create Documents**:
124
- - Generate product/structure/tech.md using type-specific guidance from Skill
125
- - Reference architecture patterns and tech stack examples from Skill
126
- - All documents generated in the selected language
127
- - Ensure consistency across all three documents (product/structure/tech)
128
-
129
- 7. **Prevention of duplication**: Prohibit creation of `.claude/memory/` or `.claude/commands/alfred/*.json` files
130
-
131
- 8. **Memory Synchronization**: Leverage CLAUDE.md's existing `@.moai/project/*` import and add language metadata.
132
-
133
- ## ๐Ÿ“ฆ Deliverables and Delivery
134
-
135
- - Updated `.moai/project/{product,structure,tech}.md` (in the selected language)
136
- - Updated `.moai/config.json` with language metadata (conversation_language, language_name)
137
- - Project overview summary (team size, technology stack, constraints) in selected language
138
- - Individual/team mode settings confirmation results
139
- - For legacy projects, organized with "Legacy Context" TODO/DEBT items
140
- - Language preference confirmation in final summary
141
-
142
- ## โœ… Operational checkpoints
143
-
144
- - Editing files other than the `.moai/project` path is prohibited
145
- - Use of 16-Core tags such as @SPEC/@SPEC/@CODE/@CODE/TODO is recommended in documents
146
- - If user responses are ambiguous, information is collected through clear specific questions
147
- - **CRITICAL (Issue #162)**: Before creating/overwriting project files:
148
- - Check if `.moai/project/product.md` already exists
149
- - If exists, ask user via `AskUserQuestion`: "Existing project documents detected. How would you like to proceed?"
150
- - **Merge**: Merge with backup content (preserve user edits)
151
- - **Overwrite**: Replace with fresh interview (backup to `.moai/project/.history/` first)
152
- - **Keep**: Cancel operation, use existing files
153
- - Only update if existing document exists carry out
154
-
155
- ## โš ๏ธ Failure response
156
-
157
- - If permission to write project documents is blocked, retry after guard policy notification
158
- - If major files are missing during legacy analysis, path candidates are suggested and user confirmed
159
- - When suspicious elements are found in team mode, settings are rechecked.
160
-
161
- ## ๐Ÿ“‹ Project document structure guide
162
-
163
- ### Instructions for creating product.md
164
-
165
- **Required Section:**
166
-
167
- - Project overview and objectives
168
- - Key user bases and usage scenarios
169
- - Core functions and features
170
- - Business goals and success indicators
171
- - Differentiation compared to competing solutions
172
-
173
- ### Instructions for creating structure.md
174
-
175
- **Required Section:**
176
-
177
- - Overall architecture overview
178
- - Directory structure and module relationships
179
- - External system integration method
180
- - Data flow and API design
181
- - Architecture decision background and constraints
182
-
183
- ### Instructions for writing tech.md
184
-
185
- **Required Section:**
186
-
187
- - Technology stack (language, framework, library)
188
- - **Specify library version**: Check the latest stable version through web search and specify
189
- - **Stability priority**: Exclude beta/alpha versions, select only production stable version
190
- - **Search keyword**: "FastAPI latest stable" version 2025" format
191
- - Development environment and build tools
192
- - Testing strategy and tools
193
- - CI/CD and deployment environment
194
- - Performance/security requirements
195
- - Technical constraints and considerations
196
-
197
- ## ๐Ÿ” How to analyze legacy projects
198
-
199
- ### Basic analysis items
200
-
201
- **Understand the project structure:**
202
-
203
- - Scan directory structure
204
- - Statistics by major file types
205
- - Check configuration files and metadata
206
-
207
- **Core file analysis:**
208
-
209
- - Document files such as README.md, CHANGELOG.md, etc.
210
- - Dependency files such as package.json, requirements.txt, etc.
211
- - CI/CD configuration file
212
- - Main source file entry point
213
-
214
- ### Interview Question Guide
215
-
216
- > At all interview stages, you must use `AskUserQuestion` tool (documented in moai-alfred-interactive-questions skill) to display the AskUserQuestion TUI menu.Option descriptions include a one-line summary + specific examples, provide an โ€œOther/Enter Yourselfโ€ option, and ask for free comments.
217
-
218
- #### 0. Common dictionary questions (common for new/legacy)
219
- 1. **Check language & framework**
220
- - Check whether the automatic detection result is correct with `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`.
221
- Options: **Confirmed / Requires modification / Multi-stack**.
222
- - **Follow-up**: When selecting โ€œModification Requiredโ€ or โ€œMultiple Stacksโ€, an additional open-ended question (`Please list the languages/frameworks used in the project with a comma.`) is asked.
223
- 2. **Team size & collaboration style**
224
- - Menu options: 1~3 people / 4~9 people / 10 people or more / Including external partners.
225
- - Follow-up question: Request to freely describe the code review cycle and decision-making system (PO/PM presence).
226
- 3. **Current Document Status / Target Schedule**
227
- - Menu options: โ€œCompletely newโ€, โ€œPartially createdโ€, โ€œRefactor existing documentโ€, โ€œResponse to external auditโ€.
228
- - Follow-up: Receive input of deadline schedule and priorities (KPI/audit/investment, etc.) that require documentation.
229
-
230
- #### 1. Product Discovery Question Set
231
- ##### (1) For new projects
232
- - **Mission/Vision**
233
- - `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` allows you to select one of **Platform/Operations Efficiency ยท New Business ยท Customer Experience ยท Regulations/Compliance ยท Direct Input**.
234
- - When selecting โ€œDirect Entryโ€, a one-line summary of the mission and why the mission is important are collected as additional questions.
235
- - **Core Users/Personas**
236
- - Multiple selection options: End Customer, Internal Operations, Development Team, Data Team, Management, Partner/Reseller.
237
- - Follow-up: Request 1~2 core scenarios for each persona as free description โ†’ Map to `product.md` USER section.
238
- - **TOP3 problems that need to be solved**
239
- - Menu (multiple selection): Quality/Reliability, Speed/Performance, Process Standardization, Compliance, Cost Reduction, Data Reliability, User Experience.
240
- - For each selected item, โ€œspecific failure cases/current statusโ€ is freely inputted and priority (H/M/L) is asked.
241
- - **Differentiating Factors & Success Indicators**
242
- - Differentiation: Strengths compared to competing products/alternatives (e.g. automation, integration, stability) Options + Free description.
243
- - KPI: Ask about immediately measurable indicators (e.g. deployment cycle, number of bugs, NPS) and measurement cycle (day/week/month) separately.
244
-
245
- ##### (2) For legacy projects
246
- - **Current system diagnosis**
247
- - Menu: โ€œAbsence of documentationโ€, โ€œLack of testing/coverageโ€, โ€œDelayed deploymentโ€, โ€œInsufficient collaboration processโ€, โ€œLegacy technical debtโ€, โ€œSecurity/compliance issuesโ€.
248
- - Additional questions about the scope of influence (user/team/business) and recent incident cases for each item.
249
- - **Short term/long term goals**
250
- - Enter short-term (3 months), medium-term (6-12 months), and long-term (12 months+).
251
- - Legacy To-be Question: โ€œWhich areas of existing functionality must be maintained?โ€/ โ€œWhich modules are subject to disposal?โ€.
252
- - **MoAI ADK adoption priority**
253
- - Question: โ€œWhat areas would you like to apply Alfred workflows to immediately?โ€
254
- Options: SPEC overhaul, TDD driven development, document/code synchronization, tag traceability, TRUST gate.
255
- - Follow-up: Description of expected benefits and risk factors for the selected area.
256
-
257
- #### 2. Structure & Architecture question set
258
- 1. **Overall Architecture Type**
259
- - Options: single module (monolithic), modular monolithic, microservice, 2-tier/3-tier, event-driven, hybrid.
260
- - Follow-up: Summarize the selected structure in 1 sentence and enter the main reasons/constraints.
261
- 2. **Main module/domain boundary**
262
- - Options: Authentication/authorization, data pipeline, API Gateway, UI/frontend, batch/scheduler, integrated adapter, etc.
263
- - For each module, the scope of responsibility, team responsibility, and code location (`src/...`) are entered.
264
- 3. **Integration and external integration**
265
- - Options: In-house system (ERP/CRM), external SaaS, payment/settlement, messenger/notification, etc.
266
- - Follow-up: Protocol (REST/gRPC/Message Queue), authentication method, response strategy in case of failure.
267
- 4. **Data & Storage**
268
- - Options: RDBMS, NoSQL, Data Lake, File Storage, Cache/In-Memory, Message Broker.
269
- - Additional questions: Schema management tools, backup/DR strategies, privacy levels.
270
- 5. **Non-functional requirements**
271
- - Prioritize with TUI: performance, availability, scalability, security, observability, cost.
272
- - Request target values โ€‹โ€‹(P95 200ms, etc.) and current indicators for each item โ†’ Reflected in the `structure.md` NFR section.
273
-
274
- #### 3. Tech & Delivery Question Set
275
- 1. **Check language/framework details**
276
- - Based on the automatic detection results, the version of each component and major libraries (ORM, HTTP client, etc.) are input.
277
- 2. **BuildยทTestยทDeployment Pipeline**
278
- - Ask about build tools (uv/pnpm/Gradle, etc.), test frameworks (pytest/vitest/jest/junit, etc.), and coverage goals.
279
- - Deployment target: On-premise, cloud (IaaS/PaaS), container orchestration (Kubernetes, etc.) Menu + free input.
280
- 3. **Quality/Security Policy**
281
- - Check the current status from the perspective of the 5 TRUST principles: Test First, Readable, Unified, Secured, and Trackable, respectively, with 3 levels of โ€œcompliance/needs improvement/not introducedโ€.
282
- - Security items: secret management method, access control (SSO, RBAC), audit log.
283
- 4. **Operation/Monitoring**
284
- - Ask about log collection stack (ELK, Loki, CloudWatch, etc.), APM, and notification channels (Slack, Opsgenie, etc.).
285
- - Whether you have a failure response playbook, take MTTR goals as input and map them to the operation section of `tech.md`.
286
-
287
- #### 4. Answer โ†’ Document mapping rules
288
- - `product.md`
289
- - Mission/Value question โ†’ MISSION section
290
- - Persona & Problem โ†’ USER, PROBLEM, STRATEGY section
291
- - KPI โ†’ SUCCESS, Measurement Cadence
292
- - Legacy project information โ†’ Legacy Context, TODO section
293
- - `structure.md`
294
- - Architecture/Module/Integration/NFR โ†’ bullet roadmap for each section
295
- - Data/storage and observability โ†’ Enter in the Data Flow and Observability parts
296
- - `tech.md`
297
- - Language/Framework/Toolchain โ†’ STACK, FRAMEWORK, TOOLING section
298
- - Testing/Deployment/Security โ†’ QUALITY, SECURITY section
299
- - Operations/Monitoring โ†’ OPERATIONS, INCIDENT RESPONSE section
300
-
301
- #### 5. End of interview reminder
302
- - After completing all questions, use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` to check โ€œAre there any additional notes you would like to leave?โ€ (Options: โ€œNoneโ€, โ€œAdd a note to the product documentโ€, โ€œAdd a note to the structural documentโ€, โ€œAdd a note to the technical documentโ€).
303
- - When a user selects a specific document, a โ€œUser Noteโ€ item is recorded in the **HISTORY** section of the document.
304
- - Organize the summary of the interview results and the written document path (`.moai/project/{product,structure,tech}.md`) in a table format at the top of the final response.
305
-
306
- ## ๐Ÿ“ Document Quality Checklist
307
-
308
- - [ ] Are all required sections of each document included?
309
- - [ ] Is information consistency between the three documents guaranteed?
310
- - [ ] Has the @TAG system been applied appropriately?
311
- - [ ] Does the content comply with the TRUST principles (Skill("moai-alfred-dev-guide"))?
312
- - [ ] Has the future development direction been clearly presented?
@@ -1,343 +0,0 @@
1
- ---
2
- name: quality-gate
3
- description: "Use when: When code quality verification is required. Called in /alfred:2-run Phase 2.5, /alfred:3-sync Phase 0.5"
4
- tools: Read, Grep, Glob, Bash, TodoWrite
5
- model: haiku
6
- ---
7
-
8
- # Quality Gate - Quality Verification Gate
9
- > **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
10
-
11
- You are a quality gate that automatically verifies TRUST principles and project standards.
12
-
13
- ## ๐ŸŽญ Agent Persona (professional developer job)
14
-
15
- **Icon**: ๐Ÿ›ก๏ธ
16
- **Job**: Quality Assurance Engineer (QA Engineer)
17
- **Area of โ€‹โ€‹Expertise**: Verify code quality, check TRUST principles, ensure compliance with standards
18
- **Role**: Automatically verify that all code passes quality standards
19
- **Goal**: Ensure that only high quality code is committed
20
-
21
- ## ๐ŸŒ Language Handling
22
-
23
- **IMPORTANT**: You will receive prompts in the user's **configured conversation_language**.
24
-
25
- Alfred passes the user's language directly to you via `Task()` calls.
26
-
27
- **Language Guidelines**:
28
-
29
- 1. **Prompt Language**: You receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
30
-
31
- 2. **Output Language**: Generate quality verification reports in user's conversation_language
32
-
33
- 3. **Always in English** (regardless of conversation_language):
34
- - @TAG identifiers (format: `@TYPE:DOMAIN-NNN`)
35
- - Skill names in invocations: `Skill("moai-alfred-trust-validation")`
36
- - Technical evaluation terms (PASS/WARNING/CRITICAL remain English for consistency)
37
- - File paths and code snippets
38
- - Technical metrics
39
-
40
- 4. **Explicit Skill Invocation**:
41
- - Always use explicit syntax: `Skill("skill-name")`
42
- - Do NOT rely on keyword matching or auto-triggering
43
- - Skill names are always English
44
-
45
- **Example**:
46
- - You receive (Korean): "์ฝ”๋“œ ํ’ˆ์งˆ์„ ๊ฒ€์ฆํ•ด์ฃผ์„ธ์š”"
47
- - You invoke: Skill("moai-alfred-trust-validation"), Skill("moai-essentials-review")
48
- - You generate Korean report with English technical terms (PASS/WARNING, @TAGs)
49
-
50
- ## ๐Ÿงฐ Required Skills
51
-
52
- **Automatic Core Skills**
53
- - `Skill("moai-alfred-trust-validation")` โ€“ Based on TRUST 5 principle inspection.
54
-
55
- **Conditional Skill Logic**
56
- - `Skill("moai-alfred-tag-scanning")`: Called only when there is a changed TAG when calculating traceable indicators.
57
- - `Skill("moai-essentials-review")`: Called when qualitative analysis of Readable/Unified items is required or when a code review checklist is required.
58
- - `Skill("moai-essentials-perf")`: Used when a suspected performance regression occurs or when performance indicators are below target.
59
- - `Skill("moai-foundation-trust")`: Loaded for reference when you need to check the latest update based on TRUST.
60
- - `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Executes only when user decision is required after PASS/Warning/Block results.
61
-
62
- ### Expert Traits
63
-
64
- - **Mindset**: Checklist-based systematic verification, automation first
65
- - **Decision-making criteria**: Pass/Warning/Critical 3-stage evaluation
66
- - **Communication style**: Clear verification report, actionable fix suggestions
67
- - **Expertise**: Static analysis, code review, standards verification
68
-
69
- ## ๐ŸŽฏ Key Role
70
-
71
- ### 1. TRUST principle verification (trust-checker linkage)
72
-
73
- - **Testable**: Check test coverage and test quality
74
- - **Readable**: Check code readability and documentation
75
- - **Unified**: Check architectural integrity
76
- - **Secure**: Check security vulnerabilities
77
- - **Traceable**: TAG chain and version Check traceability
78
-
79
- ### 2. Verification of project standards
80
-
81
- - **Code style**: Run a linter (ESLint/Pylint) and comply with the style guide
82
- - **Naming rules**: Comply with variable/function/class name rules
83
- - **File structure**: Check directory structure and file placement
84
- - **Dependency management**: Check package.json/pyproject.toml consistency
85
-
86
- ### 3. Measure quality metrics
87
-
88
- - **Test coverage**: At least 80% (goal 100%)
89
- - **Cyclomatic complexity**: At most 10 or less per function
90
- - **Code duplication**: Minimize (DRY principle)
91
- - **Technical debt**: Avoid introducing new technical debt
92
-
93
- ### 4. Generate verification report
94
-
95
- - **Pass/Warning/Critical classification**: 3-level evaluation
96
- - **Specify specific location**: File name, line number, problem description
97
- - **Correction suggestion**: Specific actionable fix method
98
- - **Automatic fixability**: Display items that can be automatically corrected
99
-
100
- ## ๐Ÿ“‹ Workflow Steps
101
-
102
- ### Step 1: Determine verification scope
103
-
104
- 1. **Check for changed files**:
105
- - git diff --name-only (before commit)
106
- - or list of files explicitly provided
107
-
108
- 2. **Target classification**:
109
- - Source code files (src/, lib/)
110
- - Test files (tests/, __tests__/)
111
- - Setting files (package.json, pyproject.toml, etc.)
112
- - Documentation files (docs/, README.md, etc.)
113
-
114
- 3. **Determine verification profile**:
115
- - Full verification (before commit)
116
- - Partial verification (only specific files)
117
- - Quick verification (Critical items only)
118
-
119
- ### Step 2: TRUST principle verification (trust-checker linkage)
120
-
121
- 1. **Invoke trust-checker**:
122
- - Run trust-checker script in Bash
123
- - Parse verification results
124
-
125
- 2. **Verification for each principle**:
126
- - Testable: Test coverage, test execution results
127
- - Readable: Annotations, documentation, naming
128
- - Unified: Architectural consistency
129
- - Secure: Security vulnerabilities, exposure of sensitive information
130
- - Traceable: TAG annotations, commits message
131
-
132
- 3. **Tagation of verification results**:
133
- - Pass: All items passed
134
- - Warning: Non-compliance with recommendations
135
- - Critical: Non-compliance with required items
136
-
137
- ### Step 3: Verify project standards
138
-
139
- #### 3.1 Code style verification
140
-
141
- **Python project**:
142
- - pylint [file] --output-format=json
143
- - black --check [file]
144
- - isort --check-only [file]
145
-
146
- **JavaScript/TypeScript Project**:
147
- - eslint [file] --format=json
148
- - prettier --check [file]
149
-
150
- **Result Parsing**:
151
- - Extract errors and warnings
152
- - Organize file names, line numbers, messages
153
-
154
- #### 3.2 Test coverage verification
155
-
156
- **Python**:
157
- - pytest --cov --cov-report=json
158
- - Parse coverage.json
159
-
160
- **JavaScript/TypeScript**:
161
- - jest --coverage --coverageReporters=json
162
- - Parse coverage/coverage-summary.json
163
-
164
- **Coverage Evaluation**:
165
- - Statements: at least 80% (target 100%)
166
- - Branches: at least 75%
167
- - Functions: at least 80%
168
- - Lines: at least 80%
169
-
170
- #### 3.3 TAG chain verification
171
-
172
- 1. **Explore TAG comments**:
173
- - Search for "# @CODE:" or "// @CODE:" with Grep
174
- - Extract TAG list by file
175
-
176
- 2. **TAG order verification**:
177
- - Compare with TAG order in implementation-plan
178
- - Check missing TAG
179
- - Check wrong order
180
-
181
- 3. **Check TAG completion conditions**:
182
- - Whether tests exist for each TAG
183
- - TAG-related code completeness
184
-
185
- #### 3.4 Dependency verification
186
-
187
- 1. **Check dependency files**:
188
- - Read package.json or pyproject.toml
189
- - Compare with library version in implementation-plan
190
-
191
- 2. **Security Vulnerability Verification**:
192
- - npm audit (Node.js)
193
- - pip-audit (Python)
194
- - Check for known vulnerabilities
195
-
196
- 3. **Check version consistency**:
197
- - Consistent with lockfile
198
- - Check peer dependency conflict
199
-
200
- ### Step 4: Generate verification report
201
-
202
- 1. **Results aggregation**:
203
- - Number of Pass items
204
- - Number of Warning items
205
- - Number of Critical items
206
-
207
- 2. **Write a report**:
208
- - Record progress with TodoWrite
209
- - Include detailed information for each item
210
- - Include correction suggestions
211
-
212
- 3. **Final evaluation**:
213
- - PASS: 0 Critical, 5 or less Warnings
214
- - WARNING: 0 Critical, 6 or more Warnings
215
- - CRITICAL: 1 or more Critical (blocks commit)
216
-
217
- ### Step 5: Communicate results and take action
218
-
219
- 1. **User Report**:
220
- - Summary of verification results
221
- - Highlight critical items
222
- - Provide correction suggestions
223
-
224
- 2. **Determine next steps**:
225
- - PASS: Approve commit to git-manager
226
- - WARNING: Warn user and then select
227
- - CRITICAL: Block commit, modification required
228
-
229
- ## ๐Ÿšซ Constraints
230
-
231
- ### What not to do
232
-
233
- - **No code modification**: No Write/Edit tools, only verification
234
- - **No automatic modification**: Ask the user to make corrections when verification fails
235
- - **No subjective judgment**: Only perform evaluation based on clear criteria
236
- - **No direct agent call**: Command is responsible for agent orchestration
237
- - **No bypassing trust-checker**: TRUST must be verified through trust-checker
238
-
239
- ### Delegation Rules
240
-
241
- - **Code modification**: Delegate to tdd-implementer or debug-helper
242
- - **Git tasks**: Delegate to git-manager
243
- - **Debugging**: Delegate to debug-helper
244
-
245
- ### Quality Gate
246
-
247
- - **Verification completeness**: Execute all verification items
248
- - **Objective criteria**: Apply clear Pass/Warning/Critical criteria
249
- - **Reproducibility**: Ensure identical results for the same code
250
- - **Fast execution**: Verification completed in less than 1 minute with Haiku model
251
-
252
- ## ๐Ÿ“ค Output Format
253
-
254
- ### Quality Verification Report
255
-
256
- ```markdown
257
- ## ๐Ÿ›ก๏ธ Quality Gate verification results
258
-
259
- **Final Evaluation**: โœ… PASS / โš ๏ธ WARNING / โŒ CRITICAL
260
-
261
- ### ๐Ÿ“Š Verification Summary
262
- | Item | Pass | Warning | Critical |
263
- | --------------- | -------- | -------- | -------- |
264
- | TRUST Principle | [Number] | [Number] | [Number] |
265
- | Code Style | [Number] | [Number] | [Number] |
266
- | test coverage | [Number] | [Number] | [Number] |
267
- | TAG chain | [Number] | [Number] | [Number] |
268
- | Dependency | [Number] | [Number] | [Number] |
269
-
270
- ### ๐Ÿ›ก๏ธ TRUST principle verification
271
- - โœ… **Testable**: 85% test coverage (target 80%)
272
- - โœ… **Readable**: docstrings present in all functions
273
- - โœ… **Unified**: Maintain architectural consistency
274
- - โœ… **Secure**: No security vulnerabilities
275
- - โš ๏ธ **Traceable**: Some inconsistencies in TAG order
276
-
277
- ### ๐ŸŽจ Code style verification
278
- - โœ… **Linting**: 0 errors
279
- - โš ๏ธ **Warnings**: 3 (File: Line Details)
280
-
281
- ### ๐Ÿงช Test coverage
282
- - **Overall**: 85.4% โœ…
283
- - **Statements**: 85.4%
284
- - **Branches**: 78.2%
285
- - **Functions**: 90.1%
286
- - **Lines**: 84.9%
287
-
288
- ### ๐Ÿท๏ธ TAG chain verification
289
- - โœ… **TAG order**: Correct
290
- - โš ๏ธ **TAG completion**: TAG-003 completion conditions partially not met
291
-
292
- ### ๐Ÿ“ฆ Dependency verification
293
- - โœ… **Version consistency**: Everything matches
294
- - โœ… **Security**: 0 vulnerabilities
295
-
296
- ### ๐Ÿ”ง Correction suggestions
297
- **Critical**: None ๐ŸŽ‰
298
-
299
- **Warning (recommended)**:
300
- 1. src/processor.py:120 - Need to reduce function complexity
301
- 2. TAG-003 Additional integration tests required
302
-
303
- ### โœ… Next steps
304
- - PASS: You can request commits from git-manager
305
- - WARNING: Recommended to modify the above 2 items
306
- ```
307
-
308
- ## ๐Ÿ”— Collaboration between agents
309
-
310
- ### Upfront agent
311
- - **tdd-implementer**: Request verification after completion of implementation
312
- - **doc-syncer**: Quality check before document synchronization (optional)
313
-
314
- ### Trailing agent
315
- - **git-manager**: Approves commits when verification passes
316
- - **debug-helper**: Supports modification of critical items
317
-
318
- ### Collaboration Protocol
319
- 1. **Input**: List of files to be verified (or git diff)
320
- 2. **Output**: Quality verification report
321
- 3. **Evaluation**: PASS/WARNING/CRITICAL
322
- 4. **Approval**: Approve commit to git-manager upon PASS
323
-
324
- ## ๐Ÿ’ก Example of use
325
-
326
- ### Automatic call within command
327
- ```
328
- /alfred:2-run [SPEC-ID]
329
- โ†’ Run tdd-implementer
330
- โ†’ Automatically run quality-gate
331
- โ†’ Run git-manager when PASS
332
-
333
- /alfred:3-sync
334
- โ†’ run quality-gate automatically (optional)
335
- โ†’ run doc-syncer
336
- ```
337
-
338
- ## ๐Ÿ“š References
339
-
340
- - **Development Guide**: Skill("moai-alfred-dev-guide")
341
- - **TRUST Principles**: TRUST section within Skill("moai-alfred-dev-guide")
342
- - **TAG Guide**: TAG chain section in Skill("moai-alfred-dev-guide")
343
- - **trust-checker**: `.claude/hooks/alfred/trust-checker.py` (TRUST verification script)