oh-my-customcode 0.1.4 → 0.2.1

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.
Files changed (436) hide show
  1. package/README.md +80 -129
  2. package/dist/cli/index.js +273 -100
  3. package/dist/index.js +11 -53
  4. package/package.json +1 -1
  5. package/templates/{agents/sw-architect/documenter/AGENT.md → .claude/agents/arch-documenter.md} +7 -39
  6. package/templates/{agents/sw-architect/speckit-agent/AGENT.md → .claude/agents/arch-speckit-agent.md} +61 -63
  7. package/templates/.claude/agents/be-express-expert.md +71 -0
  8. package/templates/.claude/agents/be-fastapi-expert.md +33 -0
  9. package/templates/.claude/agents/be-go-backend-expert.md +33 -0
  10. package/templates/.claude/agents/be-nestjs-expert.md +51 -0
  11. package/templates/.claude/agents/be-springboot-expert.md +75 -0
  12. package/templates/.claude/agents/db-supabase-expert.md +63 -0
  13. package/templates/{agents/sw-engineer/frontend/svelte-agent/AGENT.md → .claude/agents/fe-svelte-agent.md} +16 -31
  14. package/templates/.claude/agents/fe-vercel-agent.md +57 -0
  15. package/templates/{agents/sw-engineer/frontend/vuejs-agent/AGENT.md → .claude/agents/fe-vuejs-agent.md} +16 -31
  16. package/templates/.claude/agents/infra-aws-expert.md +37 -0
  17. package/templates/.claude/agents/infra-docker-expert.md +37 -0
  18. package/templates/.claude/agents/lang-golang-expert.md +33 -0
  19. package/templates/.claude/agents/lang-java21-expert.md +56 -0
  20. package/templates/.claude/agents/lang-kotlin-expert.md +33 -0
  21. package/templates/.claude/agents/lang-python-expert.md +33 -0
  22. package/templates/.claude/agents/lang-rust-expert.md +33 -0
  23. package/templates/.claude/agents/lang-typescript-expert.md +33 -0
  24. package/templates/.claude/agents/mgr-creator.md +102 -0
  25. package/templates/{agents/manager/gitnerd/AGENT.md → .claude/agents/mgr-gitnerd.md} +8 -17
  26. package/templates/.claude/agents/mgr-sauron.md +139 -0
  27. package/templates/{agents/manager/supplier/AGENT.md → .claude/agents/mgr-supplier.md} +14 -46
  28. package/templates/.claude/agents/mgr-sync-checker.md +89 -0
  29. package/templates/{agents/manager/updater/AGENT.md → .claude/agents/mgr-updater.md} +21 -53
  30. package/templates/{agents/qa-team/qa-engineer/AGENT.md → .claude/agents/qa-engineer.md} +13 -24
  31. package/templates/{agents/qa-team/qa-planner/AGENT.md → .claude/agents/qa-planner.md} +10 -20
  32. package/templates/{agents/qa-team/qa-writer/AGENT.md → .claude/agents/qa-writer.md} +10 -20
  33. package/templates/.claude/agents/sys-memory-keeper.md +105 -0
  34. package/templates/.claude/agents/sys-naggy.md +81 -0
  35. package/templates/{agents/sw-engineer/tooling/bun-expert/AGENT.md → .claude/agents/tool-bun-expert.md} +28 -39
  36. package/templates/.claude/agents/tool-npm-expert.md +76 -0
  37. package/templates/.claude/agents/tool-optimizer.md +75 -0
  38. package/templates/{agents/tutor/go-tutor/AGENT.md → .claude/agents/tutor-go.md} +16 -27
  39. package/templates/.claude/contexts/ecomode.md +5 -5
  40. package/templates/.claude/rules/MUST-agent-design.md +60 -42
  41. package/templates/.claude/rules/MUST-agent-identification.md +11 -11
  42. package/templates/.claude/rules/MUST-continuous-improvement.md +2 -2
  43. package/templates/.claude/rules/MUST-intent-transparency.md +18 -18
  44. package/templates/.claude/rules/MUST-orchestrator-coordination.md +192 -113
  45. package/templates/.claude/rules/MUST-parallel-execution.md +28 -28
  46. package/templates/.claude/rules/MUST-sync-verification.md +52 -45
  47. package/templates/.claude/rules/MUST-tool-identification.md +12 -14
  48. package/templates/.claude/rules/SHOULD-ecomode.md +3 -3
  49. package/templates/.claude/rules/SHOULD-hud-statusline.md +4 -4
  50. package/templates/.claude/rules/SHOULD-memory-integration.md +4 -4
  51. package/templates/.claude/rules/SHOULD-pipeline-mode.md +1 -1
  52. package/templates/.claude/skills/audit-agents/SKILL.md +116 -0
  53. package/templates/{skills/infrastructure → .claude/skills}/aws-best-practices/SKILL.md +4 -4
  54. package/templates/.claude/skills/create-agent/SKILL.md +91 -0
  55. package/templates/.claude/skills/dev-lead-routing/SKILL.md +238 -0
  56. package/templates/{commands/dev/refactor.md → .claude/skills/dev-refactor/SKILL.md} +17 -20
  57. package/templates/{commands/dev/review.md → .claude/skills/dev-review/SKILL.md} +16 -17
  58. package/templates/{agents/manager/supplier/refs/skills/infrastructure → .claude/skills}/docker-best-practices/SKILL.md +4 -4
  59. package/templates/{agents/manager/supplier/refs/skills/backend → .claude/skills}/fastapi-best-practices/SKILL.md +4 -4
  60. package/templates/.claude/skills/fix-refs/SKILL.md +107 -0
  61. package/templates/{agents/manager/supplier/refs/skills/backend → .claude/skills}/go-backend-best-practices/SKILL.md +4 -4
  62. package/templates/{skills/development → .claude/skills}/go-best-practices/SKILL.md +4 -4
  63. package/templates/{commands/system/help.md → .claude/skills/help/SKILL.md} +34 -46
  64. package/templates/{skills/orchestration → .claude/skills}/intent-detection/SKILL.md +14 -14
  65. package/templates/{agents/manager/supplier/refs/skills/orchestration → .claude/skills}/intent-detection/patterns/agent-triggers.yaml +117 -110
  66. package/templates/{agents/sw-engineer/language/kotlin-expert/refs → .claude/skills}/kotlin-best-practices/SKILL.md +4 -4
  67. package/templates/{commands/system/lists.md → .claude/skills/lists/SKILL.md} +25 -33
  68. package/templates/{agents/manager/supplier/refs/skills/system → .claude/skills}/memory-management/SKILL.md +10 -10
  69. package/templates/{commands/memory/recall.md → .claude/skills/memory-recall/SKILL.md} +31 -43
  70. package/templates/{commands/memory/save.md → .claude/skills/memory-save/SKILL.md} +27 -29
  71. package/templates/.claude/skills/npm-audit/SKILL.md +72 -0
  72. package/templates/.claude/skills/npm-publish/SKILL.md +63 -0
  73. package/templates/.claude/skills/npm-version/SKILL.md +75 -0
  74. package/templates/.claude/skills/optimize-analyze/SKILL.md +55 -0
  75. package/templates/.claude/skills/optimize-bundle/SKILL.md +67 -0
  76. package/templates/.claude/skills/optimize-report/SKILL.md +74 -0
  77. package/templates/{skills/orchestration → .claude/skills}/pipeline-execution/SKILL.md +4 -4
  78. package/templates/{commands/pipeline/list.md → .claude/skills/pipeline-list/SKILL.md} +11 -18
  79. package/templates/{commands/pipeline/run.md → .claude/skills/pipeline-run/SKILL.md} +38 -22
  80. package/templates/{agents/sw-engineer/language/python-expert/refs → .claude/skills}/python-best-practices/SKILL.md +4 -4
  81. package/templates/.claude/skills/qa-lead-routing/SKILL.md +277 -0
  82. package/templates/{skills/development → .claude/skills}/react-best-practices/SKILL.md +4 -4
  83. package/templates/{skills/system → .claude/skills}/result-aggregation/SKILL.md +17 -17
  84. package/templates/{agents/sw-engineer/language/rust-expert/refs → .claude/skills}/rust-best-practices/SKILL.md +4 -4
  85. package/templates/.claude/skills/sauron-watch/SKILL.md +144 -0
  86. package/templates/.claude/skills/secretary-routing/SKILL.md +178 -0
  87. package/templates/{skills/backend → .claude/skills}/springboot-best-practices/SKILL.md +4 -4
  88. package/templates/{commands/system/status.md → .claude/skills/status/SKILL.md} +29 -39
  89. package/templates/.claude/skills/supabase-postgres-best-practices/SKILL.md +98 -0
  90. package/templates/{skills/development → .claude/skills}/typescript-best-practices/SKILL.md +4 -4
  91. package/templates/{commands/updater/docs.md → .claude/skills/update-docs/SKILL.md} +71 -96
  92. package/templates/{commands/updater/external.md → .claude/skills/update-external/SKILL.md} +34 -99
  93. package/templates/{agents/manager/supplier/refs/skills/development → .claude/skills}/vercel-deploy/SKILL.md +4 -4
  94. package/templates/{agents/manager/supplier/refs/skills/development → .claude/skills}/web-design-guidelines/SKILL.md +4 -4
  95. package/templates/CLAUDE.md.en +75 -100
  96. package/templates/CLAUDE.md.ko +74 -99
  97. package/templates/guides/aws/index.yaml +1 -1
  98. package/templates/guides/docker/index.yaml +1 -1
  99. package/templates/guides/fastapi/index.yaml +1 -1
  100. package/templates/guides/go-backend/index.yaml +1 -1
  101. package/templates/guides/golang/index.yaml +1 -1
  102. package/templates/guides/index.yaml +9 -0
  103. package/templates/guides/kotlin/index.yaml +1 -1
  104. package/templates/guides/python/index.yaml +1 -1
  105. package/templates/guides/rust/index.yaml +1 -1
  106. package/templates/guides/springboot/index.yaml +1 -1
  107. package/templates/guides/supabase-postgres/README.md +32 -0
  108. package/templates/guides/supabase-postgres/index.yaml +19 -0
  109. package/templates/guides/typescript/index.yaml +1 -1
  110. package/templates/manifest.json +9 -15
  111. package/templates/pipelines/examples/code-review.yaml +1 -1
  112. package/templates/agents/index.yaml +0 -243
  113. package/templates/agents/infra-engineer/aws-expert/AGENT.md +0 -47
  114. package/templates/agents/infra-engineer/aws-expert/index.yaml +0 -27
  115. package/templates/agents/infra-engineer/aws-expert/refs/aws/common-patterns.md +0 -169
  116. package/templates/agents/infra-engineer/aws-expert/refs/aws/index.yaml +0 -26
  117. package/templates/agents/infra-engineer/aws-expert/refs/aws/well-architected.md +0 -143
  118. package/templates/agents/infra-engineer/aws-expert/refs/aws-best-practices/SKILL.md +0 -279
  119. package/templates/agents/infra-engineer/aws-expert/refs/aws-best-practices/index.yaml +0 -27
  120. package/templates/agents/infra-engineer/docker-expert/AGENT.md +0 -47
  121. package/templates/agents/infra-engineer/docker-expert/index.yaml +0 -27
  122. package/templates/agents/infra-engineer/docker-expert/refs/docker/compose-best-practices.md +0 -284
  123. package/templates/agents/infra-engineer/docker-expert/refs/docker/dockerfile-best-practices.md +0 -262
  124. package/templates/agents/infra-engineer/docker-expert/refs/docker/index.yaml +0 -26
  125. package/templates/agents/infra-engineer/docker-expert/refs/docker-best-practices/SKILL.md +0 -274
  126. package/templates/agents/infra-engineer/docker-expert/refs/docker-best-practices/index.yaml +0 -26
  127. package/templates/agents/manager/creator/AGENT.md +0 -274
  128. package/templates/agents/manager/creator/index.yaml +0 -66
  129. package/templates/agents/manager/creator/refs/rules/MAY-optimization.md +0 -93
  130. package/templates/agents/manager/creator/refs/rules/MUST-agent-design.md +0 -107
  131. package/templates/agents/manager/creator/refs/rules/MUST-agent-identification.md +0 -108
  132. package/templates/agents/manager/creator/refs/rules/MUST-continuous-improvement.md +0 -132
  133. package/templates/agents/manager/creator/refs/rules/MUST-intent-transparency.md +0 -199
  134. package/templates/agents/manager/creator/refs/rules/MUST-language-policy.md +0 -62
  135. package/templates/agents/manager/creator/refs/rules/MUST-orchestrator-coordination.md +0 -334
  136. package/templates/agents/manager/creator/refs/rules/MUST-parallel-execution.md +0 -398
  137. package/templates/agents/manager/creator/refs/rules/MUST-permissions.md +0 -84
  138. package/templates/agents/manager/creator/refs/rules/MUST-safety.md +0 -69
  139. package/templates/agents/manager/creator/refs/rules/MUST-sync-verification.md +0 -219
  140. package/templates/agents/manager/creator/refs/rules/MUST-tool-identification.md +0 -174
  141. package/templates/agents/manager/creator/refs/rules/SHOULD-ecomode.md +0 -145
  142. package/templates/agents/manager/creator/refs/rules/SHOULD-error-handling.md +0 -102
  143. package/templates/agents/manager/creator/refs/rules/SHOULD-hud-statusline.md +0 -96
  144. package/templates/agents/manager/creator/refs/rules/SHOULD-interaction.md +0 -103
  145. package/templates/agents/manager/creator/refs/rules/SHOULD-memory-integration.md +0 -114
  146. package/templates/agents/manager/creator/refs/rules/SHOULD-pipeline-mode.md +0 -165
  147. package/templates/agents/manager/creator/refs/rules/index.yaml +0 -125
  148. package/templates/agents/manager/gitnerd/index.yaml +0 -55
  149. package/templates/agents/manager/sauron/AGENT.md +0 -153
  150. package/templates/agents/manager/sauron/index.yaml +0 -52
  151. package/templates/agents/manager/supplier/index.yaml +0 -31
  152. package/templates/agents/manager/supplier/refs/guides/aws/common-patterns.md +0 -169
  153. package/templates/agents/manager/supplier/refs/guides/aws/index.yaml +0 -26
  154. package/templates/agents/manager/supplier/refs/guides/aws/well-architected.md +0 -143
  155. package/templates/agents/manager/supplier/refs/guides/claude-code/01-overview.md +0 -42
  156. package/templates/agents/manager/supplier/refs/guides/claude-code/03-tools.md +0 -107
  157. package/templates/agents/manager/supplier/refs/guides/claude-code/04-agent-skills.md +0 -90
  158. package/templates/agents/manager/supplier/refs/guides/claude-code/05-agent-sdk.md +0 -129
  159. package/templates/agents/manager/supplier/refs/guides/claude-code/06-mcp.md +0 -165
  160. package/templates/agents/manager/supplier/refs/guides/claude-code/07-prompt-engineering.md +0 -100
  161. package/templates/agents/manager/supplier/refs/guides/claude-code/08-testing.md +0 -58
  162. package/templates/agents/manager/supplier/refs/guides/claude-code/09-guardrails.md +0 -80
  163. package/templates/agents/manager/supplier/refs/guides/claude-code/10-monitoring.md +0 -89
  164. package/templates/agents/manager/supplier/refs/guides/claude-code/11-sub-agents.md +0 -159
  165. package/templates/agents/manager/supplier/refs/guides/claude-code/index.yaml +0 -51
  166. package/templates/agents/manager/supplier/refs/guides/docker/compose-best-practices.md +0 -284
  167. package/templates/agents/manager/supplier/refs/guides/docker/dockerfile-best-practices.md +0 -262
  168. package/templates/agents/manager/supplier/refs/guides/docker/index.yaml +0 -26
  169. package/templates/agents/manager/supplier/refs/guides/fastapi/best-practices.md +0 -232
  170. package/templates/agents/manager/supplier/refs/guides/fastapi/index.yaml +0 -21
  171. package/templates/agents/manager/supplier/refs/guides/go-backend/index.yaml +0 -26
  172. package/templates/agents/manager/supplier/refs/guides/go-backend/project-layout.md +0 -243
  173. package/templates/agents/manager/supplier/refs/guides/go-backend/uber-style.md +0 -212
  174. package/templates/agents/manager/supplier/refs/guides/golang/concurrency.md +0 -282
  175. package/templates/agents/manager/supplier/refs/guides/golang/effective-go.md +0 -309
  176. package/templates/agents/manager/supplier/refs/guides/golang/error-handling.md +0 -250
  177. package/templates/agents/manager/supplier/refs/guides/golang/index.yaml +0 -27
  178. package/templates/agents/manager/supplier/refs/guides/index.yaml +0 -101
  179. package/templates/agents/manager/supplier/refs/guides/kotlin/coding-conventions.md +0 -247
  180. package/templates/agents/manager/supplier/refs/guides/kotlin/idioms.md +0 -234
  181. package/templates/agents/manager/supplier/refs/guides/kotlin/index.yaml +0 -26
  182. package/templates/agents/manager/supplier/refs/guides/python/index.yaml +0 -26
  183. package/templates/agents/manager/supplier/refs/guides/python/pep8-style-guide.md +0 -202
  184. package/templates/agents/manager/supplier/refs/guides/python/zen-of-python.md +0 -79
  185. package/templates/agents/manager/supplier/refs/guides/rust/error-handling.md +0 -262
  186. package/templates/agents/manager/supplier/refs/guides/rust/index.yaml +0 -26
  187. package/templates/agents/manager/supplier/refs/guides/rust/ownership.md +0 -180
  188. package/templates/agents/manager/supplier/refs/guides/springboot/best-practices.md +0 -361
  189. package/templates/agents/manager/supplier/refs/guides/springboot/index.yaml +0 -22
  190. package/templates/agents/manager/supplier/refs/guides/typescript/advanced-types.md +0 -225
  191. package/templates/agents/manager/supplier/refs/guides/typescript/index.yaml +0 -26
  192. package/templates/agents/manager/supplier/refs/guides/typescript/type-system.md +0 -219
  193. package/templates/agents/manager/supplier/refs/guides/web-design/accessibility.md +0 -66
  194. package/templates/agents/manager/supplier/refs/guides/web-design/index.yaml +0 -20
  195. package/templates/agents/manager/supplier/refs/guides/web-design/performance.md +0 -102
  196. package/templates/agents/manager/supplier/refs/rules/MAY-optimization.md +0 -93
  197. package/templates/agents/manager/supplier/refs/rules/MUST-agent-design.md +0 -107
  198. package/templates/agents/manager/supplier/refs/rules/MUST-agent-identification.md +0 -108
  199. package/templates/agents/manager/supplier/refs/rules/MUST-continuous-improvement.md +0 -132
  200. package/templates/agents/manager/supplier/refs/rules/MUST-intent-transparency.md +0 -199
  201. package/templates/agents/manager/supplier/refs/rules/MUST-language-policy.md +0 -62
  202. package/templates/agents/manager/supplier/refs/rules/MUST-orchestrator-coordination.md +0 -334
  203. package/templates/agents/manager/supplier/refs/rules/MUST-parallel-execution.md +0 -398
  204. package/templates/agents/manager/supplier/refs/rules/MUST-permissions.md +0 -84
  205. package/templates/agents/manager/supplier/refs/rules/MUST-safety.md +0 -69
  206. package/templates/agents/manager/supplier/refs/rules/MUST-sync-verification.md +0 -219
  207. package/templates/agents/manager/supplier/refs/rules/MUST-tool-identification.md +0 -174
  208. package/templates/agents/manager/supplier/refs/rules/SHOULD-ecomode.md +0 -145
  209. package/templates/agents/manager/supplier/refs/rules/SHOULD-error-handling.md +0 -102
  210. package/templates/agents/manager/supplier/refs/rules/SHOULD-hud-statusline.md +0 -96
  211. package/templates/agents/manager/supplier/refs/rules/SHOULD-interaction.md +0 -103
  212. package/templates/agents/manager/supplier/refs/rules/SHOULD-memory-integration.md +0 -114
  213. package/templates/agents/manager/supplier/refs/rules/SHOULD-pipeline-mode.md +0 -165
  214. package/templates/agents/manager/supplier/refs/rules/index.yaml +0 -125
  215. package/templates/agents/manager/supplier/refs/skills/backend/fastapi-best-practices/index.yaml +0 -25
  216. package/templates/agents/manager/supplier/refs/skills/backend/go-backend-best-practices/index.yaml +0 -26
  217. package/templates/agents/manager/supplier/refs/skills/backend/springboot-best-practices/SKILL.md +0 -356
  218. package/templates/agents/manager/supplier/refs/skills/backend/springboot-best-practices/index.yaml +0 -27
  219. package/templates/agents/manager/supplier/refs/skills/development/go-best-practices/SKILL.md +0 -202
  220. package/templates/agents/manager/supplier/refs/skills/development/go-best-practices/index.yaml +0 -25
  221. package/templates/agents/manager/supplier/refs/skills/development/kotlin-best-practices/SKILL.md +0 -255
  222. package/templates/agents/manager/supplier/refs/skills/development/kotlin-best-practices/index.yaml +0 -27
  223. package/templates/agents/manager/supplier/refs/skills/development/python-best-practices/SKILL.md +0 -221
  224. package/templates/agents/manager/supplier/refs/skills/development/python-best-practices/index.yaml +0 -25
  225. package/templates/agents/manager/supplier/refs/skills/development/react-best-practices/SKILL.md +0 -100
  226. package/templates/agents/manager/supplier/refs/skills/development/react-best-practices/index.yaml +0 -39
  227. package/templates/agents/manager/supplier/refs/skills/development/rust-best-practices/SKILL.md +0 -266
  228. package/templates/agents/manager/supplier/refs/skills/development/rust-best-practices/index.yaml +0 -26
  229. package/templates/agents/manager/supplier/refs/skills/development/typescript-best-practices/SKILL.md +0 -320
  230. package/templates/agents/manager/supplier/refs/skills/development/typescript-best-practices/index.yaml +0 -28
  231. package/templates/agents/manager/supplier/refs/skills/development/vercel-deploy/index.yaml +0 -30
  232. package/templates/agents/manager/supplier/refs/skills/development/web-design-guidelines/index.yaml +0 -34
  233. package/templates/agents/manager/supplier/refs/skills/index.yaml +0 -129
  234. package/templates/agents/manager/supplier/refs/skills/infrastructure/aws-best-practices/SKILL.md +0 -279
  235. package/templates/agents/manager/supplier/refs/skills/infrastructure/aws-best-practices/index.yaml +0 -27
  236. package/templates/agents/manager/supplier/refs/skills/infrastructure/docker-best-practices/index.yaml +0 -26
  237. package/templates/agents/manager/supplier/refs/skills/orchestration/intent-detection/SKILL.md +0 -214
  238. package/templates/agents/manager/supplier/refs/skills/orchestration/intent-detection/index.yaml +0 -30
  239. package/templates/agents/manager/supplier/refs/skills/orchestration/pipeline-execution/SKILL.md +0 -188
  240. package/templates/agents/manager/supplier/refs/skills/orchestration/pipeline-execution/index.yaml +0 -27
  241. package/templates/agents/manager/supplier/refs/skills/system/memory-management/index.yaml +0 -30
  242. package/templates/agents/manager/supplier/refs/skills/system/result-aggregation/SKILL.md +0 -163
  243. package/templates/agents/manager/supplier/refs/skills/system/result-aggregation/index.yaml +0 -36
  244. package/templates/agents/manager/sync-checker/AGENT.md +0 -34
  245. package/templates/agents/manager/sync-checker/index.yaml +0 -32
  246. package/templates/agents/manager/updater/index.yaml +0 -31
  247. package/templates/agents/manager/updater/refs/rules/MAY-optimization.md +0 -93
  248. package/templates/agents/manager/updater/refs/rules/MUST-agent-design.md +0 -107
  249. package/templates/agents/manager/updater/refs/rules/MUST-agent-identification.md +0 -108
  250. package/templates/agents/manager/updater/refs/rules/MUST-continuous-improvement.md +0 -132
  251. package/templates/agents/manager/updater/refs/rules/MUST-intent-transparency.md +0 -199
  252. package/templates/agents/manager/updater/refs/rules/MUST-language-policy.md +0 -62
  253. package/templates/agents/manager/updater/refs/rules/MUST-orchestrator-coordination.md +0 -334
  254. package/templates/agents/manager/updater/refs/rules/MUST-parallel-execution.md +0 -398
  255. package/templates/agents/manager/updater/refs/rules/MUST-permissions.md +0 -84
  256. package/templates/agents/manager/updater/refs/rules/MUST-safety.md +0 -69
  257. package/templates/agents/manager/updater/refs/rules/MUST-sync-verification.md +0 -219
  258. package/templates/agents/manager/updater/refs/rules/MUST-tool-identification.md +0 -174
  259. package/templates/agents/manager/updater/refs/rules/SHOULD-ecomode.md +0 -145
  260. package/templates/agents/manager/updater/refs/rules/SHOULD-error-handling.md +0 -102
  261. package/templates/agents/manager/updater/refs/rules/SHOULD-hud-statusline.md +0 -96
  262. package/templates/agents/manager/updater/refs/rules/SHOULD-interaction.md +0 -103
  263. package/templates/agents/manager/updater/refs/rules/SHOULD-memory-integration.md +0 -114
  264. package/templates/agents/manager/updater/refs/rules/SHOULD-pipeline-mode.md +0 -165
  265. package/templates/agents/manager/updater/refs/rules/index.yaml +0 -125
  266. package/templates/agents/orchestrator/dev-lead/AGENT.md +0 -163
  267. package/templates/agents/orchestrator/dev-lead/index.yaml +0 -73
  268. package/templates/agents/orchestrator/planner/AGENT.md +0 -102
  269. package/templates/agents/orchestrator/planner/index.yaml +0 -38
  270. package/templates/agents/orchestrator/qa-lead/AGENT.md +0 -92
  271. package/templates/agents/orchestrator/qa-lead/index.yaml +0 -40
  272. package/templates/agents/orchestrator/secretary/AGENT.md +0 -181
  273. package/templates/agents/orchestrator/secretary/index.yaml +0 -55
  274. package/templates/agents/orchestrator/secretary/refs/rules/MAY-optimization.md +0 -93
  275. package/templates/agents/orchestrator/secretary/refs/rules/MUST-agent-design.md +0 -107
  276. package/templates/agents/orchestrator/secretary/refs/rules/MUST-agent-identification.md +0 -108
  277. package/templates/agents/orchestrator/secretary/refs/rules/MUST-continuous-improvement.md +0 -132
  278. package/templates/agents/orchestrator/secretary/refs/rules/MUST-intent-transparency.md +0 -199
  279. package/templates/agents/orchestrator/secretary/refs/rules/MUST-language-policy.md +0 -62
  280. package/templates/agents/orchestrator/secretary/refs/rules/MUST-orchestrator-coordination.md +0 -334
  281. package/templates/agents/orchestrator/secretary/refs/rules/MUST-parallel-execution.md +0 -398
  282. package/templates/agents/orchestrator/secretary/refs/rules/MUST-permissions.md +0 -84
  283. package/templates/agents/orchestrator/secretary/refs/rules/MUST-safety.md +0 -69
  284. package/templates/agents/orchestrator/secretary/refs/rules/MUST-sync-verification.md +0 -219
  285. package/templates/agents/orchestrator/secretary/refs/rules/MUST-tool-identification.md +0 -174
  286. package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-ecomode.md +0 -145
  287. package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-error-handling.md +0 -102
  288. package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-hud-statusline.md +0 -96
  289. package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-interaction.md +0 -103
  290. package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-memory-integration.md +0 -114
  291. package/templates/agents/orchestrator/secretary/refs/rules/SHOULD-pipeline-mode.md +0 -165
  292. package/templates/agents/orchestrator/secretary/refs/rules/index.yaml +0 -125
  293. package/templates/agents/qa-team/qa-engineer/index.yaml +0 -59
  294. package/templates/agents/qa-team/qa-planner/index.yaml +0 -47
  295. package/templates/agents/qa-team/qa-writer/index.yaml +0 -44
  296. package/templates/agents/sw-architect/documenter/index.yaml +0 -39
  297. package/templates/agents/sw-architect/speckit-agent/index.yaml +0 -78
  298. package/templates/agents/sw-engineer/backend/express-expert/AGENT.md +0 -132
  299. package/templates/agents/sw-engineer/backend/express-expert/index.yaml +0 -36
  300. package/templates/agents/sw-engineer/backend/fastapi-expert/AGENT.md +0 -47
  301. package/templates/agents/sw-engineer/backend/fastapi-expert/index.yaml +0 -27
  302. package/templates/agents/sw-engineer/backend/fastapi-expert/refs/fastapi/best-practices.md +0 -232
  303. package/templates/agents/sw-engineer/backend/fastapi-expert/refs/fastapi/index.yaml +0 -21
  304. package/templates/agents/sw-engineer/backend/fastapi-expert/refs/fastapi-best-practices/SKILL.md +0 -269
  305. package/templates/agents/sw-engineer/backend/fastapi-expert/refs/fastapi-best-practices/index.yaml +0 -25
  306. package/templates/agents/sw-engineer/backend/go-backend-expert/AGENT.md +0 -47
  307. package/templates/agents/sw-engineer/backend/go-backend-expert/index.yaml +0 -27
  308. package/templates/agents/sw-engineer/backend/go-backend-expert/refs/go-backend/index.yaml +0 -26
  309. package/templates/agents/sw-engineer/backend/go-backend-expert/refs/go-backend/project-layout.md +0 -243
  310. package/templates/agents/sw-engineer/backend/go-backend-expert/refs/go-backend/uber-style.md +0 -212
  311. package/templates/agents/sw-engineer/backend/go-backend-expert/refs/go-backend-best-practices/SKILL.md +0 -337
  312. package/templates/agents/sw-engineer/backend/go-backend-expert/refs/go-backend-best-practices/index.yaml +0 -26
  313. package/templates/agents/sw-engineer/backend/nestjs-expert/AGENT.md +0 -107
  314. package/templates/agents/sw-engineer/backend/nestjs-expert/index.yaml +0 -43
  315. package/templates/agents/sw-engineer/backend/springboot-expert/AGENT.md +0 -103
  316. package/templates/agents/sw-engineer/backend/springboot-expert/index.yaml +0 -69
  317. package/templates/agents/sw-engineer/backend/springboot-expert/refs/springboot/best-practices.md +0 -361
  318. package/templates/agents/sw-engineer/backend/springboot-expert/refs/springboot/index.yaml +0 -22
  319. package/templates/agents/sw-engineer/backend/springboot-expert/refs/springboot-best-practices/SKILL.md +0 -356
  320. package/templates/agents/sw-engineer/backend/springboot-expert/refs/springboot-best-practices/index.yaml +0 -27
  321. package/templates/agents/sw-engineer/frontend/svelte-agent/index.yaml +0 -41
  322. package/templates/agents/sw-engineer/frontend/vercel-agent/AGENT.md +0 -67
  323. package/templates/agents/sw-engineer/frontend/vercel-agent/index.yaml +0 -43
  324. package/templates/agents/sw-engineer/frontend/vercel-agent/refs/react-best-practices/SKILL.md +0 -100
  325. package/templates/agents/sw-engineer/frontend/vercel-agent/refs/react-best-practices/index.yaml +0 -39
  326. package/templates/agents/sw-engineer/frontend/vercel-agent/refs/vercel-deploy/SKILL.md +0 -73
  327. package/templates/agents/sw-engineer/frontend/vercel-agent/refs/vercel-deploy/index.yaml +0 -30
  328. package/templates/agents/sw-engineer/frontend/vercel-agent/refs/web-design/accessibility.md +0 -66
  329. package/templates/agents/sw-engineer/frontend/vercel-agent/refs/web-design/index.yaml +0 -20
  330. package/templates/agents/sw-engineer/frontend/vercel-agent/refs/web-design/performance.md +0 -102
  331. package/templates/agents/sw-engineer/frontend/vercel-agent/refs/web-design-guidelines/SKILL.md +0 -117
  332. package/templates/agents/sw-engineer/frontend/vercel-agent/refs/web-design-guidelines/index.yaml +0 -34
  333. package/templates/agents/sw-engineer/frontend/vuejs-agent/index.yaml +0 -48
  334. package/templates/agents/sw-engineer/language/golang-expert/AGENT.md +0 -47
  335. package/templates/agents/sw-engineer/language/golang-expert/index.yaml +0 -27
  336. package/templates/agents/sw-engineer/language/golang-expert/refs/go-best-practices/SKILL.md +0 -202
  337. package/templates/agents/sw-engineer/language/golang-expert/refs/go-best-practices/index.yaml +0 -25
  338. package/templates/agents/sw-engineer/language/golang-expert/refs/golang/concurrency.md +0 -282
  339. package/templates/agents/sw-engineer/language/golang-expert/refs/golang/effective-go.md +0 -309
  340. package/templates/agents/sw-engineer/language/golang-expert/refs/golang/error-handling.md +0 -250
  341. package/templates/agents/sw-engineer/language/golang-expert/refs/golang/index.yaml +0 -27
  342. package/templates/agents/sw-engineer/language/java21-expert/AGENT.md +0 -122
  343. package/templates/agents/sw-engineer/language/java21-expert/index.yaml +0 -51
  344. package/templates/agents/sw-engineer/language/kotlin-expert/AGENT.md +0 -47
  345. package/templates/agents/sw-engineer/language/kotlin-expert/index.yaml +0 -27
  346. package/templates/agents/sw-engineer/language/kotlin-expert/refs/kotlin/coding-conventions.md +0 -247
  347. package/templates/agents/sw-engineer/language/kotlin-expert/refs/kotlin/idioms.md +0 -234
  348. package/templates/agents/sw-engineer/language/kotlin-expert/refs/kotlin/index.yaml +0 -26
  349. package/templates/agents/sw-engineer/language/kotlin-expert/refs/kotlin-best-practices/index.yaml +0 -27
  350. package/templates/agents/sw-engineer/language/python-expert/AGENT.md +0 -47
  351. package/templates/agents/sw-engineer/language/python-expert/index.yaml +0 -27
  352. package/templates/agents/sw-engineer/language/python-expert/refs/python/index.yaml +0 -26
  353. package/templates/agents/sw-engineer/language/python-expert/refs/python/pep8-style-guide.md +0 -202
  354. package/templates/agents/sw-engineer/language/python-expert/refs/python/zen-of-python.md +0 -79
  355. package/templates/agents/sw-engineer/language/python-expert/refs/python-best-practices/index.yaml +0 -25
  356. package/templates/agents/sw-engineer/language/rust-expert/AGENT.md +0 -47
  357. package/templates/agents/sw-engineer/language/rust-expert/index.yaml +0 -27
  358. package/templates/agents/sw-engineer/language/rust-expert/refs/rust/error-handling.md +0 -262
  359. package/templates/agents/sw-engineer/language/rust-expert/refs/rust/index.yaml +0 -26
  360. package/templates/agents/sw-engineer/language/rust-expert/refs/rust/ownership.md +0 -180
  361. package/templates/agents/sw-engineer/language/rust-expert/refs/rust-best-practices/index.yaml +0 -26
  362. package/templates/agents/sw-engineer/language/typescript-expert/AGENT.md +0 -47
  363. package/templates/agents/sw-engineer/language/typescript-expert/index.yaml +0 -27
  364. package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript/advanced-types.md +0 -225
  365. package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript/index.yaml +0 -26
  366. package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript/type-system.md +0 -219
  367. package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript-best-practices/SKILL.md +0 -320
  368. package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript-best-practices/index.yaml +0 -28
  369. package/templates/agents/sw-engineer/tooling/bun-expert/index.yaml +0 -46
  370. package/templates/agents/sw-engineer/tooling/npm-expert/AGENT.md +0 -160
  371. package/templates/agents/sw-engineer/tooling/npm-expert/index.yaml +0 -45
  372. package/templates/agents/sw-engineer/tooling/optimizer/AGENT.md +0 -170
  373. package/templates/agents/sw-engineer/tooling/optimizer/index.yaml +0 -45
  374. package/templates/agents/system/memory-keeper/AGENT.md +0 -126
  375. package/templates/agents/system/memory-keeper/index.yaml +0 -45
  376. package/templates/agents/system/naggy/AGENT.md +0 -72
  377. package/templates/agents/system/naggy/index.yaml +0 -35
  378. package/templates/agents/tutor/go-tutor/index.yaml +0 -48
  379. package/templates/commands/COMMANDS.md +0 -136
  380. package/templates/commands/creator/agent.md +0 -121
  381. package/templates/commands/git/branch.yaml +0 -8
  382. package/templates/commands/git/commit.yaml +0 -4
  383. package/templates/commands/git/pr.yaml +0 -4
  384. package/templates/commands/git/status.yaml +0 -4
  385. package/templates/commands/git/sync.yaml +0 -4
  386. package/templates/commands/index.yaml +0 -225
  387. package/templates/commands/intent/explain.md +0 -144
  388. package/templates/commands/naggy/add.yaml +0 -8
  389. package/templates/commands/naggy/done.yaml +0 -8
  390. package/templates/commands/naggy/list.yaml +0 -4
  391. package/templates/commands/naggy/priority.yaml +0 -11
  392. package/templates/commands/naggy/remind.yaml +0 -4
  393. package/templates/commands/npm/audit.yaml +0 -62
  394. package/templates/commands/npm/publish.yaml +0 -52
  395. package/templates/commands/npm/version.yaml +0 -62
  396. package/templates/commands/optimize/analyze.yaml +0 -34
  397. package/templates/commands/optimize/bundle.yaml +0 -50
  398. package/templates/commands/optimize/report.yaml +0 -56
  399. package/templates/commands/sauron/quick.yaml +0 -4
  400. package/templates/commands/sauron/report.yaml +0 -4
  401. package/templates/commands/sauron/watch.yaml +0 -4
  402. package/templates/commands/supplier/audit.md +0 -133
  403. package/templates/commands/supplier/fix.md +0 -121
  404. package/templates/commands/sync/agents.yaml +0 -4
  405. package/templates/commands/sync/check.yaml +0 -4
  406. package/templates/commands/sync/commands.yaml +0 -4
  407. package/templates/commands/sync/docs.yaml +0 -4
  408. package/templates/commands/sync/fix.yaml +0 -4
  409. package/templates/skills/backend/fastapi-best-practices/SKILL.md +0 -269
  410. package/templates/skills/backend/fastapi-best-practices/index.yaml +0 -25
  411. package/templates/skills/backend/go-backend-best-practices/SKILL.md +0 -337
  412. package/templates/skills/backend/go-backend-best-practices/index.yaml +0 -26
  413. package/templates/skills/backend/springboot-best-practices/index.yaml +0 -27
  414. package/templates/skills/development/go-best-practices/index.yaml +0 -25
  415. package/templates/skills/development/kotlin-best-practices/SKILL.md +0 -255
  416. package/templates/skills/development/kotlin-best-practices/index.yaml +0 -27
  417. package/templates/skills/development/python-best-practices/SKILL.md +0 -221
  418. package/templates/skills/development/python-best-practices/index.yaml +0 -25
  419. package/templates/skills/development/react-best-practices/index.yaml +0 -39
  420. package/templates/skills/development/rust-best-practices/SKILL.md +0 -266
  421. package/templates/skills/development/rust-best-practices/index.yaml +0 -26
  422. package/templates/skills/development/typescript-best-practices/index.yaml +0 -28
  423. package/templates/skills/development/vercel-deploy/SKILL.md +0 -73
  424. package/templates/skills/development/vercel-deploy/index.yaml +0 -30
  425. package/templates/skills/development/web-design-guidelines/SKILL.md +0 -117
  426. package/templates/skills/development/web-design-guidelines/index.yaml +0 -34
  427. package/templates/skills/index.yaml +0 -129
  428. package/templates/skills/infrastructure/aws-best-practices/index.yaml +0 -27
  429. package/templates/skills/infrastructure/docker-best-practices/SKILL.md +0 -274
  430. package/templates/skills/infrastructure/docker-best-practices/index.yaml +0 -26
  431. package/templates/skills/orchestration/intent-detection/index.yaml +0 -30
  432. package/templates/skills/orchestration/intent-detection/patterns/agent-triggers.yaml +0 -342
  433. package/templates/skills/orchestration/pipeline-execution/index.yaml +0 -27
  434. package/templates/skills/system/memory-management/SKILL.md +0 -194
  435. package/templates/skills/system/memory-management/index.yaml +0 -30
  436. package/templates/skills/system/result-aggregation/index.yaml +0 -36
