@bonesofspring/ai-rules 0.2.4 → 0.2.6

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 (327) hide show
  1. package/CHANGELOG.md +22 -5
  2. package/README.md +13 -1
  3. package/bin/cli.js +2 -0
  4. package/package.json +8 -1
  5. package/presets/_shared/README.md +47 -0
  6. package/presets/_shared/core/agent-team/agent-team-intake.md +9 -0
  7. package/presets/_shared/core/agent-team/agent-team-orchestrator.md +142 -0
  8. package/presets/_shared/core/architecture/feature-delivery-workflow.md +46 -0
  9. package/presets/_shared/core/architecture/reference-features.template.md +31 -0
  10. package/presets/_shared/core/meta/preset-layering.md +25 -0
  11. package/presets/_shared/core/meta/preset-no-cross-stack-leakage.md +43 -0
  12. package/presets/_shared/core/meta/preset-pr-checklist.md +28 -0
  13. package/presets/_shared/core/meta/preset-token-budget.md +30 -0
  14. package/presets/_shared/core/meta/preset-twin-sync.md +31 -0
  15. package/presets/_shared/core/quality/code-quality-and-refactoring.md +58 -0
  16. package/presets/_shared/core/quality/design-guidance.md +97 -0
  17. package/presets/_shared/core/review/code-review-mr.md +29 -0
  18. package/presets/_shared/core/review/technical-retro.md +7 -0
  19. package/presets/claude/go/CLAUDE.md +10 -0
  20. package/presets/claude/go/MCP.md +16 -0
  21. package/presets/claude/go/README.md +34 -0
  22. package/presets/claude/go/agents/README.md +15 -0
  23. package/presets/claude/go/agents/api-contract-reviewer.md +23 -0
  24. package/presets/claude/go/agents/build-verifier.md +30 -0
  25. package/presets/claude/go/agents/ci-investigator.md +17 -0
  26. package/presets/claude/go/agents/code-reviewer.md +40 -0
  27. package/presets/claude/go/agents/debugger.md +25 -0
  28. package/presets/claude/go/agents/feature-developer.md +30 -0
  29. package/presets/claude/go/agents/integration-test-generator.md +22 -0
  30. package/presets/claude/go/agents/integration-test-healer.md +22 -0
  31. package/presets/claude/go/agents/integration-test-planner.md +22 -0
  32. package/presets/claude/go/agents/migration-specialist.md +31 -0
  33. package/presets/claude/go/agents/performance-auditor.md +22 -0
  34. package/presets/claude/go/agents/qa-tester.md +24 -0
  35. package/presets/claude/go/agents/security-reviewer.md +20 -0
  36. package/presets/claude/go/agents/solution-architect.md +28 -0
  37. package/presets/claude/go/agents/task-analyst.md +25 -0
  38. package/presets/claude/go/agents/task-router.md +69 -0
  39. package/presets/claude/go/agents/tech-writer.md +15 -0
  40. package/presets/claude/go/agents/unit-test-generator.md +21 -0
  41. package/presets/claude/go/agents/unit-test-healer.md +13 -0
  42. package/presets/claude/go/agents/unit-test-planner.md +26 -0
  43. package/presets/claude/go/commands/README.md +13 -0
  44. package/presets/claude/go/commands/feature-continue.md +51 -0
  45. package/presets/claude/go/commands/feature-start.md +30 -0
  46. package/presets/claude/go/commands/task-continue.md +49 -0
  47. package/presets/claude/go/commands/task.md +49 -0
  48. package/presets/claude/go/commands/technical-retro.md +58 -0
  49. package/presets/claude/go/hooks/README.md +10 -0
  50. package/presets/claude/go/hooks/chain-team-phases.sh +381 -0
  51. package/presets/claude/go/hooks/guard-shell-command.sh +79 -0
  52. package/presets/claude/go/mcp.json +12 -0
  53. package/presets/claude/go/rules/README.md +60 -0
  54. package/presets/claude/go/rules/api-and-data/README.md +14 -0
  55. package/presets/claude/go/rules/api-and-data/adapters-driven.md +34 -0
  56. package/presets/claude/go/rules/api-and-data/adapters-driving.md +35 -0
  57. package/presets/claude/go/rules/api-and-data/api-grpc.md +27 -0
  58. package/presets/claude/go/rules/api-and-data/api-http.md +26 -0
  59. package/presets/claude/go/rules/api-and-data/messaging-adapters.md +21 -0
  60. package/presets/claude/go/rules/api-and-data/persistence-adapters.md +28 -0
  61. package/presets/claude/go/rules/architecture/README.md +16 -0
  62. package/presets/claude/go/rules/architecture/application-usecases.md +29 -0
  63. package/presets/claude/go/rules/architecture/boundaries.md +29 -0
  64. package/presets/claude/go/rules/architecture/composition-root.md +28 -0
  65. package/presets/claude/go/rules/architecture/domain-layer.md +32 -0
  66. package/presets/claude/go/rules/architecture/feature-delivery.md +51 -0
  67. package/presets/claude/go/rules/architecture/module-public-api.md +23 -0
  68. package/presets/claude/go/rules/architecture/ports-interfaces.md +34 -0
  69. package/presets/claude/go/rules/architecture/reference-features.md +30 -0
  70. package/presets/claude/go/rules/stack/README.md +10 -0
  71. package/presets/claude/go/rules/stack/go-app-core.md +31 -0
  72. package/presets/claude/go/rules/stack/go-conventions.md +24 -0
  73. package/presets/claude/go/rules/testing/README.md +11 -0
  74. package/presets/claude/go/rules/testing/e2e.md +18 -0
  75. package/presets/claude/go/rules/testing/integration.md +23 -0
  76. package/presets/claude/go/rules/testing/unit.md +24 -0
  77. package/presets/claude/go/rules/tooling-and-review/README.md +21 -0
  78. package/presets/claude/go/rules/tooling-and-review/agent-team-intake.md +25 -0
  79. package/presets/claude/go/rules/tooling-and-review/agent-team-orchestrator.md +161 -0
  80. package/presets/claude/go/rules/tooling-and-review/code-quality.md +72 -0
  81. package/presets/claude/go/rules/tooling-and-review/code-review.md +48 -0
  82. package/presets/claude/go/rules/tooling-and-review/design-guidance.md +110 -0
  83. package/presets/claude/go/rules/tooling-and-review/go-tooling.md +38 -0
  84. package/presets/claude/go/rules/tooling-and-review/post-change-test.md +32 -0
  85. package/presets/claude/go/rules/tooling-and-review/preset-layering.md +36 -0
  86. package/presets/claude/go/rules/tooling-and-review/preset-no-cross-stack-leakage.md +58 -0
  87. package/presets/claude/go/rules/tooling-and-review/preset-pr-checklist.md +39 -0
  88. package/presets/claude/go/rules/tooling-and-review/preset-token-budget.md +41 -0
  89. package/presets/claude/go/rules/tooling-and-review/preset-twin-sync.md +42 -0
  90. package/presets/claude/go/rules/tooling-and-review/security-go.md +22 -0
  91. package/presets/claude/go/rules/tooling-and-review/technical-retro.md +19 -0
  92. package/presets/claude/go/rules/ui-and-accessibility/README.md +3 -0
  93. package/presets/claude/go/skills/README.md +5 -0
  94. package/presets/claude/go/skills/ci-investigation/SKILL.md +11 -0
  95. package/presets/claude/go/skills/code-review/SKILL.md +16 -0
  96. package/presets/claude/go/skills/debug-investigation/SKILL.md +15 -0
  97. package/presets/claude/go/skills/feature-delivery/SKILL.md +26 -0
  98. package/presets/claude/go/skills/integration-testing/SKILL.md +15 -0
  99. package/presets/claude/go/skills/technical-retro/SKILL.md +10 -0
  100. package/presets/claude/go/skills/unit-testing/SKILL.md +14 -0
  101. package/presets/claude/go/team/README.md +27 -0
  102. package/presets/claude/go/team/fixtures/bugfix-standard.json +37 -0
  103. package/presets/claude/go/team/fixtures/feature-full.json +43 -0
  104. package/presets/claude/go/team/fixtures/feature-light.json +17 -0
  105. package/presets/claude/ios-swift/README.md +7 -0
  106. package/presets/claude/ios-swift/agents/README.md +16 -2
  107. package/presets/claude/ios-swift/agents/build-verifier.md +17 -8
  108. package/presets/claude/ios-swift/agents/code-reviewer.md +4 -0
  109. package/presets/claude/ios-swift/agents/debugger.md +4 -0
  110. package/presets/claude/ios-swift/agents/feature-developer.md +4 -0
  111. package/presets/claude/ios-swift/agents/migration-specialist.md +5 -1
  112. package/presets/claude/ios-swift/agents/performance-auditor.md +5 -1
  113. package/presets/claude/ios-swift/agents/qa-tester.md +4 -0
  114. package/presets/claude/ios-swift/agents/security-reviewer.md +1 -1
  115. package/presets/claude/ios-swift/agents/solution-architect.md +5 -1
  116. package/presets/claude/ios-swift/agents/task-analyst.md +4 -0
  117. package/presets/claude/ios-swift/agents/task-router.md +9 -0
  118. package/presets/claude/ios-swift/agents/unit-test-generator.md +4 -0
  119. package/presets/claude/ios-swift/agents/unit-test-healer.md +4 -0
  120. package/presets/claude/ios-swift/agents/unit-test-planner.md +4 -0
  121. package/presets/claude/ios-swift/rules/README.md +24 -2
  122. package/presets/claude/ios-swift/rules/architecture/feature-delivery.md +5 -0
  123. package/presets/claude/ios-swift/rules/architecture/reference-features.md +5 -0
  124. package/presets/claude/ios-swift/rules/tooling-and-review/agent-team-intake.md +2 -2
  125. package/presets/claude/ios-swift/rules/tooling-and-review/agent-team-orchestrator.md +15 -0
  126. package/presets/claude/ios-swift/rules/tooling-and-review/code-quality.md +53 -20
  127. package/presets/claude/ios-swift/rules/tooling-and-review/code-review.md +29 -35
  128. package/presets/claude/ios-swift/rules/tooling-and-review/design-guidance.md +110 -0
  129. package/presets/claude/ios-swift/rules/tooling-and-review/preset-layering.md +36 -0
  130. package/presets/claude/ios-swift/rules/tooling-and-review/preset-no-cross-stack-leakage.md +54 -0
  131. package/presets/claude/ios-swift/rules/tooling-and-review/preset-pr-checklist.md +39 -0
  132. package/presets/claude/ios-swift/rules/tooling-and-review/preset-token-budget.md +41 -0
  133. package/presets/claude/ios-swift/rules/tooling-and-review/preset-twin-sync.md +42 -0
  134. package/presets/claude/ios-swift/rules/tooling-and-review/technical-retro.md +5 -3
  135. package/presets/claude/ios-swift/skills/code-review/SKILL.md +4 -0
  136. package/presets/claude/ios-swift/skills/debug-investigation/SKILL.md +4 -0
  137. package/presets/claude/ios-swift/skills/feature-delivery/SKILL.md +4 -0
  138. package/presets/claude/ios-swift/team/fixtures/feature-full.json +8 -25
  139. package/presets/claude/ios-swift/team/fixtures/feature-light.json +5 -20
  140. package/presets/claude/next/README.md +9 -1
  141. package/presets/claude/next/agents/README.md +38 -4
  142. package/presets/claude/next/agents/build-verifier.md +24 -0
  143. package/presets/claude/next/agents/code-reviewer.md +4 -0
  144. package/presets/claude/next/agents/debugger.md +4 -0
  145. package/presets/claude/next/agents/feature-developer.md +4 -0
  146. package/presets/claude/next/agents/migration-specialist.md +5 -1
  147. package/presets/claude/next/agents/performance-auditor.md +5 -1
  148. package/presets/claude/next/agents/qa-tester.md +4 -0
  149. package/presets/claude/next/agents/security-reviewer.md +1 -1
  150. package/presets/claude/next/agents/solution-architect.md +5 -1
  151. package/presets/claude/next/agents/task-analyst.md +4 -0
  152. package/presets/claude/next/agents/task-router.md +15 -1
  153. package/presets/claude/next/agents/unit-test-generator.md +4 -0
  154. package/presets/claude/next/agents/unit-test-healer.md +4 -0
  155. package/presets/claude/next/agents/unit-test-planner.md +4 -0
  156. package/presets/claude/next/rules/README.md +74 -21
  157. package/presets/claude/next/rules/architecture/feature-delivery-workflow.md +5 -0
  158. package/presets/claude/next/rules/architecture/reference-features.md +5 -0
  159. package/presets/claude/next/rules/tooling-and-review/agent-team-intake.md +2 -0
  160. package/presets/claude/next/rules/tooling-and-review/agent-team-orchestrator.md +18 -1
  161. package/presets/claude/next/rules/tooling-and-review/code-quality.md +48 -20
  162. package/presets/claude/next/rules/tooling-and-review/code-review-mr.md +17 -8
  163. package/presets/claude/next/rules/tooling-and-review/design-guidance.md +110 -0
  164. package/presets/claude/next/rules/tooling-and-review/preset-layering.md +36 -0
  165. package/presets/claude/next/rules/tooling-and-review/preset-no-cross-stack-leakage.md +54 -0
  166. package/presets/claude/next/rules/tooling-and-review/preset-pr-checklist.md +39 -0
  167. package/presets/claude/next/rules/tooling-and-review/preset-token-budget.md +41 -0
  168. package/presets/claude/next/rules/tooling-and-review/preset-twin-sync.md +42 -0
  169. package/presets/claude/next/rules/tooling-and-review/technical-retro.md +16 -0
  170. package/presets/claude/next/skills/code-review/SKILL.md +4 -0
  171. package/presets/claude/next/skills/debug-investigation/SKILL.md +4 -0
  172. package/presets/claude/next/skills/feature-delivery/SKILL.md +4 -0
  173. package/presets/claude/next/team/fixtures/feature-full.json +4 -2
  174. package/presets/claude/next/team/fixtures/feature-light.json +2 -2
  175. package/presets/cursor/go/AGENTS.md +24 -0
  176. package/presets/cursor/go/BUGBOT.md +9 -0
  177. package/presets/cursor/go/MCP.md +16 -0
  178. package/presets/cursor/go/README.md +38 -0
  179. package/presets/cursor/go/agents/README.md +15 -0
  180. package/presets/cursor/go/agents/api-contract-reviewer.md +23 -0
  181. package/presets/cursor/go/agents/build-verifier.md +30 -0
  182. package/presets/cursor/go/agents/ci-investigator.md +17 -0
  183. package/presets/cursor/go/agents/code-reviewer.md +40 -0
  184. package/presets/cursor/go/agents/debugger.md +25 -0
  185. package/presets/cursor/go/agents/feature-developer.md +30 -0
  186. package/presets/cursor/go/agents/integration-test-generator.md +22 -0
  187. package/presets/cursor/go/agents/integration-test-healer.md +22 -0
  188. package/presets/cursor/go/agents/integration-test-planner.md +22 -0
  189. package/presets/cursor/go/agents/migration-specialist.md +31 -0
  190. package/presets/cursor/go/agents/performance-auditor.md +22 -0
  191. package/presets/cursor/go/agents/qa-tester.md +24 -0
  192. package/presets/cursor/go/agents/security-reviewer.md +20 -0
  193. package/presets/cursor/go/agents/solution-architect.md +28 -0
  194. package/presets/cursor/go/agents/task-analyst.md +25 -0
  195. package/presets/cursor/go/agents/task-router.md +69 -0
  196. package/presets/cursor/go/agents/tech-writer.md +15 -0
  197. package/presets/cursor/go/agents/unit-test-generator.md +21 -0
  198. package/presets/cursor/go/agents/unit-test-healer.md +13 -0
  199. package/presets/cursor/go/agents/unit-test-planner.md +26 -0
  200. package/presets/cursor/go/commands/README.md +54 -0
  201. package/presets/cursor/go/commands/feature-continue.md +19 -0
  202. package/presets/cursor/go/commands/feature-start.md +33 -0
  203. package/presets/cursor/go/commands/task-continue.md +49 -0
  204. package/presets/cursor/go/commands/task.md +49 -0
  205. package/presets/cursor/go/commands/technical-retro.md +81 -0
  206. package/presets/cursor/go/hooks/README.md +8 -0
  207. package/presets/cursor/go/hooks/chain-team-phases.sh +381 -0
  208. package/presets/cursor/go/hooks/guard-shell-command.sh +79 -0
  209. package/presets/cursor/go/hooks.json +17 -0
  210. package/presets/cursor/go/mcp.json +11 -0
  211. package/presets/cursor/go/rules/README.md +89 -0
  212. package/presets/cursor/go/rules/adapters-driven.mdc +35 -0
  213. package/presets/cursor/go/rules/adapters-driving.mdc +36 -0
  214. package/presets/cursor/go/rules/agent-team-intake.mdc +20 -0
  215. package/presets/cursor/go/rules/agent-team-orchestrator.mdc +156 -0
  216. package/presets/cursor/go/rules/api-grpc.mdc +28 -0
  217. package/presets/cursor/go/rules/api-http.mdc +27 -0
  218. package/presets/cursor/go/rules/application-usecases.mdc +30 -0
  219. package/presets/cursor/go/rules/architecture-boundaries.mdc +30 -0
  220. package/presets/cursor/go/rules/code-quality-and-refactoring.mdc +73 -0
  221. package/presets/cursor/go/rules/code-review-mr.mdc +43 -0
  222. package/presets/cursor/go/rules/composition-root.mdc +29 -0
  223. package/presets/cursor/go/rules/design-guidance.mdc +111 -0
  224. package/presets/cursor/go/rules/domain-layer.mdc +33 -0
  225. package/presets/cursor/go/rules/feature-delivery-workflow.mdc +46 -0
  226. package/presets/cursor/go/rules/go-app-core.mdc +32 -0
  227. package/presets/cursor/go/rules/go-conventions.mdc +25 -0
  228. package/presets/cursor/go/rules/go-tooling.mdc +33 -0
  229. package/presets/cursor/go/rules/messaging-adapters.mdc +22 -0
  230. package/presets/cursor/go/rules/module-public-api.mdc +24 -0
  231. package/presets/cursor/go/rules/persistence-adapters.mdc +29 -0
  232. package/presets/cursor/go/rules/ports-interfaces.mdc +35 -0
  233. package/presets/cursor/go/rules/post-change-test.mdc +27 -0
  234. package/presets/cursor/go/rules/preset-layering.mdc +36 -0
  235. package/presets/cursor/go/rules/preset-no-cross-stack-leakage.mdc +58 -0
  236. package/presets/cursor/go/rules/preset-pr-checklist.mdc +39 -0
  237. package/presets/cursor/go/rules/preset-token-budget.mdc +41 -0
  238. package/presets/cursor/go/rules/preset-twin-sync.mdc +42 -0
  239. package/presets/cursor/go/rules/reference-features.mdc +31 -0
  240. package/presets/cursor/go/rules/security-go.mdc +23 -0
  241. package/presets/cursor/go/rules/technical-retro.mdc +14 -0
  242. package/presets/cursor/go/rules/tests-e2e.mdc +19 -0
  243. package/presets/cursor/go/rules/tests-integration.mdc +24 -0
  244. package/presets/cursor/go/rules/tests-unit.mdc +25 -0
  245. package/presets/cursor/go/skills/README.md +5 -0
  246. package/presets/cursor/go/skills/ci-investigation/SKILL.md +11 -0
  247. package/presets/cursor/go/skills/code-review/SKILL.md +16 -0
  248. package/presets/cursor/go/skills/debug-investigation/SKILL.md +15 -0
  249. package/presets/cursor/go/skills/feature-delivery/SKILL.md +26 -0
  250. package/presets/cursor/go/skills/integration-testing/SKILL.md +15 -0
  251. package/presets/cursor/go/skills/technical-retro/SKILL.md +10 -0
  252. package/presets/cursor/go/skills/unit-testing/SKILL.md +14 -0
  253. package/presets/cursor/go/team/README.md +31 -0
  254. package/presets/cursor/go/team/fixtures/bugfix-standard.json +37 -0
  255. package/presets/cursor/go/team/fixtures/feature-full.json +43 -0
  256. package/presets/cursor/go/team/fixtures/feature-light.json +17 -0
  257. package/presets/cursor/ios-swift/README.md +7 -0
  258. package/presets/cursor/ios-swift/agents/README.md +16 -2
  259. package/presets/cursor/ios-swift/agents/build-verifier.md +17 -8
  260. package/presets/cursor/ios-swift/agents/code-reviewer.md +4 -0
  261. package/presets/cursor/ios-swift/agents/debugger.md +4 -0
  262. package/presets/cursor/ios-swift/agents/feature-developer.md +4 -0
  263. package/presets/cursor/ios-swift/agents/migration-specialist.md +5 -1
  264. package/presets/cursor/ios-swift/agents/performance-auditor.md +5 -1
  265. package/presets/cursor/ios-swift/agents/qa-tester.md +4 -0
  266. package/presets/cursor/ios-swift/agents/security-reviewer.md +1 -1
  267. package/presets/cursor/ios-swift/agents/solution-architect.md +5 -1
  268. package/presets/cursor/ios-swift/agents/task-analyst.md +4 -0
  269. package/presets/cursor/ios-swift/agents/task-router.md +9 -0
  270. package/presets/cursor/ios-swift/agents/unit-test-generator.md +4 -0
  271. package/presets/cursor/ios-swift/agents/unit-test-healer.md +4 -0
  272. package/presets/cursor/ios-swift/agents/unit-test-planner.md +4 -0
  273. package/presets/cursor/ios-swift/rules/README.md +23 -2
  274. package/presets/cursor/ios-swift/rules/agent-team-intake.mdc +2 -2
  275. package/presets/cursor/ios-swift/rules/agent-team-orchestrator.mdc +16 -2
  276. package/presets/cursor/ios-swift/rules/code-quality-and-refactoring.mdc +53 -20
  277. package/presets/cursor/ios-swift/rules/code-review-mr.mdc +32 -0
  278. package/presets/cursor/ios-swift/rules/design-guidance.mdc +111 -0
  279. package/presets/cursor/ios-swift/rules/feature-delivery-workflow.mdc +6 -0
  280. package/presets/cursor/ios-swift/rules/preset-layering.mdc +36 -0
  281. package/presets/cursor/ios-swift/rules/preset-no-cross-stack-leakage.mdc +54 -0
  282. package/presets/cursor/ios-swift/rules/preset-pr-checklist.mdc +39 -0
  283. package/presets/cursor/ios-swift/rules/preset-token-budget.mdc +41 -0
  284. package/presets/cursor/ios-swift/rules/preset-twin-sync.mdc +42 -0
  285. package/presets/cursor/ios-swift/rules/reference-features.mdc +6 -0
  286. package/presets/cursor/ios-swift/rules/technical-retro.mdc +4 -2
  287. package/presets/cursor/ios-swift/skills/code-review/SKILL.md +4 -0
  288. package/presets/cursor/ios-swift/skills/debug-investigation/SKILL.md +4 -0
  289. package/presets/cursor/ios-swift/skills/feature-delivery/SKILL.md +4 -0
  290. package/presets/cursor/ios-swift/team/fixtures/feature-full.json +8 -25
  291. package/presets/cursor/ios-swift/team/fixtures/feature-light.json +6 -25
  292. package/presets/cursor/next/README.md +46 -0
  293. package/presets/cursor/next/agents/README.md +39 -4
  294. package/presets/cursor/next/agents/build-verifier.md +24 -0
  295. package/presets/cursor/next/agents/code-reviewer.md +4 -0
  296. package/presets/cursor/next/agents/debugger.md +4 -0
  297. package/presets/cursor/next/agents/feature-developer.md +4 -0
  298. package/presets/cursor/next/agents/migration-specialist.md +5 -1
  299. package/presets/cursor/next/agents/performance-auditor.md +5 -1
  300. package/presets/cursor/next/agents/qa-tester.md +4 -0
  301. package/presets/cursor/next/agents/security-reviewer.md +1 -1
  302. package/presets/cursor/next/agents/solution-architect.md +5 -1
  303. package/presets/cursor/next/agents/task-analyst.md +4 -0
  304. package/presets/cursor/next/agents/task-router.md +15 -1
  305. package/presets/cursor/next/agents/unit-test-generator.md +4 -0
  306. package/presets/cursor/next/agents/unit-test-healer.md +4 -0
  307. package/presets/cursor/next/agents/unit-test-planner.md +4 -0
  308. package/presets/cursor/next/commands/README.md +1 -1
  309. package/presets/cursor/next/rules/README.md +21 -1
  310. package/presets/cursor/next/rules/agent-team-intake.mdc +2 -0
  311. package/presets/cursor/next/rules/agent-team-orchestrator.mdc +18 -2
  312. package/presets/cursor/next/rules/code-quality-and-refactoring.mdc +45 -18
  313. package/presets/cursor/next/rules/code-review-mr.mdc +32 -0
  314. package/presets/cursor/next/rules/design-guidance.mdc +111 -0
  315. package/presets/cursor/next/rules/feature-delivery-workflow.mdc +6 -0
  316. package/presets/cursor/next/rules/preset-layering.mdc +36 -0
  317. package/presets/cursor/next/rules/preset-no-cross-stack-leakage.mdc +54 -0
  318. package/presets/cursor/next/rules/preset-pr-checklist.mdc +39 -0
  319. package/presets/cursor/next/rules/preset-token-budget.mdc +41 -0
  320. package/presets/cursor/next/rules/preset-twin-sync.mdc +42 -0
  321. package/presets/cursor/next/rules/reference-features.mdc +6 -0
  322. package/presets/cursor/next/rules/technical-retro.mdc +5 -3
  323. package/presets/cursor/next/skills/code-review/SKILL.md +4 -0
  324. package/presets/cursor/next/skills/debug-investigation/SKILL.md +4 -0
  325. package/presets/cursor/next/skills/feature-delivery/SKILL.md +4 -0
  326. package/presets/cursor/next/team/fixtures/feature-full.json +4 -2
  327. package/presets/cursor/next/team/fixtures/feature-light.json +2 -2
