moai-adk 0.9.1__py3-none-any.whl → 0.11.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of moai-adk might be problematic. Click here for more details.

Files changed (260) hide show
  1. moai_adk/core/project/phase_executor.py +4 -0
  2. moai_adk/core/tags/ci_validator.py +33 -3
  3. moai_adk/core/template_engine.py +6 -2
  4. moai_adk/templates/.git-hooks/pre-push +143 -0
  5. moai_adk/templates/.github/workflows/moai-gitflow.yml +6 -1
  6. moai_adk/templates/.github/workflows/release.yml +6 -2
  7. moai_adk/templates/.github/workflows/tag-validation.yml +57 -8
  8. moai_adk/templates/CLAUDE.md +477 -28
  9. moai_adk/templates/README.md +256 -0
  10. {moai_adk-0.9.1.dist-info → moai_adk-0.11.0.dist-info}/METADATA +740 -90
  11. moai_adk-0.11.0.dist-info/RECORD +77 -0
  12. moai_adk/templates/.claude/agents/alfred/cc-manager.md +0 -316
  13. moai_adk/templates/.claude/agents/alfred/debug-helper.md +0 -208
  14. moai_adk/templates/.claude/agents/alfred/doc-syncer.md +0 -214
  15. moai_adk/templates/.claude/agents/alfred/git-manager.md +0 -406
  16. moai_adk/templates/.claude/agents/alfred/implementation-planner.md +0 -350
  17. moai_adk/templates/.claude/agents/alfred/project-manager.md +0 -273
  18. moai_adk/templates/.claude/agents/alfred/quality-gate.md +0 -343
  19. moai_adk/templates/.claude/agents/alfred/skill-factory.md +0 -865
  20. moai_adk/templates/.claude/agents/alfred/spec-builder.md +0 -287
  21. moai_adk/templates/.claude/agents/alfred/tag-agent.md +0 -287
  22. moai_adk/templates/.claude/agents/alfred/tdd-implementer.md +0 -326
  23. moai_adk/templates/.claude/agents/alfred/trust-checker.md +0 -375
  24. moai_adk/templates/.claude/commands/alfred/0-project.md +0 -1189
  25. moai_adk/templates/.claude/commands/alfred/1-plan.md +0 -728
  26. moai_adk/templates/.claude/commands/alfred/2-run.md +0 -545
  27. moai_adk/templates/.claude/commands/alfred/3-sync.md +0 -683
  28. moai_adk/templates/.claude/commands/alfred/9-feedback.md +0 -149
  29. moai_adk/templates/.claude/hooks/alfred/.moai/cache/version-check.json +0 -9
  30. moai_adk/templates/.claude/hooks/alfred/README.md +0 -343
  31. moai_adk/templates/.claude/hooks/alfred/TROUBLESHOOTING.md +0 -471
  32. moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py +0 -209
  33. moai_adk/templates/.claude/hooks/alfred/core/version_cache.py +0 -198
  34. moai_adk/templates/.claude/hooks/alfred/notification__handle_events.py +0 -102
  35. moai_adk/templates/.claude/hooks/alfred/post_tool__log_changes.py +0 -102
  36. moai_adk/templates/.claude/hooks/alfred/pre_tool__auto_checkpoint.py +0 -108
  37. moai_adk/templates/.claude/hooks/alfred/session_end__cleanup.py +0 -102
  38. moai_adk/templates/.claude/hooks/alfred/session_start__show_project_info.py +0 -102
  39. moai_adk/templates/.claude/hooks/alfred/shared/core/__init__.py +0 -170
  40. moai_adk/templates/.claude/hooks/alfred/shared/core/checkpoint.py +0 -271
  41. moai_adk/templates/.claude/hooks/alfred/shared/core/context.py +0 -67
  42. moai_adk/templates/.claude/hooks/alfred/shared/core/project.py +0 -683
  43. moai_adk/templates/.claude/hooks/alfred/shared/core/tags.py +0 -198
  44. moai_adk/templates/.claude/hooks/alfred/shared/core/version_cache.py +0 -198
  45. moai_adk/templates/.claude/hooks/alfred/shared/handlers/__init__.py +0 -21
  46. moai_adk/templates/.claude/hooks/alfred/shared/handlers/notification.py +0 -25
  47. moai_adk/templates/.claude/hooks/alfred/shared/handlers/session.py +0 -175
  48. moai_adk/templates/.claude/hooks/alfred/shared/handlers/tool.py +0 -90
  49. moai_adk/templates/.claude/hooks/alfred/shared/handlers/user.py +0 -61
  50. moai_adk/templates/.claude/hooks/alfred/stop__handle_interrupt.py +0 -102
  51. moai_adk/templates/.claude/hooks/alfred/subagent_stop__handle_subagent_end.py +0 -102
  52. moai_adk/templates/.claude/hooks/alfred/user_prompt__jit_load_docs.py +0 -120
  53. moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md +0 -640
  54. moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md +0 -696
  55. moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md +0 -474
  56. moai_adk/templates/.claude/settings.json +0 -144
  57. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/SKILL.md +0 -113
  58. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/examples.md +0 -29
  59. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/reference.md +0 -28
  60. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/SKILL.md +0 -122
  61. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/examples.md +0 -29
  62. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/reference.md +0 -29
  63. moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/SKILL.md +0 -237
  64. moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/examples.md +0 -615
  65. moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/reference.md +0 -653
  66. moai_adk/templates/.claude/skills/moai-alfred-language-detection/SKILL.md +0 -113
  67. moai_adk/templates/.claude/skills/moai-alfred-language-detection/examples.md +0 -29
  68. moai_adk/templates/.claude/skills/moai-alfred-language-detection/reference.md +0 -28
  69. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/SKILL.md +0 -113
  70. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/examples.md +0 -29
  71. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/reference.md +0 -28
  72. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/SKILL.md +0 -113
  73. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/examples.md +0 -29
  74. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/reference.md +0 -28
  75. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/SKILL.md +0 -113
  76. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/examples.md +0 -29
  77. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/reference.md +0 -28
  78. moai_adk/templates/.claude/skills/moai-cc-agents/SKILL.md +0 -269
  79. moai_adk/templates/.claude/skills/moai-cc-agents/templates/agent-template.md +0 -32
  80. moai_adk/templates/.claude/skills/moai-cc-claude-md/SKILL.md +0 -298
  81. moai_adk/templates/.claude/skills/moai-cc-claude-md/templates/CLAUDE-template.md +0 -26
  82. moai_adk/templates/.claude/skills/moai-cc-commands/SKILL.md +0 -307
  83. moai_adk/templates/.claude/skills/moai-cc-commands/templates/command-template.md +0 -21
  84. moai_adk/templates/.claude/skills/moai-cc-hooks/SKILL.md +0 -252
  85. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/pre-bash-check.sh +0 -19
  86. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/preserve-permissions.sh +0 -19
  87. moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/validate-bash-command.py +0 -24
  88. moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/SKILL.md +0 -199
  89. moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/templates/settings-mcp-template.json +0 -39
  90. moai_adk/templates/.claude/skills/moai-cc-memory/SKILL.md +0 -316
  91. moai_adk/templates/.claude/skills/moai-cc-memory/templates/session-summary-template.md +0 -18
  92. moai_adk/templates/.claude/skills/moai-cc-settings/SKILL.md +0 -263
  93. moai_adk/templates/.claude/skills/moai-cc-settings/templates/settings-complete-template.json +0 -30
  94. moai_adk/templates/.claude/skills/moai-cc-skills/SKILL.md +0 -291
  95. moai_adk/templates/.claude/skills/moai-cc-skills/templates/SKILL-template.md +0 -15
  96. moai_adk/templates/.claude/skills/moai-domain-backend/SKILL.md +0 -290
  97. moai_adk/templates/.claude/skills/moai-domain-backend/examples.md +0 -1633
  98. moai_adk/templates/.claude/skills/moai-domain-backend/reference.md +0 -660
  99. moai_adk/templates/.claude/skills/moai-domain-cli-tool/SKILL.md +0 -123
  100. moai_adk/templates/.claude/skills/moai-domain-cli-tool/examples.md +0 -29
  101. moai_adk/templates/.claude/skills/moai-domain-cli-tool/reference.md +0 -30
  102. moai_adk/templates/.claude/skills/moai-domain-data-science/SKILL.md +0 -123
  103. moai_adk/templates/.claude/skills/moai-domain-data-science/examples.md +0 -29
  104. moai_adk/templates/.claude/skills/moai-domain-data-science/reference.md +0 -30
  105. moai_adk/templates/.claude/skills/moai-domain-database/SKILL.md +0 -123
  106. moai_adk/templates/.claude/skills/moai-domain-database/examples.md +0 -29
  107. moai_adk/templates/.claude/skills/moai-domain-database/reference.md +0 -30
  108. moai_adk/templates/.claude/skills/moai-domain-devops/SKILL.md +0 -124
  109. moai_adk/templates/.claude/skills/moai-domain-devops/examples.md +0 -29
  110. moai_adk/templates/.claude/skills/moai-domain-devops/reference.md +0 -31
  111. moai_adk/templates/.claude/skills/moai-domain-frontend/SKILL.md +0 -124
  112. moai_adk/templates/.claude/skills/moai-domain-frontend/examples.md +0 -29
  113. moai_adk/templates/.claude/skills/moai-domain-frontend/reference.md +0 -31
  114. moai_adk/templates/.claude/skills/moai-domain-ml/SKILL.md +0 -123
  115. moai_adk/templates/.claude/skills/moai-domain-ml/examples.md +0 -29
  116. moai_adk/templates/.claude/skills/moai-domain-ml/reference.md +0 -30
  117. moai_adk/templates/.claude/skills/moai-domain-mobile-app/SKILL.md +0 -123
  118. moai_adk/templates/.claude/skills/moai-domain-mobile-app/examples.md +0 -29
  119. moai_adk/templates/.claude/skills/moai-domain-mobile-app/reference.md +0 -30
  120. moai_adk/templates/.claude/skills/moai-domain-security/SKILL.md +0 -123
  121. moai_adk/templates/.claude/skills/moai-domain-security/examples.md +0 -29
  122. moai_adk/templates/.claude/skills/moai-domain-security/reference.md +0 -30
  123. moai_adk/templates/.claude/skills/moai-domain-web-api/SKILL.md +0 -123
  124. moai_adk/templates/.claude/skills/moai-domain-web-api/examples.md +0 -29
  125. moai_adk/templates/.claude/skills/moai-domain-web-api/reference.md +0 -30
  126. moai_adk/templates/.claude/skills/moai-essentials-debug/SKILL.md +0 -303
  127. moai_adk/templates/.claude/skills/moai-essentials-debug/examples.md +0 -1064
  128. moai_adk/templates/.claude/skills/moai-essentials-debug/reference.md +0 -1047
  129. moai_adk/templates/.claude/skills/moai-essentials-perf/SKILL.md +0 -113
  130. moai_adk/templates/.claude/skills/moai-essentials-perf/examples.md +0 -29
  131. moai_adk/templates/.claude/skills/moai-essentials-perf/reference.md +0 -28
  132. moai_adk/templates/.claude/skills/moai-essentials-refactor/SKILL.md +0 -113
  133. moai_adk/templates/.claude/skills/moai-essentials-refactor/examples.md +0 -29
  134. moai_adk/templates/.claude/skills/moai-essentials-refactor/reference.md +0 -28
  135. moai_adk/templates/.claude/skills/moai-essentials-review/SKILL.md +0 -113
  136. moai_adk/templates/.claude/skills/moai-essentials-review/examples.md +0 -29
  137. moai_adk/templates/.claude/skills/moai-essentials-review/reference.md +0 -28
  138. moai_adk/templates/.claude/skills/moai-foundation-ears/SKILL.md +0 -116
  139. moai_adk/templates/.claude/skills/moai-foundation-ears/examples.md +0 -29
  140. moai_adk/templates/.claude/skills/moai-foundation-ears/reference.md +0 -28
  141. moai_adk/templates/.claude/skills/moai-foundation-git/SKILL.md +0 -122
  142. moai_adk/templates/.claude/skills/moai-foundation-git/examples.md +0 -29
  143. moai_adk/templates/.claude/skills/moai-foundation-git/reference.md +0 -29
  144. moai_adk/templates/.claude/skills/moai-foundation-langs/SKILL.md +0 -113
  145. moai_adk/templates/.claude/skills/moai-foundation-langs/examples.md +0 -29
  146. moai_adk/templates/.claude/skills/moai-foundation-langs/reference.md +0 -28
  147. moai_adk/templates/.claude/skills/moai-foundation-specs/SKILL.md +0 -113
  148. moai_adk/templates/.claude/skills/moai-foundation-specs/examples.md +0 -29
  149. moai_adk/templates/.claude/skills/moai-foundation-specs/reference.md +0 -28
  150. moai_adk/templates/.claude/skills/moai-foundation-tags/SKILL.md +0 -113
  151. moai_adk/templates/.claude/skills/moai-foundation-tags/examples.md +0 -29
  152. moai_adk/templates/.claude/skills/moai-foundation-tags/reference.md +0 -28
  153. moai_adk/templates/.claude/skills/moai-foundation-trust/SKILL.md +0 -307
  154. moai_adk/templates/.claude/skills/moai-foundation-trust/examples.md +0 -0
  155. moai_adk/templates/.claude/skills/moai-foundation-trust/reference.md +0 -1099
  156. moai_adk/templates/.claude/skills/moai-lang-c/SKILL.md +0 -124
  157. moai_adk/templates/.claude/skills/moai-lang-c/examples.md +0 -29
  158. moai_adk/templates/.claude/skills/moai-lang-c/reference.md +0 -31
  159. moai_adk/templates/.claude/skills/moai-lang-cpp/SKILL.md +0 -124
  160. moai_adk/templates/.claude/skills/moai-lang-cpp/examples.md +0 -29
  161. moai_adk/templates/.claude/skills/moai-lang-cpp/reference.md +0 -31
  162. moai_adk/templates/.claude/skills/moai-lang-csharp/SKILL.md +0 -123
  163. moai_adk/templates/.claude/skills/moai-lang-csharp/examples.md +0 -29
  164. moai_adk/templates/.claude/skills/moai-lang-csharp/reference.md +0 -30
  165. moai_adk/templates/.claude/skills/moai-lang-dart/SKILL.md +0 -123
  166. moai_adk/templates/.claude/skills/moai-lang-dart/examples.md +0 -29
  167. moai_adk/templates/.claude/skills/moai-lang-dart/reference.md +0 -30
  168. moai_adk/templates/.claude/skills/moai-lang-go/SKILL.md +0 -124
  169. moai_adk/templates/.claude/skills/moai-lang-go/examples.md +0 -29
  170. moai_adk/templates/.claude/skills/moai-lang-go/reference.md +0 -31
  171. moai_adk/templates/.claude/skills/moai-lang-java/SKILL.md +0 -124
  172. moai_adk/templates/.claude/skills/moai-lang-java/examples.md +0 -29
  173. moai_adk/templates/.claude/skills/moai-lang-java/reference.md +0 -31
  174. moai_adk/templates/.claude/skills/moai-lang-javascript/SKILL.md +0 -125
  175. moai_adk/templates/.claude/skills/moai-lang-javascript/examples.md +0 -29
  176. moai_adk/templates/.claude/skills/moai-lang-javascript/reference.md +0 -32
  177. moai_adk/templates/.claude/skills/moai-lang-kotlin/SKILL.md +0 -124
  178. moai_adk/templates/.claude/skills/moai-lang-kotlin/examples.md +0 -29
  179. moai_adk/templates/.claude/skills/moai-lang-kotlin/reference.md +0 -31
  180. moai_adk/templates/.claude/skills/moai-lang-php/SKILL.md +0 -123
  181. moai_adk/templates/.claude/skills/moai-lang-php/examples.md +0 -29
  182. moai_adk/templates/.claude/skills/moai-lang-php/reference.md +0 -30
  183. moai_adk/templates/.claude/skills/moai-lang-python/SKILL.md +0 -431
  184. moai_adk/templates/.claude/skills/moai-lang-python/examples.md +0 -624
  185. moai_adk/templates/.claude/skills/moai-lang-python/reference.md +0 -316
  186. moai_adk/templates/.claude/skills/moai-lang-r/SKILL.md +0 -123
  187. moai_adk/templates/.claude/skills/moai-lang-r/examples.md +0 -29
  188. moai_adk/templates/.claude/skills/moai-lang-r/reference.md +0 -30
  189. moai_adk/templates/.claude/skills/moai-lang-ruby/SKILL.md +0 -124
  190. moai_adk/templates/.claude/skills/moai-lang-ruby/examples.md +0 -29
  191. moai_adk/templates/.claude/skills/moai-lang-ruby/reference.md +0 -31
  192. moai_adk/templates/.claude/skills/moai-lang-rust/SKILL.md +0 -124
  193. moai_adk/templates/.claude/skills/moai-lang-rust/examples.md +0 -29
  194. moai_adk/templates/.claude/skills/moai-lang-rust/reference.md +0 -31
  195. moai_adk/templates/.claude/skills/moai-lang-scala/SKILL.md +0 -123
  196. moai_adk/templates/.claude/skills/moai-lang-scala/examples.md +0 -29
  197. moai_adk/templates/.claude/skills/moai-lang-scala/reference.md +0 -30
  198. moai_adk/templates/.claude/skills/moai-lang-shell/SKILL.md +0 -123
  199. moai_adk/templates/.claude/skills/moai-lang-shell/examples.md +0 -29
  200. moai_adk/templates/.claude/skills/moai-lang-shell/reference.md +0 -30
  201. moai_adk/templates/.claude/skills/moai-lang-sql/SKILL.md +0 -124
  202. moai_adk/templates/.claude/skills/moai-lang-sql/examples.md +0 -29
  203. moai_adk/templates/.claude/skills/moai-lang-sql/reference.md +0 -31
  204. moai_adk/templates/.claude/skills/moai-lang-swift/SKILL.md +0 -123
  205. moai_adk/templates/.claude/skills/moai-lang-swift/examples.md +0 -29
  206. moai_adk/templates/.claude/skills/moai-lang-swift/reference.md +0 -30
  207. moai_adk/templates/.claude/skills/moai-lang-typescript/SKILL.md +0 -127
  208. moai_adk/templates/.claude/skills/moai-lang-typescript/examples.md +0 -29
  209. moai_adk/templates/.claude/skills/moai-lang-typescript/reference.md +0 -34
  210. moai_adk/templates/.claude/skills/moai-skill-factory/CHECKLIST.md +0 -482
  211. moai_adk/templates/.claude/skills/moai-skill-factory/EXAMPLES.md +0 -278
  212. moai_adk/templates/.claude/skills/moai-skill-factory/INTERACTIVE-DISCOVERY.md +0 -524
  213. moai_adk/templates/.claude/skills/moai-skill-factory/METADATA.md +0 -477
  214. moai_adk/templates/.claude/skills/moai-skill-factory/PARALLEL-ANALYSIS-REPORT.md +0 -429
  215. moai_adk/templates/.claude/skills/moai-skill-factory/PYTHON-VERSION-MATRIX.md +0 -391
  216. moai_adk/templates/.claude/skills/moai-skill-factory/SKILL-FACTORY-WORKFLOW.md +0 -431
  217. moai_adk/templates/.claude/skills/moai-skill-factory/SKILL-UPDATE-ADVISOR.md +0 -577
  218. moai_adk/templates/.claude/skills/moai-skill-factory/SKILL.md +0 -271
  219. moai_adk/templates/.claude/skills/moai-skill-factory/STEP-BY-STEP-GUIDE.md +0 -466
  220. moai_adk/templates/.claude/skills/moai-skill-factory/STRUCTURE.md +0 -583
  221. moai_adk/templates/.claude/skills/moai-skill-factory/WEB-RESEARCH.md +0 -526
  222. moai_adk/templates/.claude/skills/moai-skill-factory/reference.md +0 -465
  223. moai_adk/templates/.claude/skills/moai-skill-factory/scripts/generate-structure.sh +0 -328
  224. moai_adk/templates/.claude/skills/moai-skill-factory/scripts/validate-skill.sh +0 -312
  225. moai_adk/templates/.claude/skills/moai-skill-factory/templates/SKILL_TEMPLATE.md +0 -245
  226. moai_adk/templates/.claude/skills/moai-skill-factory/templates/examples-template.md +0 -285
  227. moai_adk/templates/.claude/skills/moai-skill-factory/templates/reference-template.md +0 -278
  228. moai_adk/templates/.claude/skills/moai-skill-factory/templates/scripts-template.sh +0 -303
  229. moai_adk/templates/.claude/skills/moai-spec-authoring/README.md +0 -137
  230. moai_adk/templates/.claude/skills/moai-spec-authoring/SKILL.md +0 -219
  231. moai_adk/templates/.claude/skills/moai-spec-authoring/examples/validate-spec.sh +0 -161
  232. moai_adk/templates/.claude/skills/moai-spec-authoring/examples.md +0 -541
  233. moai_adk/templates/.claude/skills/moai-spec-authoring/reference.md +0 -622
  234. moai_adk/templates/.github/workflows/tag-report.yml +0 -261
  235. moai_adk/templates/.moai/config.json +0 -113
  236. moai_adk/templates/.moai/docs/quick-issue-creation-guide.md +0 -219
  237. moai_adk/templates/.moai/hooks/install.sh +0 -79
  238. moai_adk/templates/.moai/hooks/pre-commit.sh +0 -66
  239. moai_adk/templates/.moai/memory/CLAUDE-AGENTS-GUIDE.md +0 -208
  240. moai_adk/templates/.moai/memory/CLAUDE-PRACTICES.md +0 -369
  241. moai_adk/templates/.moai/memory/CLAUDE-RULES.md +0 -539
  242. moai_adk/templates/.moai/memory/DEVELOPMENT-GUIDE.md +0 -344
  243. moai_adk/templates/.moai/memory/GITFLOW-PROTECTION-POLICY.md +0 -220
  244. moai_adk/templates/.moai/memory/ISSUE-LABEL-MAPPING.md +0 -150
  245. moai_adk/templates/.moai/memory/SKILLS-DESCRIPTION-POLICY.md +0 -218
  246. moai_adk/templates/.moai/memory/SPEC-METADATA.md +0 -356
  247. moai_adk/templates/.moai/memory/gitflow-protection-policy.md +0 -220
  248. moai_adk/templates/.moai/memory/spec-metadata.md +0 -356
  249. moai_adk/templates/.moai/project/product.md +0 -161
  250. moai_adk/templates/.moai/project/structure.md +0 -156
  251. moai_adk/templates/.moai/project/tech.md +0 -227
  252. moai_adk/templates/src/moai_adk/core/__init__.py +0 -5
  253. moai_adk/templates/src/moai_adk/core/tags/__init__.py +0 -86
  254. moai_adk/templates/src/moai_adk/core/tags/ci_validator.py +0 -433
  255. moai_adk/templates/src/moai_adk/core/tags/cli.py +0 -283
  256. moai_adk/templates/src/moai_adk/core/tags/validator.py +0 -897
  257. moai_adk-0.9.1.dist-info/RECORD +0 -320
  258. {moai_adk-0.9.1.dist-info → moai_adk-0.11.0.dist-info}/WHEEL +0 -0
  259. {moai_adk-0.9.1.dist-info → moai_adk-0.11.0.dist-info}/entry_points.txt +0 -0
  260. {moai_adk-0.9.1.dist-info → moai_adk-0.11.0.dist-info}/licenses/LICENSE +0 -0