@@ -6,130 +6,143 @@
6
6
 
7
7
  ## CRITICAL
8
8
 
9
- **When a task requires multiple agents, the APPROPRIATE orchestrator MUST coordinate.**
9
+ **The MAIN CONVERSATION is the sole orchestrator. It uses routing skills to delegate tasks to specialized subagents.**
10
10
 
11
- ### Session Continuity (MANDATORY)
11
+ ### Flat Architecture (MANDATORY)
12
12
 
13
13
  ```
14
14
  ╔══════════════════════════════════════════════════════════════════╗
15
- AFTER SESSION RESTART / CONTEXT COMPACTION:
15
+ NEW ARCHITECTURE: FLAT, NO HIERARCHY
16
16
  ║ ║
17
- 1. Re-read CLAUDE.md and rules IMMEDIATELY
18
- 2. Agent delegation rules STILL APPLY
19
- 3. Orchestrator must NOT execute work directly
20
- 4. Must spawn Task agents for actual work
17
+ Main Conversation (orchestrator)
18
+
19
+ ├─ Uses routing skills:
20
+ secretary-routing (agent/system tasks)
21
+ ║ │ • dev-lead-routing (development tasks) ║
22
+ ║ │ • qa-lead-routing (QA tasks) ║
23
+ ║ │ ║
24
+ ║ └─ Spawns subagents (Task tool): ║
25
+ ║ ├─ mgr-creator, mgr-updater, mgr-supplier (manager agents) ║
26
+ ║ ├─ lang-golang-expert, lang-python-expert (language experts) ║
27
+ ║ └─ be-springboot-expert, be-fastapi-expert (framework experts) ║
21
28
  ║ ║
22
- WRONG after session restart:
23
- dev-lead directly runs Bash/Edit/Write
24
- ║ ║
25
- ║ CORRECT after session restart: ║
26
- ║ dev-lead → Task(springboot-expert) → runs Bash/Edit/Write ║
29
+ IMPORTANT: Subagents CANNOT spawn other subagents
30
+ Only main conversation can spawn subagents
27
31
  ╚══════════════════════════════════════════════════════════════════╝
28
32
  ```