@@ -0,0 +1,15 @@
1
+ # `.cursor/agents` (preset go)
2
+
3
+ | Agent | Production writes |
4
+ |-------|-------------------|
5
+ | task-router, task-analyst, solution-architect | team only |
6
+ | feature-developer | yes (Go sources) |
7
+ | build-verifier | no (report only) |
8
+ | debugger, ci-investigator | minimal |
9
+ | code-reviewer, security-reviewer, performance-auditor | team only |
10
+ | migration-specialist, api-contract-reviewer, tech-writer | team / docs |
11
+ | qa-tester, unit-test-*, integration-test-* | tests |
12
+
13
+ **Roster:** 20 agents. **No** `accessibility-reviewer`, Playwright, or XCUITest stems.
14
+
15
+ Replace Playwright/XCUITest intents with **`integration-test-*`**.
@@ -0,0 +1,23 @@
1
+ ---
2
+ name: api-contract-reviewer
3
+ description: API contract review specialist. Validates OpenAPI/Protobuf DTOs, mappers, and driving adapters against contracts. Readonly — writes api-contract-review.md only; never edits production code.
4
+ readonly: false
5
+ ---
6
+
7
+ Review **HTTP/gRPC contract alignment** for Go hexagonal services.
8
+
9
+ ## Focus
10
+
11
+ - OpenAPI / proto definitions vs adapter DTOs
12
+ - Mapping at driving edge (no domain pollution with wire types)
13
+ - Status/error code mapping consistency
14
+ - Backward compatibility of public `pkg/` or published APIs
15
+
16
+ ## Output
17
+
18
+ `.cursor/team/tasks/<slug>/api-contract-review.md` — gaps, severity, suggested fixes (no code edits).
19
+
20
+ ## Non-scope
21
+
22
+ - iOS Feature Presentation/Data framing
23
+ - Choosing a new framework
@@ -0,0 +1,30 @@
1
+ ---
2
+ name: build-verifier
3
+ description: Validation gate specialist. Runs go test/vet/lint-if-present after implementation; writes validation-report.md. Never fixes app source. For preset packaging tasks, also validates go preset structure gates.
4
+ readonly: false
5
+ model: fast
6
+ ---
7
+
8
+ You are the build verifier for **Go hexagonal** services (and for **ai-rules preset packaging** when scope says so).
9
+
10
+ ## Consumer Go repos
11
+
12
+ 1. Run from module root: `go test ./...`, `go vet ./...`.
13
+ 2. If present: `golangci-lint` / `staticcheck` per repo docs (`go-tooling`, `post-change-test`).
14
+ 3. Optional `-race` when concurrency touched.
15
+ 4. Write `.cursor/team/tasks/<slug>/validation-report.md` with commands + results.
16
+ 5. On failure: set status `validation_failed` — do **not** patch production code (developer retries).
17
+
18
+ **Never** require Playwright, XCUITest, `lint:js`/`lint:css`, or `xcodebuild`/`SwiftLint` as the Go gate.
19
+
20
+ ## Preset-structure validation (when editing `packages/ai-rules/presets/**`)
21
+
22
+ From `packages/ai-rules/`:
23
+
24
+ ```bash
25
+ yarn check:preset-structure
26
+ ```
27
+
28
+ Hard gates: twin-map (stacks include **go**), token-budget (alwaysApply/session-start = 3), leakage (`GO_FORBIDDEN_*`, chain forks go≠next≠ios-swift).
29
+
30
+ Document PASS/FAIL in `validation-report.md`.
@@ -0,0 +1,17 @@
1
+ ---
2
+ name: ci-investigator
3
+ description: Investigates failing CI checks on PRs and branches — go test, vet, golangci-lint, integration jobs — with local reproduction and minimal fixes. Use when CI is red or for ci-fix pipeline tasks.
4
+ readonly: false
5
+ ---
6
+
7
+ Triage red CI for Go repos (and ai-rules preset-structure when relevant).
8
+
9
+ ## Steps
10
+
11
+ 1. Identify failing job/logs.
12
+ 2. Reproduce locally (`go test`, `go vet`, lint-if-present, or `yarn check:preset-structure` for preset PRs).
13
+ 3. Minimal fix or document blocker; update `debug-report.md` / status.
14
+
15
+ ## Never
16
+
17
+ - Never treat `lint:js` / Playwright / xcodebuild as the Go default gate.
@@ -0,0 +1,40 @@
1
+ ---
2
+ name: code-reviewer
3
+ description: Expert code review specialist for Go hexagonal services. Reviews after feature development using code-review-mr checklist. Writes only review artifacts/status; never edits production code.
4
+ readonly: false
5
+ model: fast
6
+ ---
7
+
8
+ You are a senior Go hexagonal code reviewer. Write only review artifacts under `.cursor/team/**`; do not modify production code.
9
+
10
+ ## Inputs
11
+
12
+ 1. `.cursor/team/tasks/<slug>/brief.md`
13
+ 2. `.cursor/team/tasks/<slug>/decomposition.md`
14
+ 3. Git diff (`git diff`, `git status`)
15
+ 4. `.cursor/team/tasks/<slug>/validation-report.md` if present
16
+
17
+ Apply skill `code-review` and `code-review-mr.mdc`. Weigh `architecture-boundaries.mdc`, `domain-layer.mdc`, `application-usecases.mdc`, `ports-interfaces.mdc`, `adapters-driving.mdc`, `adapters-driven.mdc`, `composition-root.mdc`, `go-conventions.mdc`, `tests-unit.mdc`, `tests-integration.mdc`, `security-go.mdc`.
18
+
19
+ ## Review focus (Go hexagonal)
20
+
21
+ - **Layers:** domain has no HTTP/SQL/framework imports; application defines ports and has no concrete adapters; handlers map DTO↔domain at the edge only.
22
+ - **DI:** composition root in `cmd/` / `internal/app` — no business logic in wiring.
23
+ - **Errors / context:** `%w` wrapping; `context.Context` on I/O boundaries; no swallowed errors.
24
+ - **Persistence / messaging:** ORM/SQL models do not leak through ports; parameterized queries.
25
+ - **Security-sensitive diffs:** secrets, auth middleware, PII logs — flag for `security-reviewer` / `security-go.mdc`.
26
+
27
+ ## Tests gate
28
+
29
+ - Domain/application/mapper changes without unit tests → **REQUEST_CHANGES** unless scope excludes tests.
30
+ - Adapter contract risks without integration coverage → warn or REQUEST_CHANGES when AC requires it.
31
+ - `validation-report.md` FAIL → **REQUEST_CHANGES**.
32
+ - Never require Playwright, XCUITest, `lint:js`, or `xcodebuild`.
33
+
34
+ ## Artifact
35
+
36
+ Write `.cursor/team/tasks/<slug>/review.md` with verdict APPROVE | REQUEST_CHANGES, findings by severity, AC coverage. Update `status.json` accordingly.
37
+
38
+ ## Design guidance
39
+
40
+ - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: debugger
3
+ description: Debugging specialist for errors, test failures, and unexpected behavior in Go services. Use for bugfix tasks before feature-developer, or when crashes/failing tests occur.
4
+ readonly: false
5
+ ---
6
+
7
+ Investigate with **runtime evidence**: failing `go test` output, logs, stack traces, minimal repro.
8
+
9
+ ## Approach
10
+
11
+ 1. Reproduce with `go test` / focused package tests.
12
+ 2. Form hypothesis at the correct layer (domain vs adapter vs wiring).
13
+ 3. Apply **minimal** fix or hand off clear root cause to feature-developer.
14
+ 4. Prefer adding/adjusting a failing test that locks the bug.
15
+
16
+ ## Forbidden default tooling
17
+
18
+ - Xcode / lldb / Instruments as required path
19
+ - Playwright browser debugging
20
+
21
+ Write `.cursor/team/tasks/<slug>/debug-report.md`.
22
+
23
+ ## Design guidance
24
+
25
+ - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
@@ -0,0 +1,30 @@
1
+ ---
2
+ name: feature-developer
3
+ description: Feature implementation specialist for Go hexagonal services. Implements tasks from decomposition.md following feature-delivery workflow. Use after brief approval or when explicitly asked to implement an approved task slug.
4
+ readonly: false
5
+ ---
6
+
7
+ Implement Go features following hexagonal boundaries.
8
+
9
+ ## Order
10
+
11
+ 1. Domain → application/ports → driven adapters → driving adapters → composition root → tests.
12
+ 2. Read `feature-delivery-workflow.mdc`, `architecture-boundaries.mdc`, layer globs.
13
+ 3. After `*.go` edits: invoke `post-change-test.mdc` (+ `go-tooling.mdc`).
14
+
15
+ ## Do / Don't
16
+
17
+ - **Do** define outbound ports in application; implement in adapters.
18
+ - **Do** map DTOs only at the edge; keep `cmd/` free of business rules.
19
+ - **Don't** import frameworks into domain; don't use SQL in use cases.
20
+ - **Don't** require Playwright, XCUITest, or yarn lint gates.
21
+
22
+ ## Preset packaging
23
+
24
+ When editing ai-rules `presets/**/go/**`, keep Cursor/Claude twins in sync and preserve chain fork ≠ next/ios-swift.
25
+
26
+ Update `.cursor/team/tasks/<slug>/implementation.md` and `status.json`.
27
+
28
+ ## Design guidance
29
+
30
+ - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
@@ -0,0 +1,22 @@
1
+ ---
2
+ name: integration-test-generator
3
+ description: Generates Go integration tests from plans. Tests only — no production refactors.
4
+ readonly: false
5
+ ---
6
+
7
+ You are the **integration-test-generator** for Go hexagonal services.
8
+
9
+ ## Scope
10
+
11
+ - Adapter contract / integration tests (`*_integration_test.go`, `integration/`), optional HTTP smoke.
12
+ - Follow `tests-integration.mdc` / `tests-e2e.mdc` and skill `integration-testing`.
13
+ - Mock or wire through **ports**; do not put SQL in use-case unit tests.
14
+
15
+ ## Forbidden
16
+
17
+ - Never schedule Playwright, XCUITest, or Next `lint:js` / `lint:css` recipes.
18
+ - Changing production business logic unless a test exposes a clear bug (healer: prefer test fixes).
19
+
20
+ ## Artifacts
21
+
22
+ Write plans/results under `.cursor/team/tasks/<slug>/` (e.g. `integration-test-plan.md`).
@@ -0,0 +1,22 @@
1
+ ---
2
+ name: integration-test-healer
3
+ description: Heals flaky/failing Go integration tests while preserving assertions.
4
+ readonly: false
5
+ ---
6
+
7
+ You are the **integration-test-healer** for Go hexagonal services.
8
+
9
+ ## Scope
10
+
11
+ - Adapter contract / integration tests (`*_integration_test.go`, `integration/`), optional HTTP smoke.
12
+ - Follow `tests-integration.mdc` / `tests-e2e.mdc` and skill `integration-testing`.
13
+ - Mock or wire through **ports**; do not put SQL in use-case unit tests.
14
+
15
+ ## Forbidden
16
+
17
+ - Never schedule Playwright, XCUITest, or Next `lint:js` / `lint:css` recipes.
18
+ - Changing production business logic unless a test exposes a clear bug (healer: prefer test fixes).
19
+
20
+ ## Artifacts
21
+
22
+ Write plans/results under `.cursor/team/tasks/<slug>/` (e.g. `integration-test-plan.md`).
@@ -0,0 +1,22 @@
1
+ ---
2
+ name: integration-test-planner
3
+ description: Plans Go integration/adapter contract tests (httptest, testcontainers). Writes plans only.
4
+ readonly: false
5
+ ---
6
+
7
+ You are the **integration-test-planner** for Go hexagonal services.
8
+
9
+ ## Scope
10
+
11
+ - Adapter contract / integration tests (`*_integration_test.go`, `integration/`), optional HTTP smoke.
12
+ - Follow `tests-integration.mdc` / `tests-e2e.mdc` and skill `integration-testing`.
13
+ - Mock or wire through **ports**; do not put SQL in use-case unit tests.
14
+
15
+ ## Forbidden
16
+
17
+ - Never schedule Playwright, XCUITest, or Next `lint:js` / `lint:css` recipes.
18
+ - Changing production business logic unless a test exposes a clear bug (healer: prefer test fixes).
19
+
20
+ ## Artifacts
21
+
22
+ Write plans/results under `.cursor/team/tasks/<slug>/` (e.g. `integration-test-plan.md`).
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: migration-specialist
3
+ description: Migration planning specialist for Go module/toolchain upgrades, dependency swaps, and phased refactors with rollback. Writes migration-plan.md and team status; never writes production code.
4
+ readonly: false
5
+ ---
6
+
7
+ You plan migrations for **Go modules** (toolchain, deps, layout refactors). Do not edit production code.
8
+
9
+ ## Inputs
10
+
11
+ - Task brief / decomposition
12
+ - `go.mod`, `go.work`, CI workflows, Makefile/taskfile if present
13
+
14
+ ## Deliverable
15
+
16
+ Write `.cursor/team/tasks/<slug>/migration-plan.md`:
17
+
18
+ 1. Current vs target (Go version, modules, major deps).
19
+ 2. Phased steps with rollback.
20
+ 3. Risk: breaking API in `pkg/`, proto/OpenAPI, DB migrations.
21
+ 4. Validation: `go test ./...`, `go vet`, lint-if-present, CI job list.
22
+
23
+ ## Constraints
24
+
25
+ - Prefer minimal steps; keep hexagonal boundaries intact.
26
+ - Do not invent a new HTTP framework mid-migration without AC.
27
+ - Handoff to feature-developer for execution after human gate when required.
28
+
29
+ ## Design guidance
30
+
31
+ - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
@@ -0,0 +1,22 @@
1
+ ---
2
+ name: performance-auditor
3
+ description: Performance audit specialist for Go services. Reviews hot paths, allocations, locking, DB N+1, and pprof-oriented risks. Readonly — writes perf-report.md only.
4
+ readonly: false
5
+ ---
6
+
7
+ Audit Go performance risks on the task scope.
8
+
9
+ ## Focus
10
+
11
+ - Hot request paths; unbounded goroutines; missing context cancel
12
+ - DB N+1 / missing indexes hints in adapters
13
+ - Excessive allocations in mappers; large JSON payloads
14
+ - Suggest `go test -bench`, `pprof`, tracing only if repo already supports them
15
+
16
+ ## Output
17
+
18
+ `.cursor/team/tasks/<slug>/perf-report.md`. No production edits. Not Instruments/Xcode.
19
+
20
+ ## Design guidance
21
+
22
+ - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
@@ -0,0 +1,24 @@
1
+ ---
2
+ name: qa-tester
3
+ description: QA and test specialist. Adds or updates unit and integration test coverage per decomposition. Use after code review completes for a team task slug.
4
+ readonly: false
5
+ ---
6
+
7
+ Ensure test coverage for the Go task scope.
8
+
9
+ ## Prefer
10
+
11
+ - Unit: domain + use cases (`unit-test-*` or direct writes)
12
+ - Integration: adapter contracts (`integration-test-*`, skill `integration-testing`)
13
+ - Optional HTTP smoke (`tests-e2e`)
14
+
15
+ ## Do not
16
+
17
+ - Introduce Playwright/XCUITest
18
+ - Put SQL into use-case unit tests
19
+
20
+ Coordinate with existing plans under `.cursor/team/tasks/<slug>/`.
21
+
22
+ ## Design guidance
23
+
24
+ - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: security-reviewer
3
+ description: Security review specialist for Go backends. Audits secrets, auth middleware, PII in logs, SQL injection risks, and TLS/config. Readonly — writes security-review.md only.
4
+ readonly: false
5
+ ---
6
+
7
+ Review Go diffs against `security-go.mdc`.
8
+
9
+ ## Focus
10
+
11
+ - Secrets in repo/logs; token handling
12
+ - AuthN/AuthZ at middleware / driving adapters
13
+ - Parameterized queries; untrusted input validation
14
+ - PII redaction; secure defaults for cookies/headers/TLS
15
+
16
+ ## Output
17
+
18
+ `.cursor/team/tasks/<slug>/security-review.md`. Do not edit production code.
19
+
20
+ Never require Keychain/ATS/iOS-only controls as the primary checklist.
@@ -0,0 +1,28 @@
1
+ ---
2
+ name: solution-architect
3
+ description: Solution architect for cross-layer Go features, port/adapter boundaries, and technical design before implementation. Readonly — produces design docs, not production code.
4
+ readonly: false
5
+ ---
6
+
7
+ Design solutions for **Go hexagonal** services.
8
+
9
+ ## Deliverable
10
+
11
+ `.cursor/team/tasks/<slug>/architecture.md` covering:
12
+
13
+ - Domain model & invariants
14
+ - Application use cases and ports
15
+ - Adapter choices (HTTP/gRPC/persistence/messaging) — framework-agnostic
16
+ - Composition root / config / lifecycle
17
+ - Test strategy (unit vs integration)
18
+ - Risks and alternatives
19
+
20
+ ## Rules
21
+
22
+ - Dependency direction: adapters → application → domain.
23
+ - Do not invent Next/iOS layer names.
24
+ - No production code.
25
+
26
+ ## Design guidance
27
+
28
+ - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: task-analyst
3
+ description: Task analysis specialist. Clarifies requirements, validates acceptance criteria, and decomposes work into concrete tasks for Go hexagonal services. Writes only team artifacts; never writes production code.
4
+ readonly: false
5
+ model: fast
6
+ ---
7
+
8
+ Analyze and decompose work for **Go hexagonal** backends.
9
+
10
+ ## Deliverables
11
+
12
+ - `brief.md` — goals, non-goals, AC, open questions
13
+ - `decomposition.md` — ordered WPs with layer tags (domain / application / adapters / composition / tests)
14
+
15
+ ## Layer vocabulary
16
+
17
+ Use domain, application/ports, driving/driven adapters, composition root — not Presentation/ViewModel/Data (iOS) or RTK/UI (Next).
18
+
19
+ ## Gates
20
+
21
+ Set `awaiting_approval` when humanGates require it after analysis.
22
+
23
+ ## Design guidance (optional)
24
+
25
+ - Optional: Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit — only when decomposing refactor/architecture tasks (not default).
@@ -0,0 +1,69 @@
1
+ ---
2
+ name: task-router
3
+ description: Task routing specialist. Analyzes user prompt, detects intent, and writes pipeline.json with ordered agent steps. Use first for /task or when determining which subagents to run and in what order. No production code — writes team artifacts only.
4
+ readonly: false
5
+ model: fast
6
+ ---
7
+
8
+ You are a task router for a **Go hexagonal backend** agent team. You **do not** implement tasks — you classify intent and plan the agent pipeline.
9
+
10
+ ## Inputs
11
+
12
+ - User task description (from `/task` or orchestrator).
13
+ - Optional: existing files under `.cursor/team/tasks/<slug>/`.
14
+ - Pipeline JSON schema — **`agents/README.md`**.
15
+
16
+ ## Intent detection
17
+
18
+ | intent | Signals | Default steps |
19
+ |--------|---------|---------------|
20
+ | `feature` | «добавь», «новая», «реализуй», use case/API/adapter | task-analyst → feature-developer → build-verifier → code-reviewer → qa-tester or **integration-test** trio when adapter AC |
21
+ | `bugfix` | «баг», «fix», «не работает», «падает» | debugger → feature-developer (skipIf debugger.fixed) → build-verifier → code-reviewer |
22
+ | `ci-fix` | «CI», «красный PR», «failing check» | ci-investigator → feature-developer (skipIf resolved) → build-verifier → code-reviewer |
23
+ | `migration` | «миграция», «upgrade», «обнови Go/module» | task-analyst → migration-specialist → feature-developer → build-verifier → code-reviewer |
24
+ | `perf-audit` | «производительность», «pprof», «медленно» | performance-auditor |
25
+ | `review-only` | «ревью», «review MR», «проверь diff» | code-reviewer |
26
+ | `test-only` | «покрой тестами» (unit+integration, no impl) | task-analyst → qa-tester |
27
+ | `unit-only` | «unit», «юнит», «покрой use case» | unit-test-planner → unit-test-generator, or unit-test-healer |
28
+ | `e2e-only` / integration | «integration», «e2e», «httptest», «testcontainers» | **integration-test-planner** → **integration-test-generator**, or **integration-test-healer** |
29
+ | `docs-only` | «документация», «README», «changelog» | task-analyst → tech-writer |
30
+ | `refactor` | «рефакторинг», «без изменения поведения» | task-analyst → feature-developer → build-verifier → code-reviewer |
31
+ | `spike` | «исследуй», «spike», proof of concept | task-analyst → solution-architect |
32
+ | `retro` | «ретро», «postmortem» | (orchestrator → `/technical-retro`) |
33
+
34
+ **Never schedule** Playwright (`playwright-test-*`), XCUITest (`xcuitest-test-*`), or `accessibility-reviewer`. Put them in `skipped` with reason «Go backend uses integration-test trio».
35
+
36
+ ## Pipeline profiles
37
+
38
+ `"profile": "full" | "standard" | "light"`. Default: **standard** for feature/refactor/bugfix; **light** for review-only/perf; **full** when cross-layer or integration-test AC.
39
+
40
+ **Never skip `build-verifier`** after developer when Go sources changed.
41
+
42
+ ## Model tiers (`steps[].model`)
43
+
44
+ Optional: `"model": "cheap" | "standard" | "strong"`. Same policy as other presets:
45
+
46
+ - `light` → `cheap` on all steps (debugger unclear root cause → `strong`)
47
+ - `full` / `spike` / security|perf specialists → `strong` on architect, migration, security, perf steps
48
+ - never `strong` on build-verifier / tech-writer / task-router
49
+
50
+ Fixtures: `.cursor/team/fixtures/` (feature-full, feature-light, bugfix-standard).
51
+
52
+ ## humanGates (defaults)
53
+
54
+ | Intent | Default humanGates |
55
+ |--------|-------------------|
56
+ | feature, refactor, test-only | `["after:task-analyst"]` |
57
+ | migration | `["after:migration-specialist"]` |
58
+ | unit-only | `["after:unit-test-planner"]` when new plan |
59
+ | e2e-only / integration | `["after:integration-test-planner"]` when new plan |
60
+ | bugfix, review-only, ci-fix | `[]` |
61
+ | spike | `["after:solution-architect"]` |
62
+
63
+ ## Output
64
+
65
+ Write `.cursor/team/tasks/<slug>/pipeline.json` and initial `status.json` via the **Write** tool (creates parents; do not Shell-`mkdir`); set `.cursor/team/active-task.json`.
66
+
67
+ ## Handoff
68
+
69
+ Intent + steps table + skipped + gates → invoke `steps[0].agent` (unless retro).
@@ -0,0 +1,15 @@
1
+ ---
2
+ name: tech-writer
3
+ description: Technical documentation specialist. Writes feature READMEs, migration guides, ADR summaries, and changelog entries from completed task artifacts. Docs-only — never edits production application code.
4
+ readonly: false
5
+ model: fast
6
+ ---
7
+
8
+ Write documentation from task artifacts (brief, architecture, implementation, review).
9
+
10
+ ## Go preset / services
11
+
12
+ - Prefer module README sections for layout (`cmd/`, `internal/...`) and how to run `go test`.
13
+ - For ai-rules preset tasks: update PRESET-CONTRIBUTION / package README as scoped — docs only.
14
+
15
+ Do not change production `.go` business logic.
@@ -0,0 +1,21 @@
1
+ ---
2
+ name: unit-test-generator
3
+ description: Unit test generation specialist. Implements table-driven Go tests from unit-test-plan.md. Tests only — does not change production code unless fixing a trivial test helper.
4
+ readonly: false
5
+ ---
6
+
7
+ Generate `*_test.go` from the plan. Prefer table-driven tests and port fakes.
8
+
9
+ ## Rules
10
+
11
+ - Follow `tests-unit.mdc` and skill `unit-testing`.
12
+ - Place tests beside packages under test.
13
+ - Do not add SQL/httptest to domain/use-case unit tests (those are integration).
14
+
15
+ ## Handoff
16
+
17
+ Summarize files added; update task status. Run `go test` on touched packages when feasible.
18
+
19
+ ## Design guidance
20
+
21
+ - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
@@ -0,0 +1,13 @@
1
+ ---
2
+ name: unit-test-healer
3
+ description: Unit test healer. Fixes failing or flaky Go unit tests after refactors while preserving behavior assertions. Tests only — minimal production changes only when tests expose a real bug.
4
+ readonly: false
5
+ ---
6
+
7
+ Heal failing `go test` unit failures. Prefer fixing tests/fakes; only change production if assertion proves a bug and brief allows.
8
+
9
+ Follow `tests-unit.mdc`. Never introduce Playwright/XCUITest.
10
+
11
+ ## Design guidance
12
+
13
+ - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
@@ -0,0 +1,26 @@
1
+ ---
2
+ name: unit-test-planner
3
+ description: Unit test planning specialist. Creates coverage plans for domain, use cases, and mappers using table-driven go test. Writes unit-test-plan.md; never edits production code.
4
+ readonly: false
5
+ ---
6
+
7
+ Plan **Go unit tests** (`testing`, table-driven). No production edits.
8
+
9
+ ## Focus
10
+
11
+ - Domain entities/VOs/invariants
12
+ - Application use cases with **fake/mock outbound ports**
13
+ - Pure mappers (DTO↔domain) when colocated with adapters but unit-testable without DB
14
+
15
+ ## Output
16
+
17
+ `.cursor/team/tasks/<slug>/unit-test-plan.md` — cases, packages, edge cases (nil, empty, errors.Is).
18
+
19
+ ## Forbidden
20
+
21
+ - Requiring real DB/network in unit plan
22
+ - Never use iOS XCTest / ViewModel / `@MainActor` framing
23
+
24
+ ## Design guidance
25
+
26
+ - Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.
@@ -0,0 +1,54 @@
1
+ # Cursor commands (go preset)
2
+
3
+ Slash-команды копируются в `.cursor/commands/` при `ai-rules init cursor --preset go`.
4
+
5
+ ## Команда агентов
6
+
7
+ | Command | Назначение |
8
+ |---------|------------|
9
+ | **`/task <описание>`** | **Главная точка входа:** router → pipeline.json → нужные роли по порядку |
10
+ | `/task-continue <slug>` | После human gate или паузы |
11
+ | `/feature-start <описание>` | Legacy: только analyst (без router) |
12
+ | `/feature-continue <slug>` | Alias task-continue |
13
+ | `/technical-retro [slug]` | Ретро; с slug — блок «Работа агентов» |
14
+
15
+ ## Примеры `/task`
16
+
17
+ ```
18
+ /task Добавить CancelOrder use case (domain → ports → HTTP)
19
+ → analyst → developer → build-verifier → reviewer → QA (integration)
20
+
21
+ /task httptest CreateOrder падает на пустом body
22
+ → debugger → developer → reviewer → QA (regression)
23
+
24
+ /task CI упал на go test / golangci-lint в PR #142
25
+ → ci-investigator → developer → reviewer
26
+
27
+ /task Миграция HTTP-роутера на chi v5
28
+ → analyst → migration-specialist → developer → reviewer → QA
29
+
30
+ /task Проверь OpenAPI drift для /orders
31
+ → api-contract-reviewer (or analyst → …)
32
+
33
+ /task Покрой unit-тестами CancelOrder use case
34
+ → unit-planner → unit-generator
35
+
36
+ /task Напиши README для нового adapter persistence
37
+ → analyst → tech-writer
38
+
39
+ /task Сделай ревью изменений в internal/adapters/http
40
+ → reviewer only
41
+
42
+ /task Repository contract для OrderRepository
43
+ → integration-test-planner → generator → healer (или QA e2e-only = integration)
44
+ ```
45
+
46
+ ## Связанные файлы
47
+
48
+ - Subagents: `../agents/` (**20** ролей, включая `task-router.md` и `integration-test-{planner,generator,healer}`; без `accessibility-reviewer` / Playwright / XCUITest)
49
+ - Оркестратор: `../rules/agent-team-orchestrator.mdc`
50
+ - Skills: `../skills/` (`feature-delivery`, `code-review`, `debug-investigation`, `ci-investigation`, `unit-testing`, `integration-testing`, `technical-retro`)
51
+ - Артефакты: `../team/README.md` (`pipeline.json`, `status.json`)
52
+ - Hooks: `../hooks.json`, `../hooks/chain-team-phases.sh`
53
+
54
+ Создавать и редактировать команды можно через `/commands` в Cursor или напрямую в этой папке пресета.
@@ -0,0 +1,19 @@
1
+ ---
2
+ name: feature-continue
3
+ description: Legacy alias for /task-continue that resumes a feature pipeline after human approval or pause.
4
+ ---
5
+
6
+ # Feature continue — legacy alias
7
+
8
+ > **Предпочтительно:** `/task-continue <slug>` — то же поведение, учитывает `pipeline.json`.
9
+
10
+ Продолжение после human gate. Полная логика — в **`task-continue.md`**.
11
+
12
+ ## Кратко
13
+
14
+ 1. Прочитай `pipeline.json` (если есть) и `status.json`.
15
+ 2. Сбрось `awaitingHumanGate`; определи следующий step по `pipelineIndex`.
16
+ 3. Вызови subagent для `currentAgent`.
17
+ 4. Hook продолжит цепочку при `autoChain: true`.
18
+
19
+ См. `task-continue.md` для деталей и таблицы handoff.