@@ -1,683 +0,0 @@
1
- ---
2
- name: alfred:3-sync
3
- description: "Document synchronization + PR Ready conversion"
4
- # Translations:
5
- # - ko: "문서 동기화 + PR Ready 전환"
6
- # - ja: "ドキュメント同期 + PR Ready変換"
7
- # - zh: "文档同步 + PR Ready转换"
8
- argument-hint: 'Mode target path - Mode: auto (default)|force|status|project, target
9
- path: Synchronization target path'
10
- allowed-tools:
11
- - Read
12
- - Write
13
- - Edit
14
- - MultiEdit
15
- - Bash(git:*)
16
- - Bash(gh:*)
17
- - Bash(python3:*)
18
- - Task
19
- - Grep
20
- - Glob
21
- - TodoWrite
22
- ---
23
-
24
- # 📚 MoAI-ADK Step 3: Document Synchronization (+Optional PR Ready)
25
- > **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.
26
-
27
- ## 🚀 START HERE
28
-
29
- **CRITICAL**: Load the TUI Survey Skill FIRST before any user interaction:
30
-
31
- ```
32
- AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
33
- ```
34
-
35
- This Skill MUST be loaded at the very beginning to enable TUI menu rendering for AskUserQuestion calls throughout this workflow.
36
-
37
- ## 🎯 Command Purpose
38
-
39
- Synchronize code changes to Living Documents and verify @TAG system to ensure complete traceability.
40
-
41
- **Document sync to**: $ARGUMENTS
42
-
43
- > **Standard two-step workflow** (see `CLAUDE.md` - "Alfred Command Execution Pattern" for details)
44
-
45
- ## 📋 Execution flow
46
-
47
- **Phase 0: Skill Loading** (IMMEDIATE)
48
- - Load `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` at the very start
49
- - This enables TUI menu rendering for all user interactions
50
-
51
- **Phase 1: Analysis & Planning**
52
- 1. **Project status analysis**: Git changes and TAG system verification
53
- 2. **Determine the scope of synchronization**: Full/partial/selective synchronization strategy
54
- 3. **User Confirmation**: Review and approve synchronization plan via AskUserQuestion (TUI menu)
55
-
56
- **Phase 2: Conditional Execution** (based on user choice)
57
- 4. **Document Synchronization**: Living Document updates and TAG integrity guaranteed (IF user selects "Proceed")
58
- 5. **Git operations**: Commit and PR state transitions via git-manager (IF user selects "Proceed")
59
- - OR abort workflow (IF user selects "Abort")
60
- - OR revise plan (IF user selects "Modify")
61
-
62
- ## 🧠 Associated Skills & Agents
63
-
64
- | Agent | Core Skill | Purpose |
65
- | ------------ | ------------------------------ | ------------------------------ |
66
- | tag-agent | `moai-alfred-tag-scanning` | Verify TAG system integrity |
67
- | quality-gate | `moai-alfred-trust-validation` | Check code quality before sync |
68
- | doc-syncer | `moai-alfred-tag-scanning` | Synchronize Living Documents |
69
- | git-manager | `moai-alfred-git-workflow` | Handle Git operations |
70
-
71
- **Note**: TUI Survey Skill is loaded once at Phase 0 and reused throughout all user interactions.
72
-
73
- ## 🔗 Associated Agent
74
-
75
- - **Phase 1**: quality-gate (🛡️ Quality Assurance Engineer) - Quality verification before synchronization (conditional)
76
- - **Primary**: doc-syncer (📖 Technical Writer) - Dedicated to document synchronization
77
- - **Secondary**: git-manager (🚀 Release Engineer) - Dedicated to Git commits/PR
78
-
79
- ## 💡 Example of use
80
-
81
- Users can run the command as follows:
82
- - `/alfred:3-sync` - Auto-sync (PR Ready only)
83
- - `/alfred:3-sync --auto-merge` - PR auto-merge + branch cleanup
84
- - `/alfred:3-sync force` - Force full synchronization
85
- - `/alfred:3-sync status` - Check synchronization status
86
- - `/alfred:3-sync project` - Integrated project synchronization
87
-
88
- ### 🚀 Fully automated GitFlow (--auto-merge)
89
-
90
- **Automatically performs the following actions when used in Team mode**:
91
- 1. Document synchronization complete
92
- 2. Switch to PR Ready
93
- 3. Check CI/CD status
94
- 4. PR automatic merge (squash)
95
- 5. Develop checkout and synchronization
96
- 6. Organizing local feature branches
97
- 7. **Ready for next task** ✅
98
-
99
- **Recommended use time**: When you want to complete the merge in one go after completing TDD implementation.
100
-
101
- **Personal mode**: Automate local main/develop merges and branch cleanups
102
-
103
- ## 🔍 STEP 1: Analyze synchronization scope and establish plan
104
-
105
- STEP 1 consists of **two independent phases** to provide flexible workflow based on project complexity:
106
-
107
- ### 📋 STEP 1 Workflow Overview
108
-
109
- ```
110
- ┌─────────────────────────────────────────────────────────────┐
111
- │ STEP 1: Synchronization Analysis & Planning │
112
- ├─────────────────────────────────────────────────────────────┤
113
- │ │
114
- │ Phase A (OPTIONAL) │
115
- │ ┌─────────────────────────────────────────┐ │
116
- │ │ 🔍 Explore Agent │ │
117
- │ │ • Navigate complex TAG chains │ │
118
- │ │ • Scan entire TAG system │ │
119
- │ │ • Identify orphan TAGs │ │
120
- │ └─────────────────────────────────────────┘ │
121
- │ ↓ │
122
- │ (exploration results) │
123
- │ ↓ │
124
- │ Phase B (REQUIRED) │
125
- │ ┌─────────────────────────────────────────┐ │
126
- │ │ ⚙️ tag-agent + doc-syncer Agents │ │
127
- │ │ • Verify TAG integrity (full project) │ │
128
- │ │ • Analyze Git changes │ │
129
- │ │ • Create synchronization plan │ │
130
- │ │ • Request user approval │ │
131
- │ └─────────────────────────────────────────┘ │
132
- │ ↓ │
133
- │ (user approval via AskUserQuestion) │
134
- │ ↓ │
135
- │ PROCEED TO STEP 2 │
136
- └─────────────────────────────────────────────────────────────┘
137
- ```
138
-
139
- **Key Points**:
140
- - **Phase A is optional** - Skip for simple single-SPEC changes
141
- - **Phase B is required** - Always runs to verify TAGs and plan sync
142
- - **Results flow forward** - Exploration results (if any) are passed to tag-agent
143
- - **⚠️ Important**: tag-agent verifies ENTIRE PROJECT, not just changed files
144
-
145
- ---
146
-
147
- ### 🔍 Phase A: TAG Chain Navigation (OPTIONAL)
148
-
149
- **Use the Explore agent for complex or extensive TAG chains.**
150
-
151
- #### When to use Phase A:
152
-
153
- - ✅ Large projects (100+ files)
154
- - ✅ Need comprehensive TAG chain integrity verification
155
- - ✅ Changes span multiple SPECs or modules
156
- - ❌ Simple changes to a single SPEC (skip to Phase B)
157
-
158
- #### How to invoke Explore agent:
159
-
160
- ```
161
- Invoking the Task tool (Explore agent):
162
- - subagent_type: "Explore"
163
- - description: "Scan entire TAG system"
164
- - prompt: "Please scan @TAG system throughout the project:
165
- - @SPEC TAG location (.moai/specs/)
166
- - @TEST TAG location (tests/)
167
- - @CODE TAG location (src/)
168
- - @DOC TAG location (docs/)
169
- - Detect orphan TAGs and broken references
170
- thoroughness level: very thorough"
171
- ```
172
-
173
- **Note**: For simple changes, skip Phase A and proceed directly to Phase B.
174
-
175
- ---
176
-
177
- ### ⚙️ Phase B: TAG Verification & Sync Planning (REQUIRED)
178
-
179
- **Call tag-agent and doc-syncer to verify TAG integrity and plan synchronization.**
180
-
181
- This phase is **always required** and runs **two agents sequentially**:
182
-
183
- #### How to invoke agents:
184
-
185
- ```
186
- 1. Tag-agent call (TAG verification - FULL PROJECT SCOPE):
187
- - subagent_type: "tag-agent"
188
- - description: "Verify TAG system across entire project"
189
- - prompt: "Please perform a COMPREHENSIVE TAG system verification across the ENTIRE PROJECT.
190
-
191
- **Required scope**: Scan all source files, not just changed files.
192
-
193
- **Verification items**:
194
- 1. @SPEC TAGs in .moai/specs/ directory
195
- 2. @TEST TAGs in tests/ directory
196
- 3. @CODE TAGs in src/ directory
197
- 4. @DOC TAGs in docs/ directory
198
-
199
- **Orphan detection** (MANDATORY):
200
- - Detect @CODE TAGs without matching @SPEC
201
- - Detect @SPEC TAGs without matching @CODE
202
- - Detect @TEST TAGs without matching @SPEC
203
- - Detect @DOC TAGs without matching @SPEC/@CODE
204
-
205
- **Output format**: Provide complete list of orphan TAGs with locations.
206
-
207
- (Optional) Explore results: $EXPLORE_RESULTS"
208
-
209
- 2. doc-syncer call (synchronization plan):
210
- - subagent_type: "doc-syncer"
211
- - description: "Establish a document synchronization plan"
212
- - prompt: """You are doc-syncer agent.
213
-
214
- LANGUAGE CONFIGURATION:
215
- - conversation_language: {{CONVERSATION_LANGUAGE}}
216
- - language_name: {{CONVERSATION_LANGUAGE_NAME}}
217
-
218
- CRITICAL INSTRUCTION:
219
- Documentation updates MUST respect conversation_language:
220
- - User-facing documentation (README, guides): {{CONVERSATION_LANGUAGE}}
221
- - SPEC documents (spec.md, plan.md, acceptance.md): {{CONVERSATION_LANGUAGE}}
222
- - Code comments: {{CONVERSATION_LANGUAGE}} (when not technical keywords)
223
- - Technical documentation and YAML frontmatter: English
224
-
225
- SKILL INVOCATION:
226
- Use explicit Skill() calls when needed:
227
- - Skill("moai-foundation-tags") for TAG chain validation
228
- - Skill("moai-foundation-trust") for quality gate checks
229
- - Skill("moai-alfred-tag-scanning") for TAG inventory updates
230
-
231
- TASK:
232
- Please analyze Git changes and establish a document synchronization plan.
233
- Ensure all documentation updates align with the conversation_language setting.
234
-
235
- $ARGUMENTS
236
- (Optional) TAG validation results: $TAG_VALIDATION_RESULTS"""
237
- ```
238
-
239
- **Note**:
240
- - **Sequential execution**: Run tag-agent first, then doc-syncer
241
- - **Results flow**: TAG validation results from tag-agent are passed to doc-syncer via `$TAG_VALIDATION_RESULTS`
242
- - **Phase A results**: If Phase A was executed, exploration results are passed to tag-agent via `$EXPLORE_RESULTS`
243
-
244
- ---
245
-
246
- ### Synchronization analysis in progress
247
-
248
- 1. **Check project status**
249
- - Git status and changed file list
250
- - Code-document consistency check
251
- - @TAG system verification (using tag-agent or Explore)
252
- - (Optional) Extensive TAG scan based on Explore results
253
-
254
- 2. **Determine the scope of synchronization**
255
- - Living Document area requiring update
256
- - TAG index need to be updated
257
- - PR status transition possibility (team mode)
258
-
259
- 3. **Establish a synchronization strategy**
260
- - Synchronization approach for each mode
261
- - Estimated work time and priorities
262
- - Identify potential risks
263
-
264
- ### Phase 1 Details: Quality pre-verification (conditional automatic execution)
265
-
266
- Quickly check code quality before synchronization.
267
-
268
- **Differences from Phase 3 (2-build)**:
269
- - **Phase 3**: In-depth verification after completion of TDD implementation (test coverage, code quality, security)
270
- - **Phase 1**: Quick scan before synchronization (file corruption, critical issues only)
271
-
272
- **Purpose**: Prevent documentation of code with quality issues
273
-
274
- **Execution conditions (automatic judgment)**:
275
- - Check the number of code change lines with Git diff
276
- - Changed lines > 50 lines: Automatically run
277
- - Changed lines ≤ 50 lines: Skip
278
- - Change only document: Skip
279
-
280
- **Verification items**:
281
- - **Verify only changed files**: File targets verified by Git diff
282
- - **TRUST principle verification**: Run trust-checker script
283
- - **Code style**: Run linter (changed files only)
284
- - **TAG chain**: Verify changed TAG integrity
285
-
286
- **How ​​it works**:
287
- Alfred automatically calls the quality-gate agent when there are a lot of code changes to perform quick quality verification before document synchronization.
288
-
289
- **Handling verification results**:
290
-
291
- ✅ **PASS (0 Critical)**: Synchronization in progress
292
-
293
- ⚠️ **WARNING (0 Critical, Warning included)**: Synchronization proceeds after displaying warning.
294
-
295
- ❌ **CRITICAL (1 or more Critical)**: Synchronization stopped, correction recommended
296
- - Critical issue found: Synchronization stopped, correction recommended
297
- - User selection: “Retry after modification” or “Force proceed”
298
-
299
- **Skip verification option**:
300
- To skip pre-verification, use the `/alfred:3-sync --skip-pre-check` option.
301
-
302
- ---
303
-
304
- ### User verification steps
305
-
306
- After reviewing your sync plan, `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` presents the following options for user decision:
307
- - **"Proceed"** or **"Start"**: Start synchronization as planned
308
- - **"Modify [Contents]"**: Request modifications to your sync plan
309
- - **"Abort"**: Abort the sync operation
310
-
311
- ---
312
-
313
- ## 🚀 STEP 2: Execute document synchronization (after user approval)
314
-
315
- After user approval (collected via `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`), the doc-syncer agent performs **Living Document synchronization and @TAG updates**, and optionally executes PR Ready transitions only in team mode.
316
-
317
- ### Phase 2 Details: SPEC Completion Processing (Automatic)
318
-
319
- The doc-syncer agent automatically determines whether TDD implementation is complete and updates SPEC metadata.
320
-
321
- **Automatic update conditions**:
322
- - SPEC with status `draft`
323
- - RED → GREEN → REFACTOR commit exists
324
- - @TEST and @CODE TAG exist
325
-
326
- **Update details**:
327
- - `status: draft` → `status: completed`
328
- - `version: 0.0.x` → `version: 0.1.0`
329
- - Automatic addition of HISTORY section
330
-
331
- **If conditions are not met**: Phase 2 detailed work is automatically skipped
332
-
333
- ## function
334
-
335
- - **Automatic Document Synchronization**: The doc-syncer agent performs Living Document synchronization and @TAG updates. Optionally implements the PR Ready transition only in team mode.
336
-
337
- ## Synchronization output
338
-
339
- - `.moai/reports/sync-report.md` creation/update
340
- - TAG chain verification: Direct code scan (`rg '@TAG' -n src/ tests/`)
341
-
342
- ## Execution method by mode
343
-
344
- ## 📋 STEP 1 Implementation Guide: Analyzing the scope of synchronization and establishing a plan
345
-
346
- ### 1. Project status analysis
347
-
348
- Alfred calls the doc-syncer agent to analyze synchronization targets and scopes.
349
-
350
- #### Analysis Checklist
351
-
352
- - [ ] **Git status**: Changed files, branch status, commit history
353
- - [ ] **Document consistency**: Need for code-to-document synchronization
354
- - [ ] **TAG system**: @TAG scheme verification and broken links
355
- - [ ] **Sync scope**: Full vs partial vs specific path synchronization
356
-
357
- ### 2. Determine synchronization strategy
358
-
359
- #### Mode-specific synchronization approach
360
-
361
- | mode | Synchronization range | PR processing | Key Features |
362
- | ------------ | ------------------------------- | ---------------------- | ---------------------- |
363
- | **Personal** | Local document synchronization | checkpoint only | Focus on personal work |
364
- | **Team** | Full Sync + TAG | PR Ready conversion | Collaboration support |
365
- | **Auto** | Intelligent automatic selection | Decisions by situation | Optimal strategy |
366
- | **Force** | Force full sync | Full regeneration | For error recovery |
367
-
368
- #### Expected scope of work
369
-
370
- - **Living Document**: API documentation, README, architecture document
371
- - **TAG index**: Update `.moai/indexes/tags.db`
372
- - **Sync report**: `.moai/reports/sync-report.md`
373
- - **PR status**: Draft → Ready for Review transition
374
-
375
- ### 3. Generate synchronization plan report
376
-
377
- Present your plan in the following format:
378
-
379
- ```
380
- ## Document Synchronization Plan Report: [TARGET]
381
-
382
- ### 📊 Health Analysis Results
383
- - **Changed Files**: [Number and Type]
384
- - **Synchronization Required**: [High/Medium/Low]
385
- - **TAG System Status**: [Healthy/Problem Detected]
386
-
387
- ### 🎯 Sync Strategy
388
- - **Selected Mode**: [auto/force/status/project]
389
- - **Sync Scope**: [Full/Partial/Selective]
390
- - **PR Handling**: [Maintain/Switch Ready/Create New PR]
391
-
392
- ### ⚠️ Notes
393
- - **Potential conflicts**: [Possible document conflicts]
394
- - **TAG issues**: [Broken links, duplicate TAGs]
395
- - **Performance impact**: [Estimated time for large synchronization]
396
-
397
- ### ✅ Expected deliverables
398
- - **sync-report.md**: [Summary of sync results]
399
- - **tags.db**: [Updated TAG index]
400
- - **Living Documents**: [Updated document list]
401
- - **PR Status**: [PR transition in team mode]
402
-
403
- ---
404
- **Approval Request**: Do you want to proceed with synchronization using the above plan?
405
- (select “Proceed”, “Modify [Content]”, or “Abort”)
406
- ```
407
-
408
- ---
409
-
410
- ## 🚀 STEP 2 Implementation Guide: Document Synchronization (After Approval)
411
-
412
- Only when the user selects **"Proceed"** or **"Start"** will Alfred call the doc-syncer agent to perform Living Document synchronization and TAG updates.
413
-
414
- ### Sync step-by-step guide
415
-
416
- 1. **Living Document Synchronization**: Code → Document automatically reflected
417
- 2. **TAG System Verification**: @TAG System Integrity Verification
418
- 3. **Index Update**: Traceability Matrix Update
419
- 4. **Create Report**: Create a summary of synchronization results
420
-
421
- ### Agent collaboration structure
422
-
423
- - **Step 1**: The `doc-syncer` agent is dedicated to Living Document synchronization and @TAG management.
424
- - **Step 2**: The `git-manager` agent is dedicated to all Git commits, PR state transitions, and synchronization.
425
- - **Single Responsibility Principle**: doc-syncer only performs document tasks, and git-manager only performs Git tasks.
426
- - **Sequential execution**: Executes in the order doc-syncer → git-manager to maintain clear dependencies.
427
- - **No inter-agent calls**: Each agent does not directly call other agents, and executes commands. Runs sequentially in levels only.
428
-
429
- ## 🚀 Optimized parallel/sequential hybrid workflow
430
-
431
- ### Phase 1: Quick status check (parallel execution)
432
-
433
- Do the following **simultaneously**:
434
-
435
- ```
436
- Task 1 (haiku): Check Git status
437
- ├── Collect list of changed files
438
- ├── Check branch status
439
- └── Determine need for synchronization
440
-
441
- Task 2 (sonnet): Analyze document structure
442
- ├── Detect project type
443
- ├── Collect TAG list
444
- └── Determine synchronization scope
445
- ```
446
-
447
- ### Phase 2: Document synchronization (sequential execution)
448
-
449
- The `doc-syncer` agent (sonnet) handles intensive processing:
450
-
451
- - Living Document synchronization
452
- - @TAG system verification and update
453
- - Document-code consistency check
454
- - TAG traceability matrix update
455
-
456
- ### Phase 3: Git task processing (sequential execution)
457
-
458
- Final processing by the `git-manager` agent (haiku):
459
-
460
- - Commit document changes
461
- - Apply synchronization strategy for each mode
462
- - Switch PR Ready in Team mode
463
- - Automatically assign reviewers (using gh CLI)
464
-
465
- ### Phase 4: PR merge and branch cleanup (optional)
466
-
467
- Additional processing by `git-manager` when using the `--auto-merge` flag:
468
-
469
- **Team mode (GitFlow)**:
470
- 1. Check PR status (CI/CD pass check)
471
- 2. PR automatic merge (to develop branch)
472
- 3. Delete remote feature branch
473
- 4. Local develop checkout and synchronization
474
- 5. Organizing local feature branches
475
- 6. Notification that the next task is ready
476
-
477
- **Personal Mode**:
478
- 1. Local main/develop merge
479
- 2. Delete feature branch
480
- 3. Check out the base branch
481
- 4. Notification that the next task is ready
482
-
483
- **Performance improvements**: Minimize latency by parallelizing the initial verification step
484
-
485
- ### Argument handling
486
-
487
- - **$1 (mode)**: `$1` → `auto` (default)|`force`|`status`|`project`
488
- - **$2 (path)**: `$2` → Sync target path (optional)
489
- - **flags**:
490
- - `--auto-merge`: Enable PR automatic merge and branch cleanup (Team mode)
491
- - `--skip-pre-check`: Skip pre-quality check
492
- - `--skip-quality-check`: Skip final quality check
493
-
494
- **Command usage example**:
495
- - `/alfred:3-sync` - Basic automatic synchronization (optimized by mode)
496
- - `/alfred:3-sync --auto-merge` - PR automatic merge + branch cleanup (Team mode recommended)
497
- - `/alfred:3-sync force` - Force full synchronization
498
- - `/alfred:3-sync status` - Check synchronization status
499
- - `/alfred:3-sync project` - Integrated project synchronization
500
- - `/alfred:3-sync auto src/auth/` - Specific path Synchronization
501
- - `/alfred:3-sync --auto-merge --skip-pre-check` - Fast merge
502
-
503
- ### Agent role separation
504
-
505
- #### doc-syncer dedicated area
506
-
507
- - Living Document synchronization (code ↔ document)
508
- - @TAG system verification and update
509
- - Automatic creation/update of API document
510
- - README and architecture document synchronization
511
- - Verification of document-code consistency
512
-
513
- #### git-manager dedicated area
514
-
515
- - All Git commit operations (add, commit, push)
516
- - Apply synchronization strategy for each mode
517
- - PR status transition (Draft → Ready)
518
- - **PR auto merge** (when --auto-merge flag)
519
- - Check CI/CD status
520
- - Conflict verification
521
- - Execute Squash merge
522
- - Remote branch deletion
523
- - **Branch cleanup and conversion**
524
- - Local develop checkout
525
- - Remote synchronization (git pull)
526
- - Local feature branch deletion
527
- - Automatic assignment and labeling of reviewers
528
- - GitHub CLI integration and remote synchronization
529
-
530
- ### 🧪 Personal Mode
531
-
532
- - The git-manager agent automatically creates checkpoints before and after synchronization
533
- - The README, in-depth documentation, and PR body are organized manually according to the checklist.
534
-
535
- ### 🏢 Team Mode
536
-
537
- - Full synchronization of Living Document + @TAG verification/correction
538
- - Optionally perform PR Ready conversion and labeling only when gh CLI is set
539
- - Fully automated when using **--auto-merge flag**:
540
- 1. Document synchronization complete.
541
- 2. git push origin feature/SPEC-{ID}
542
- 3. gh pr ready {PR_NUMBER}
543
- 4. Check CI/CD status (gh pr checks)
544
- 5. gh pr merge --squash --delete-branch
545
- 6. git checkout develop && git pull origin develop
546
- 7. Notification that the next task is ready
547
-
548
- **Important**: All Git operations (commit, sync, PR management) are handled by the git-manager agent, so this command does not run Git operations directly.
549
-
550
- **Branch Policy**:
551
- - Base branch: `develop` (GitFlow standard)
552
- - After merge: automatically checkout `develop`
553
- - Next `/alfred:1-plan` automatically starts in `develop`
554
-
555
- ## Synchronization Details (Summary)
556
-
557
- 1. Project analysis and TAG verification → Check broken/duplicate/orphaned TAG
558
- 2. Code ↔ Document synchronization → API/README/architecture document update, SPEC ↔ Code TODO synchronization
559
- 3. TAG chain verification → `rg '@TAG' -n src/ tests/` (scan code directly)
560
-
561
- ## Next steps
562
-
563
- **Recommendation**: For better performance and context management, start a new chat session with the `/clear` or `/new` command before proceeding to the next step.
564
-
565
- - The entire MoAI-ADK workflow is completed after document synchronization is completed
566
- - All Git operations are dedicated to the git-manager agent to ensure consistency
567
- - Only command-level orchestration is used without direct calls between agents
568
-
569
- ## Report results
570
-
571
- Report synchronization results in a structured format:
572
-
573
- ### Successful synchronization (summary example)
574
-
575
- ✅ Document synchronization complete — Update N, Create M, TAG Modify K, Verification passed
576
-
577
- ### Partial synchronization (problem detected)
578
-
579
- ```
580
- ⚠️ Partial sync completed (issue found)
581
-
582
- ❌ Problems that need solving:
583
- ├── Broken links: X (specific list)
584
- ├── Duplicate TAG: X
585
- └── Orphan TAG: X
586
-
587
- 🛠️ Auto-correction recommendations:
588
- 1. Broken link recovery
589
- 2. Merge duplicate TAGs
590
- 3. Orphan TAG cleanup
591
- ```
592
-
593
- ## Next steps guidance
594
-
595
- ### Development cycle complete
596
-
597
- **Default mode (PR Ready only)**:
598
- ```
599
- 🔄 MoAI-ADK 3-step workflow completion:
600
- ✅ /alfred:1-plan → Create EARS specification (feature/SPEC-{ID} branch)
601
- ✅ /alfred:2-run → TDD implementation
602
- ✅ /alfred:3-sync → Document synchronization + PR Ready
603
-
604
- ⏳ Next steps: PR review and manual merge required
605
- > gh pr view (check PR)
606
- > gh pr merge --squash (merge after review)
607
- ```
608
-
609
- **Auto Merge Mode (Recommended)**:
610
- ```
611
- 🔄 Fully automated GitFlow workflow:
612
- ✅ /alfred:1-plan → EARS specification creation (from develop)
613
- ✅ /alfred:2-run → TDD implementation
614
- ✅ /alfred:3-sync --auto-merge → Document synchronization + PR Merge + branch cleanup
615
-
616
- 🎉 Automatic switch to develop branch done!
617
- 📍 You are here: develop (ready for next work)
618
- > /alfred:1-plan "Describe next feature" # Create new branch in develop
619
- ```
620
-
621
- ### Integrated project mode
622
-
623
- **When to use**:
624
- - When the implementation of multiple SPECs has been completed and the entire project documentation needs to be updated
625
- - When periodic synchronization of the entire document in Personal mode is required.
626
-
627
- **Differences from Personal/Team mode**:
628
- - **Personal/Team mode**: Synchronize only specific SPEC-related documents
629
- - **Project mode**: Synchronize README, architecture documentation, and entire API documentation
630
-
631
- **Output**:
632
- - README.md (updated complete feature list)
633
- - docs/architecture.md (updated system design)
634
- - docs/api/ (unified API documentation)
635
- - .moai/indexes/ (rebuilt full TAG index)
636
-
637
- ```
638
- 🏢 Integrated branch sync complete!
639
-
640
- 📋 Entire project synchronization:
641
- ├── README.md (full feature list)
642
- ├── docs/architecture.md (system design)
643
- ├── docs/api/ (unified API documentation)
644
- └── .moai/indexes/ (full TAG index)
645
-
646
- 🎯 PR conversion support completed
647
- ```
648
-
649
- ## Constraints and Assumptions
650
-
651
- **Environment Dependency:**
652
-
653
- - Git repository required
654
- - gh CLI (required for GitHub integration)
655
- - Python3 (TAG verification script)
656
-
657
- **Prerequisites:**
658
-
659
- - MoAI-ADK project structure (.moai/, .claude/)
660
- - TDD implementation completion status
661
- - Compliance with TRUST 5 principles
662
-
663
- **Limitations:**
664
-
665
- - TAG verification is based on file existence
666
- - PR automatic conversion only works in gh CLI environment
667
- - Coverage figures need to be measured separately
668
-
669
- ---
670
-
671
- ## 🧠 Context Management
672
-
673
- > For more information: `.moai/memory/development-guide.md` - see section "Context Engineering"
674
-
675
- ### Core strategy of this command
676
-
677
- **Load first**: `.moai/reports/sync-report-latest.md` (old sync state)
678
-
679
- **Recommendation**: Document synchronization is complete. Now that the entire MoAI-ADK cycle (1-spec → 2-build → 3-sync) has been completed, start a new conversation session with the `/clear` or `/new` command before developing the next feature.
680
-
681
- ---
682
-
683
- **Aims to improve code-document consistency and ensure @TAG traceability by linking with the doc-syncer subagent.**