29
33
 
30
- ### Orchestrator Direct Action Prohibition (MANDATORY)
34
+ ### Session Continuity (MANDATORY)
31
35
 
32
36
  ```
33
37
  ╔══════════════════════════════════════════════════════════════════╗
34
- ORCHESTRATORS (secretary, dev-lead) MUST NOT:
35
- ║ ║
36
- ║ ✗ Directly run Bash commands for code/build tasks ║
37
- ║ ✗ Directly Edit/Write source code files ║
38
- ║ ✗ Directly modify project configuration ║
38
+ AFTER SESSION RESTART / CONTEXT COMPACTION:
39
39
  ║ ║
40
- ORCHESTRATORS MUST:
40
+ 1. Re-read CLAUDE.md and rules IMMEDIATELY
41
+ ║ 2. Agent delegation rules STILL APPLY ║
42
+ ║ 3. Main conversation uses routing skills to identify agents ║
43
+ ║ 4. Spawn subagents with Task tool for actual work ║
41
44
  ║ ║
42
- Analyze task and identify required agents
43
- Spawn Task agents with appropriate expert roles
44
- ║ ✓ Aggregate results from spawned agents ║
45
- ║ ✓ Report summary to user ║
45
+ WRONG after session restart:
46
+ Main conversation directly writes code/runs builds
46
47
  ║ ║
47
- Only allowed direct tools: Read, Glob, Grep (for analysis)
48
+ CORRECT after session restart:
49
+ ║ Main conversation → Task(be-springboot-expert) → code/build ║
48
50
  ╚══════════════════════════════════════════════════════════════════╝
49
51
  ```
50
52
 
51
- ### Orchestrator Role Separation (MANDATORY)
53
+ ### Routing Logic (MANDATORY)
52
54
 
53
55
  ```
54
56
  ╔══════════════════════════════════════════════════════════════════╗
55
- WHICH ORCHESTRATOR TO USE?
57
+ HOW TO ROUTE TASKS
56
58
  ║ ║
57
- ║ Task Domain → Orchestrator
58
- ─────────────────────────────────────────────────
59
- ║ Agent creation/update/audit → secretary
60
- ║ Code review/refactoring → dev-lead
61
- ║ Feature implementation → dev-lead
62
- ║ Multi-language development → dev-lead
63
- Manager agent coordination secretary
64
- SW/Backend engineer tasks dev-lead
59
+ ║ Task Domain → Routing Skill → Agent
60
+ ──────────────────────────────────────────────────────────────
61
+ ║ Agent creation/update/audit → secretary-routing → mgr-creator
62
+ ║ Code review/refactoring → dev-lead-routing → expert-*
63
+ ║ Feature implementation → dev-lead-routing → expert-*
64
+ ║ Multi-language development → dev-lead-routing → multiple
65
+ System operations → secretary-routing manager
66
+ QA/Testing tasks qa-lead-routing → qa-*
65
67
  ║ ║
66
- WRONG: secretary directing kotlin-expert for code work
67
- RIGHT: dev-lead directing kotlin-expert for code work
68
+ Routing skills contain the logic for:
69
+ Which agent to use for which task
70
+ ║ • When to spawn multiple agents in parallel ║
71
+ ║ • How to aggregate results ║
68
72
  ╚══════════════════════════════════════════════════════════════════╝
69
73
  ```
70
74
 
71
- ### Orchestrator Responsibilities
75
+ ### Routing Skills
72
76
 
73
- | Orchestrator | Supervises | Handles |
74
- |--------------|------------|---------|
75
- | **secretary** | manager/* (creator, updater, supplier, memory-keeper) | Agent management, system operations |
76
- | **dev-lead** | sw-engineer/*, sw-engineer/backend/* | Development, code review, implementation |
77
+ | Routing Skill | Manages | Handles |
78
+ |---------------|---------|---------|
79
+ | **secretary-routing** | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, sys-memory-keeper | Agent management, system operations |
80
+ | **dev-lead-routing** | language/framework experts | Development, code review, implementation |
81
+ | **qa-lead-routing** | qa-planner, qa-writer, qa-engineer | Testing, quality assurance |
77
82
 
78
83
  ```
79
- Multi-agent detection:
84
+ Multi-agent detection (handled by routing skills):
80
85
  - Task spans multiple domains (frontend + backend)
81
- - Task requires different expertise (golang + python)
86
+ - Task requires different expertise (lang-golang + lang-python)
82
87
  - Task involves batch operations on different resources
83
88
 
84
- If multi-agent needed → secretary MUST coordinate
89
+ If multi-agent needed → Spawn multiple subagents in parallel
85
90
  ```
86
91
 
87
92
  ## Coordination Flow
88
93
 
89
94
  ```
90
- CORRECT:
95
+ CORRECT (Flat Architecture):
91
96
  User Request
92
97
 
93
98
 
94
- ┌─────────────────────────────┐
95
- secretary (orchestrator)
96
- │ - Analyzes task
97
- │ - Identifies required agents│
98
- │ - Plans execution
99
- └─────────────┬───────────────┘
99
+ ┌─────────────────────────────────┐
100
+ Main Conversation
101
+ │ - Analyzes task via routing
102
+ │ - Identifies required agents
103
+ │ - Plans execution
104
+ └─────────────┬───────────────────┘
100
105
 
101
106
  ┌─────────┼─────────┐
102
107
  ▼ ▼ ▼
103
- [Agent-1] [Agent-2] [Agent-3]
108
+ [Subagent-1] [Subagent-2] [Subagent-3]
109
+ (spawned via Task tool)
104
110
  │ │ │
105
111
  └─────────┼─────────┘
106
112
 
107
- ┌─────────────────────────────┐
108
- secretary (orchestrator)
109
- │ - Aggregates results
110
- │ - Reports to user
111
- └─────────────────────────────┘
113
+ ┌─────────────────────────────────┐
114
+ Main Conversation
115
+ │ - Aggregates results
116
+ │ - Reports to user
117
+ └─────────────────────────────────┘
112
118
 
113
- WRONG:
119
+ WRONG (Hierarchical):
120
+ User Request
121
+
122
+
123
+ [Subagent-1] → spawns → [Subagent-2] → spawns → [Subagent-3]
124
+ (Subagents cannot spawn other subagents)
125
+
126
+ WRONG (No coordination):
114
127
  User Request
115
128
 
116
129
 
117
130
  [Agent-1] → [Agent-2] → [Agent-3]
118
- (No coordination, ad-hoc execution)
131
+ (Sequential execution without planning)
119
132
  ```
120
133
 
121
- ## Secretary Responsibilities
134
+ ## Main Conversation Responsibilities
122
135
 
123
136
  ```yaml
124
137
  before_execution:
125
138
  - Analyze user request
139
+ - Apply routing skill (secretary/dev-lead/qa-lead)
126
140
  - Identify required agents
127
- - Check agent availability
128
141
  - Plan execution order (parallel vs sequential)
129
142
  - Announce coordination plan
130
143
 
131
144
  during_execution:
132
- - Spawn agent instances
145
+ - Spawn subagent instances via Task tool
133
146
  - Monitor progress
134
147
  - Handle failures
135
148
  - Coordinate dependencies
@@ -142,40 +155,39 @@ after_execution:
142
155
 
143
156
  ## Announcement Format
144
157
 
145
- Secretary MUST announce before delegating:
158
+ Main conversation MUST announce before delegating:
146
159
 
147
160
  ```
148
- ┌─ Agent: secretary (orchestrator)
149
- └─ Task: Coordinating multi-agent task
161
+ [Routing] Using dev-lead-routing for code review
150
162
 
151
163
  [Plan]
152
- ├── Agent 1: golang-expert → Review Go code
153
- ├── Agent 2: python-expert → Review Python code
154
- └── Agent 3: typescript-expert → Review TS code
164
+ ├── Agent 1: lang-golang-expert → Review Go code
165
+ ├── Agent 2: lang-python-expert → Review Python code
166
+ └── Agent 3: lang-typescript-expert → Review TS code
155
167
 
156
168
  [Execution] Parallel (3 instances)
157
169
 
158
- Spawning agents...
170
+ Spawning subagents...
159
171
  ```
160
172
 
161
- ## When to Use Orchestrator
173
+ ## When to Spawn Subagents
162
174
 
163
- | Scenario | Orchestrator Required |
164
- |----------|----------------------|
165
- | Single domain, single file | No |
166
- | Single domain, multiple files | Maybe (if parallel) |
175
+ | Scenario | Spawn Subagents? |
176
+ |----------|------------------|
177
+ | Single domain, single file | Maybe (if specialized agent needed) |
178
+ | Single domain, multiple files | Yes (if parallel beneficial) |
167
179
  | Multiple domains | **Yes** |
168
180
  | Batch operations | **Yes** |
169
181
  | Complex workflow | **Yes** |
170
182
 
171
183
  ## Exception: Simple Tasks
172
184
 
173
- Orchestrator NOT required for:
174
- - Single file operations
175
- - Single domain questions
176
- - Direct tool usage (Read, Write, etc.)
185
+ Subagent NOT required for:
186
+ - Reading files for analysis
187
+ - Simple file searches
188
+ - Direct questions answered by main conversation
177
189
 
178
- These can be handled by the appropriate agent directly.
190
+ For specialized work, ALWAYS delegate to appropriate subagent.
179
191
 
180
192
  ## CRITICAL: Use Specialized Manager Agents
181
193
 
@@ -187,10 +199,10 @@ These can be handled by the appropriate agent directly.
187
199
  ║ ║
188
200
  ║ Task Type → Required Agent ║
189
201
  ║ ───────────────────────────────────────────────── ║
190
- ║ Create new agent → creator
191
- ║ Update external agent → updater
192
- ║ Audit dependencies → supplier
193
- ║ Memory operations → memory-keeper
202
+ ║ Create new agent → mgr-creator
203
+ ║ Update external agent → mgr-updater
204
+ ║ Audit dependencies → mgr-supplier
205
+ ║ Memory operations → sys-memory-keeper
194
206
  ║ ║
195
207
  ║ DO NOT use general-purpose agents for these tasks. ║
196
208
  ║ DO NOT have secretary do the work directly. ║
@@ -200,31 +212,31 @@ These can be handled by the appropriate agent directly.
200
212
  ### Correct Delegation Pattern
201
213
 
202
214
  ```
203
- User: "java21-expert 에이전트를 만들어줘"
215
+ User: "lang-java21-expert 에이전트를 만들어줘"
204
216
 
205
217
  WRONG:
206
218
  secretary → Task(general-purpose) → creates files directly
207
219
 
208
220
  CORRECT:
209
- secretary → Task(creator agent role) → follows creator workflow
221
+ secretary → Task(mgr-creator agent role) → follows creator workflow
210
222
  ```
211
223
 
212
224
  ### Manager Agents Reference
213
225
 
214
- | Agent | Location | Purpose |
215
- |-------|----------|---------|
216
- | creator | agents/manager/creator/ | Create new agents |
217
- | updater | agents/manager/updater/ | Update external sources |
218
- | supplier | agents/manager/supplier/ | Audit dependencies |
219
- | gitnerd | agents/manager/gitnerd/ | Git operations (commit, push, PR) |
220
- | sync-checker | agents/manager/sync-checker/ | Documentation sync verification |
226
+ | Agent | File | Purpose |
227
+ |-------|------|---------|
228
+ | mgr-creator | .claude/agents/mgr-creator.md | Create new agents |
229
+ | mgr-updater | .claude/agents/mgr-updater.md | Update external sources |
230
+ | mgr-supplier | .claude/agents/mgr-supplier.md | Audit dependencies |
231
+ | mgr-gitnerd | .claude/agents/mgr-gitnerd.md | Git operations (commit, push, PR) |
232
+ | mgr-sync-checker | .claude/agents/mgr-sync-checker.md | Documentation sync verification |
221
233
 
222
234
  ### System Agents Reference
223
235
 
224
- | Agent | Location | Purpose |
225
- |-------|----------|---------|
226
- | memory-keeper | agents/system/memory-keeper/ | Memory operations |
227
- | naggy | agents/system/naggy/ | TODO management |
236
+ | Agent | File | Purpose |
237
+ |-------|------|---------|
238
+ | sys-memory-keeper | .claude/agents/sys-memory-keeper.md | Memory operations |
239
+ | sys-naggy | .claude/agents/sys-naggy.md | TODO management |
228
240
 
229
241
  ## CRITICAL: Use Specialized Expert Agents for Code Work
230
242
 
@@ -234,16 +246,16 @@ CORRECT:
234
246
  ║ ║
235
247
  ║ Language/Framework → Required Agent ║
236
248
  ║ ───────────────────────────────────────────────── ║
237
- ║ Python/FastAPI backend → python-expert or fastapi-expert
238
- ║ TypeScript/Next.js frontend → typescript-expert or vercel-agent║
239
- ║ Go code → golang-expert
240
- ║ Kotlin/Spring → kotlin-expert or springboot-expert║
249
+ ║ Python/FastAPI backend → lang-python-expert or be-fastapi-expert
250
+ ║ TypeScript/Next.js frontend → lang-typescript-expert or fe-vercel-agent
251
+ ║ Go code → lang-golang-expert
252
+ ║ Kotlin/Spring → lang-kotlin-expert or be-springboot-expert
241
253
  ║ ║
242
254
  ║ WRONG: ║
243
255
  ║ secretary → Task(general-purpose) → writes Python code ║
244
256
  ║ ║
245
257
  ║ CORRECT: ║
246
- ║ secretary → Task(python-expert) → writes Python code
258
+ ║ secretary → Task(lang-python-expert) → writes Python code
247
259
  ║ ║
248
260
  ║ general-purpose should ONLY be used when: ║
249
261
  ║ - No specialized agent exists for the task ║
@@ -251,6 +263,42 @@ CORRECT:
251
263
  ╚══════════════════════════════════════════════════════════════════╝
252
264
  ```
253
265
 
266
+ ## CRITICAL: Use Specialized Agents for Documentation & Spec Writing
267
+
268
+ ```
269
+ ╔══════════════════════════════════════════════════════════════════╗
270
+ ║ DOCUMENTATION/SPEC WORK MUST USE SPECIALIZED AGENTS ║
271
+ ║ ║
272
+ ║ Document Type → Required Agent ║
273
+ ║ ───────────────────────────────────────────────── ║
274
+ ║ Architecture docs/ADR → arch-documenter ║
275
+ ║ API specification (OpenAPI) → arch-documenter ║
276
+ ║ Technical design docs → arch-documenter ║
277
+ ║ Frontend UI/page specs → fe-vercel-agent / fe-* agents ║
278
+ ║ Component design specs → fe-vercel-agent / fe-* agents ║
279
+ ║ CI/CD pipeline specs → mgr-gitnerd ║
280
+ ║ GitHub repository config → mgr-gitnerd ║
281
+ ║ Docker/infra specs → infra-docker-expert ║
282
+ ║ AWS architecture specs → infra-aws-expert ║
283
+ ║ Database schema specs → db-supabase-expert ║
284
+ ║ Test strategy/plans → qa-planner ║
285
+ ║ Test case documentation → qa-writer ║
286
+ ║ ║
287
+ ║ WRONG: ║
288
+ ║ orchestrator → Task(general-purpose) → writes API spec ║
289
+ ║ ║
290
+ ║ CORRECT: ║
291
+ ║ orchestrator → Task(arch-documenter) → writes API spec ║
292
+ ║ ║
293
+ ║ general-purpose should ONLY be used when: ║
294
+ ║ - No specialized agent exists for the document type ║
295
+ ║ - Document is truly generic (meeting notes, simple lists) ║
296
+ ║ ║
297
+ ║ RULE: If the document requires domain expertise to write ║
298
+ ║ correctly, it MUST be delegated to the domain expert. ║
299
+ ╚══════════════════════════════════════════════════════════════════╝
300
+ ```
301
+
254
302
  ## CRITICAL: Sub-agent Model Specification
255
303
 
256
304
  ```
@@ -290,32 +338,63 @@ CORRECT:
290
338
  | Agent Category | Model | Examples |
291
339
  |----------------|-------|----------|
292
340
  | Orchestrator judgment | `opus` | Complex routing decisions |
293
- | Manager agents | `sonnet` | creator, updater, supplier |
341
+ | Manager agents | `sonnet` | mgr-creator, mgr-updater, mgr-supplier |
294
342
  | Simple utilities | `haiku` | File operations, search |
295
- | Expert agents | `sonnet` | golang-expert, python-expert |
343
+ | Expert agents | `sonnet` | lang-golang-expert, lang-python-expert |
296
344
 
297
345
  ## CRITICAL: Git Operations Delegation
298
346
 
299
347
  ```
300
348
  ╔══════════════════════════════════════════════════════════════════╗
301
- ║ GIT OPERATIONS MUST BE DELEGATED TO gitnerd
349
+ ║ GIT OPERATIONS MUST BE DELEGATED TO mgr-gitnerd
302
350
  ║ ║
303
351
  ║ WRONG: ║
304
- secretary/dev-lead → directly runs git commit/push
352
+ Main conversation → directly runs git commit/push
305
353
  ║ ║
306
354
  ║ CORRECT: ║
307
- secretary → Task(gitnerd) → git commit/push
355
+ Main conversation → Task(mgr-gitnerd) → git commit/push
308
356
  ║ ║
309
- ║ gitnerd handles:
357
+ mgr-gitnerd handles:
310
358
  ║ ✓ git commit (with proper message format) ║
311
359
  ║ ✓ git push ║
312
- ║ ✓ git branch operations
313
- ║ ✓ PR creation
360
+ ║ ✓ git branch operations
361
+ ║ ✓ PR creation (gh pr create)
314
362
  ║ ║
315
363
  ║ This ensures: ║
316
364
  ║ - Consistent commit message format ║
317
- ║ - Safety checks before destructive operations
318
- ║ - Proper Co-Authored-By attribution
365
+ ║ - Safety checks before destructive operations
366
+ ║ - Proper Co-Authored-By attribution
367
+ ╚══════════════════════════════════════════════════════════════════╝
368
+ ```
369
+
370
+ ## CRITICAL: External Skills vs Internal Rules
371
+
372
+ ```
373
+ ╔══════════════════════════════════════════════════════════════════╗
374
+ ║ INTERNAL RULES ALWAYS TAKE PRECEDENCE OVER EXTERNAL SKILLS ║
375
+ ║ ║
376
+ ║ External skills (e.g., finishing-a-development-branch) may ║
377
+ ║ instruct direct git operations. IGNORE those instructions and ║
378
+ ║ apply internal rules instead. ║
379
+ ║ ║
380
+ ║ Translation: ║
381
+ ║ External skill says → Internal rule requires ║
382
+ ║ ───────────────────────────────────────────────────────────── ║
383
+ ║ "git commit -m ..." → Task(mgr-gitnerd) commit ║
384
+ ║ "git push ..." → Task(mgr-gitnerd) push ║
385
+ ║ "gh pr create ..." → Task(mgr-gitnerd) create PR ║
386
+ ║ "git merge ..." → Task(mgr-gitnerd) merge ║
387
+ ║ ║
388
+ ║ WRONG: ║
389
+ ║ [Using finishing-a-development-branch skill] ║
390
+ ║ Main conversation → directly runs "git push" as skill says ║
391
+ ║ ║
392
+ ║ CORRECT: ║
393
+ ║ [Using finishing-a-development-branch skill] ║
394
+ ║ Main conversation → Task(mgr-gitnerd) → git push ║
395
+ ║ ║
396
+ ║ The skill's WORKFLOW is followed, but git EXECUTION is ║
397
+ ║ delegated to mgr-gitnerd per R010. ║
319
398
  ╚══════════════════════════════════════════════════════════════════╝
320
399
  ```
321
400
 
@@ -323,12 +402,12 @@ CORRECT:
323
402
 
324
403
  ```
325
404
  Violation examples:
326
- ✗ Reviewing Go + Python + TypeScript without secretary
405
+ ✗ Reviewing Go + Python + TypeScript without routing/delegation
327
406
  ✗ Creating multiple agents without coordination plan
328
407
  ✗ Running parallel tasks without announcing execution plan
329
408
 
330
409
  Correct examples:
331
- Secretary announces plan, spawns agents, aggregates results
410
+ Main conversation announces plan, spawns agents, aggregates results
332
411
  ✓ Clear execution plan with agent assignments
333
412
  ✓ Progress updates during multi-agent execution
334
413
  ```
@@ -48,7 +48,7 @@ Failure to parallelize independent tasks = Rule violation = Must be corrected.
48
48
  ║ → Spawn parallel agents instead. ║
49
49
  ║ ║
50
50
  ║ 3. Are there domain-specific experts available? ║
51
- ║ → YES: Delegate to them (kotlin-expert, springboot-expert)
51
+ ║ → YES: Delegate to them (lang-kotlin-expert, be-springboot-expert)
52
52
  ║ → NO: Create general-purpose parallel agents ║
53
53
  ╚══════════════════════════════════════════════════════════════════╝
54
54
  ```
@@ -69,20 +69,20 @@ Failure to parallelize independent tasks = Rule violation = Must be corrected.
69
69
  Secretary writes domain/, usecase/, infrastructure/ sequentially
70
70
 
71
71
  ✓ CORRECT: Delegate to specialists
72
- Task(kotlin-expert → domain layer)
73
- Task(springboot-expert → infrastructure layer)
74
- Task(kotlin-expert → usecase layer)
72
+ Task(lang-kotlin-expert → domain layer)
73
+ Task(be-springboot-expert → infrastructure layer)
74
+ Task(lang-kotlin-expert → usecase layer)
75
75
 
76
76
  ❌ WRONG: Single Task delegating to multiple agents
77
- Task(dev-lead → "coordinate kotlin-expert and springboot-expert")
77
+ Task(dev-lead → "coordinate lang-kotlin-expert and be-springboot-expert")
78
78
 
79
79
  This creates a SEQUENTIAL bottleneck inside the Task!
80
80
 
81
81
  ✓ CORRECT: Multiple Tasks in parallel, one per agent
82
- Task(kotlin-expert → usecase commands) ┐
83
- Task(kotlin-expert → usecase queries) ├─ All spawned together
84
- Task(springboot-expert → persistence)
85
- Task(springboot-expert → security)
82
+ Task(lang-kotlin-expert → usecase commands) ┐
83
+ Task(lang-kotlin-expert → usecase queries) ├─ All spawned together
84
+ Task(be-springboot-expert → persistence)
85
+ Task(be-springboot-expert → security)
86
86
  ```
87
87
 
88
88
  ### Parallel Task Spawning Rule
@@ -257,10 +257,10 @@ User: "Create golang, python, rust, typescript expert agents"
257
257
 
258
258
  Orchestrator (secretary):
259
259
 
260
- ├── [golang-expert] creator instance #1
261
- ├── [python-expert] creator instance #2
262
- ├── [rust-expert] creator instance #3
263
- └── [typescript-expert] creator instance #4
260
+ ├── [lang-golang-expert] mgr-creator instance #1
261
+ ├── [lang-python-expert] mgr-creator instance #2
262
+ ├── [lang-rust-expert] mgr-creator instance #3
263
+ └── [lang-typescript-expert] mgr-creator instance #4
264
264
 
265
265
  Execution: Parallel (4 instances)
266
266
  ```
@@ -272,9 +272,9 @@ User: "/dev:review src/*.go src/*.py src/*.ts"
272
272
 
273
273
  Orchestrator:
274
274
 
275
- ├── [src/*.go] golang-expert instance #1
276
- ├── [src/*.py] python-expert instance #2
277
- └── [src/*.ts] typescript-expert instance #3
275
+ ├── [src/*.go] lang-golang-expert instance #1
276
+ ├── [src/*.py] lang-python-expert instance #2
277
+ └── [src/*.ts] lang-typescript-expert instance #3
278
278
 
279
279
  Execution: Parallel (3 instances)
280
280
  ```
@@ -286,10 +286,10 @@ User: "Audit all agents"
286
286
 
287
287
  Orchestrator (secretary):
288
288
 
289
- ├── [agent-1] supplier instance #1
290
- ├── [agent-2] supplier instance #2
291
- ├── [agent-3] supplier instance #3
292
- └── [agent-4] supplier instance #4
289
+ ├── [agent-1] mgr-supplier instance #1
290
+ ├── [agent-2] mgr-supplier instance #2
291
+ ├── [agent-3] mgr-supplier instance #3
292
+ └── [agent-4] mgr-supplier instance #4
293
293
 
294
294
  Execution: Parallel (4 instances, batched if > 4)
295
295
  ```
@@ -353,17 +353,17 @@ When parallel execution occurs, MUST display `{task-name}:{model}` format:
353
353
 
354
354
  [Parallel] Spawning 4 instances...
355
355
 
356
- [Instance 1] creator-golang:sonnet → golang-expert
357
- [Instance 2] creator-python:sonnet → python-expert
358
- [Instance 3] creator-rust:sonnet → rust-expert
359
- [Instance 4] creator-typescript:sonnet → typescript-expert
356
+ [Instance 1] mgr-creator:sonnet → lang-golang-expert
357
+ [Instance 2] mgr-creator:sonnet → lang-python-expert
358
+ [Instance 3] mgr-creator:sonnet → lang-rust-expert
359
+ [Instance 4] mgr-creator:sonnet → lang-typescript-expert
360
360
 
361
361
  [Progress] ████████░░░░ 2/4
362
362
 
363
- [Instance 1] creator-golang:sonnet ✓ golang-expert created
364
- [Instance 2] creator-python:sonnet ✓ python-expert created
365
- [Instance 3] creator-rust:sonnet ✓ rust-expert created
366
- [Instance 4] creator-typescript:sonnet ✓ typescript-expert created
363
+ [Instance 1] mgr-creator:sonnet ✓ lang-golang-expert created
364
+ [Instance 2] mgr-creator:sonnet ✓ lang-python-expert created
365
+ [Instance 3] mgr-creator:sonnet ✓ lang-rust-expert created
366
+ [Instance 4] mgr-creator:sonnet ✓ lang-typescript-expert created
367
367
 
368
368
  [Summary] 4/4 tasks completed successfully
369
369
  ```