nitm-ai-dev-toolkit 3.0.15

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 (754) hide show
  1. package/CHANGELOG.md +109 -0
  2. package/LICENSE +21 -0
  3. package/README.md +881 -0
  4. package/bin/cli.js +398 -0
  5. package/package.json +41 -0
  6. package/src/monorepo/.agents/rules/ponytail.md +3 -0
  7. package/src/monorepo/.agents/skills/acli/SKILL.md +424 -0
  8. package/src/monorepo/.agents/skills/bkt-cli/SKILL.md +374 -0
  9. package/src/monorepo/.agents/skills/brainstorming/SKILL.md +54 -0
  10. package/src/monorepo/.agents/skills/code-simplifier/SKILL.md +109 -0
  11. package/src/monorepo/.agents/skills/debugger/SKILL.md +123 -0
  12. package/src/monorepo/.agents/skills/dispatching-parallel-agents/SKILL.md +206 -0
  13. package/src/monorepo/.agents/skills/executing-plans/SKILL.md +76 -0
  14. package/src/monorepo/.agents/skills/finishing-a-development-branch/SKILL.md +200 -0
  15. package/src/monorepo/.agents/skills/gh-cli/SKILL.md +461 -0
  16. package/src/monorepo/.agents/skills/glab-cli/SKILL.md +468 -0
  17. package/src/monorepo/.agents/skills/issue-tracker/SKILL.md +119 -0
  18. package/src/monorepo/.agents/skills/linear-cli/SKILL.md +276 -0
  19. package/src/monorepo/.agents/skills/logging/SKILL.md +393 -0
  20. package/src/monorepo/.agents/skills/orient-to-recent-work/SKILL.md +43 -0
  21. package/src/monorepo/.agents/skills/ponytail/SKILL.md +101 -0
  22. package/src/monorepo/.agents/skills/ponytail-audit/SKILL.md +41 -0
  23. package/src/monorepo/.agents/skills/ponytail-debt/SKILL.md +44 -0
  24. package/src/monorepo/.agents/skills/ponytail-gain/SKILL.md +51 -0
  25. package/src/monorepo/.agents/skills/ponytail-help/SKILL.md +74 -0
  26. package/src/monorepo/.agents/skills/ponytail-review/SKILL.md +57 -0
  27. package/src/monorepo/.agents/skills/project-documentation/SKILL.md +425 -0
  28. package/src/monorepo/.agents/skills/receiving-code-review/SKILL.md +213 -0
  29. package/src/monorepo/.agents/skills/requesting-code-review/SKILL.md +105 -0
  30. package/src/monorepo/.agents/skills/requesting-code-review/code-reviewer.md +146 -0
  31. package/src/monorepo/.agents/skills/security-reviewer/SKILL.md +144 -0
  32. package/src/monorepo/.agents/skills/subagent-driven-development/SKILL.md +279 -0
  33. package/src/monorepo/.agents/skills/subagent-driven-development/code-quality-reviewer-prompt.md +20 -0
  34. package/src/monorepo/.agents/skills/subagent-driven-development/implementer-prompt.md +78 -0
  35. package/src/monorepo/.agents/skills/subagent-driven-development/spec-reviewer-prompt.md +61 -0
  36. package/src/monorepo/.agents/skills/systematic-debugging/CREATION-LOG.md +119 -0
  37. package/src/monorepo/.agents/skills/systematic-debugging/SKILL.md +296 -0
  38. package/src/monorepo/.agents/skills/systematic-debugging/condition-based-waiting-example.ts +158 -0
  39. package/src/monorepo/.agents/skills/systematic-debugging/condition-based-waiting.md +115 -0
  40. package/src/monorepo/.agents/skills/systematic-debugging/defense-in-depth.md +122 -0
  41. package/src/monorepo/.agents/skills/systematic-debugging/find-polluter.sh +63 -0
  42. package/src/monorepo/.agents/skills/systematic-debugging/root-cause-tracing.md +169 -0
  43. package/src/monorepo/.agents/skills/systematic-debugging/test-academic.md +14 -0
  44. package/src/monorepo/.agents/skills/systematic-debugging/test-pressure-1.md +58 -0
  45. package/src/monorepo/.agents/skills/systematic-debugging/test-pressure-2.md +68 -0
  46. package/src/monorepo/.agents/skills/systematic-debugging/test-pressure-3.md +69 -0
  47. package/src/monorepo/.agents/skills/test-driven-development/SKILL.md +371 -0
  48. package/src/monorepo/.agents/skills/test-driven-development/testing-anti-patterns.md +299 -0
  49. package/src/monorepo/.agents/skills/using-git-worktrees/SKILL.md +291 -0
  50. package/src/monorepo/.agents/skills/using-superpowers/SKILL.md +87 -0
  51. package/src/monorepo/.agents/skills/verification-before-completion/SKILL.md +148 -0
  52. package/src/monorepo/.agents/skills/writing-plans/SKILL.md +116 -0
  53. package/src/monorepo/.agents/skills/writing-skills/SKILL.md +655 -0
  54. package/src/monorepo/.agents/skills/writing-skills/anthropic-best-practices.md +1150 -0
  55. package/src/monorepo/.agents/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  56. package/src/monorepo/.agents/skills/writing-skills/graphviz-conventions.dot +172 -0
  57. package/src/monorepo/.agents/skills/writing-skills/persuasion-principles.md +187 -0
  58. package/src/monorepo/.agents/skills/writing-skills/render-graphs.js +168 -0
  59. package/src/monorepo/.agents/skills/writing-skills/testing-skills-with-subagents.md +384 -0
  60. package/src/monorepo/.claude/agents/admin-portal.agent.md +11 -0
  61. package/src/monorepo/.claude/agents/api-specialist.agent.md +11 -0
  62. package/src/monorepo/.claude/agents/backend-architect.agent.md +11 -0
  63. package/src/monorepo/.claude/agents/documenter.agent.md +11 -0
  64. package/src/monorepo/.claude/agents/feature-builder.agent.md +23 -0
  65. package/src/monorepo/.claude/agents/frontend-developer.agent.md +11 -0
  66. package/src/monorepo/.claude/agents/green.agent.md +12 -0
  67. package/src/monorepo/.claude/agents/implementer.agent.md +12 -0
  68. package/src/monorepo/.claude/agents/planner.agent.md +12 -0
  69. package/src/monorepo/.claude/agents/red.agent.md +12 -0
  70. package/src/monorepo/.claude/agents/refactor.agent.md +12 -0
  71. package/src/monorepo/.claude/agents/researcher.agent.md +12 -0
  72. package/src/monorepo/.claude/agents/reviewer.agent.md +11 -0
  73. package/src/monorepo/.claude/agents/tdd.agent.md +12 -0
  74. package/src/monorepo/.claude/agents-snippets/admin-portal.md +90 -0
  75. package/src/monorepo/.claude/agents-snippets/api-specialist.md +57 -0
  76. package/src/monorepo/.claude/agents-snippets/backend-architect.md +49 -0
  77. package/src/monorepo/.claude/agents-snippets/documenter.md +58 -0
  78. package/src/monorepo/.claude/agents-snippets/feature-builder.md +49 -0
  79. package/src/monorepo/.claude/agents-snippets/frontend-developer.md +49 -0
  80. package/src/monorepo/.claude/agents-snippets/green.md +18 -0
  81. package/src/monorepo/.claude/agents-snippets/implementer.md +31 -0
  82. package/src/monorepo/.claude/agents-snippets/planner.md +40 -0
  83. package/src/monorepo/.claude/agents-snippets/red.md +14 -0
  84. package/src/monorepo/.claude/agents-snippets/refactor.md +22 -0
  85. package/src/monorepo/.claude/agents-snippets/researcher.md +43 -0
  86. package/src/monorepo/.claude/agents-snippets/reviewer.md +83 -0
  87. package/src/monorepo/.claude/agents-snippets/tdd.md +18 -0
  88. package/src/monorepo/.claude/commands/assign-tasks.md +13 -0
  89. package/src/monorepo/.claude/commands/bootstrap-patch.md +15 -0
  90. package/src/monorepo/.claude/commands/bootstrap-upgrade.md +15 -0
  91. package/src/monorepo/.claude/commands/bootstrap.md +15 -0
  92. package/src/monorepo/.claude/commands/commit-push.md +13 -0
  93. package/src/monorepo/.claude/commands/constitution.md +15 -0
  94. package/src/monorepo/.claude/commands/create-skill.md +15 -0
  95. package/src/monorepo/.claude/commands/implement-feature.md +15 -0
  96. package/src/monorepo/.claude/commands/implement-fixes.md +15 -0
  97. package/src/monorepo/.claude/commands/implement.md +15 -0
  98. package/src/monorepo/.claude/commands/plan.md +15 -0
  99. package/src/monorepo/.claude/commands/playwright-test.md +13 -0
  100. package/src/monorepo/.claude/commands/ponytail-audit.md +15 -0
  101. package/src/monorepo/.claude/commands/ponytail-debt.md +15 -0
  102. package/src/monorepo/.claude/commands/ponytail-gain.md +15 -0
  103. package/src/monorepo/.claude/commands/ponytail-help.md +15 -0
  104. package/src/monorepo/.claude/commands/ponytail-review.md +15 -0
  105. package/src/monorepo/.claude/commands/ponytail.md +15 -0
  106. package/src/monorepo/.claude/commands/release-notes.md +13 -0
  107. package/src/monorepo/.claude/commands/review-pr.md +15 -0
  108. package/src/monorepo/.claude/commands/review-staged.md +15 -0
  109. package/src/monorepo/.claude/commands/review.md +15 -0
  110. package/src/monorepo/.claude/commands/specify.md +15 -0
  111. package/src/monorepo/.claude/commands/tasks.md +13 -0
  112. package/src/monorepo/.claude/prompt-snippets/assign-tasks.md +169 -0
  113. package/src/monorepo/.claude/prompt-snippets/bootstrap-patch.md +199 -0
  114. package/src/monorepo/.claude/prompt-snippets/bootstrap-upgrade.md +452 -0
  115. package/src/monorepo/.claude/prompt-snippets/bootstrap.md +764 -0
  116. package/src/monorepo/.claude/prompt-snippets/commit-push.md +69 -0
  117. package/src/monorepo/.claude/prompt-snippets/constitution.md +57 -0
  118. package/src/monorepo/.claude/prompt-snippets/create-skill.md +490 -0
  119. package/src/monorepo/.claude/prompt-snippets/implement-feature.md +119 -0
  120. package/src/monorepo/.claude/prompt-snippets/implement-fixes.md +122 -0
  121. package/src/monorepo/.claude/prompt-snippets/implement.md +56 -0
  122. package/src/monorepo/.claude/prompt-snippets/plan.md +67 -0
  123. package/src/monorepo/.claude/prompt-snippets/playwright-test.md +55 -0
  124. package/src/monorepo/.claude/prompt-snippets/ponytail-audit.md +5 -0
  125. package/src/monorepo/.claude/prompt-snippets/ponytail-debt.md +5 -0
  126. package/src/monorepo/.claude/prompt-snippets/ponytail-gain.md +5 -0
  127. package/src/monorepo/.claude/prompt-snippets/ponytail-help.md +5 -0
  128. package/src/monorepo/.claude/prompt-snippets/ponytail-review.md +5 -0
  129. package/src/monorepo/.claude/prompt-snippets/ponytail.md +5 -0
  130. package/src/monorepo/.claude/prompt-snippets/release-notes.md +134 -0
  131. package/src/monorepo/.claude/prompt-snippets/review-pr.md +156 -0
  132. package/src/monorepo/.claude/prompt-snippets/review-staged.md +35 -0
  133. package/src/monorepo/.claude/prompt-snippets/review.md +139 -0
  134. package/src/monorepo/.claude/prompt-snippets/specify.md +51 -0
  135. package/src/monorepo/.claude/prompt-snippets/tasks.md +108 -0
  136. package/src/monorepo/.claude/rules/agent-conduct.md +14 -0
  137. package/src/monorepo/.claude/rules/api-server.md +19 -0
  138. package/src/monorepo/.claude/rules/coding-standards.md +13 -0
  139. package/src/monorepo/.claude/rules/component-structure.md +18 -0
  140. package/src/monorepo/.claude/rules/core-libraries.md +16 -0
  141. package/src/monorepo/.claude/rules/environment-tooling.md +12 -0
  142. package/src/monorepo/.claude/rules/logging-comments.md +17 -0
  143. package/src/monorepo/.claude/rules/logging.md +17 -0
  144. package/src/monorepo/.claude/rules/orient-to-recent-work.md +13 -0
  145. package/src/monorepo/.claude/rules/prisma-migrations.md +16 -0
  146. package/src/monorepo/.claude/rules/project-context.md +14 -0
  147. package/src/monorepo/.claude/rules/server-client-separation.md +17 -0
  148. package/src/monorepo/.claude/rules/subagent-workflow.md +14 -0
  149. package/src/monorepo/.claude/rules/testing-quality.md +19 -0
  150. package/src/monorepo/.claude/rules/testing.md +16 -0
  151. package/src/monorepo/.claude/rules/ui-accessibility.md +18 -0
  152. package/src/monorepo/.claude/rules/version-control.md +14 -0
  153. package/src/monorepo/.claude/rules/what-to-avoid.md +14 -0
  154. package/src/monorepo/.claude/rules-snippets/agent-conduct.md +51 -0
  155. package/src/monorepo/.claude/rules-snippets/api-server.md +5 -0
  156. package/src/monorepo/.claude/rules-snippets/coding-standards.md +45 -0
  157. package/src/monorepo/.claude/rules-snippets/component-structure.md +6 -0
  158. package/src/monorepo/.claude/rules-snippets/core-libraries.md +6 -0
  159. package/src/monorepo/.claude/rules-snippets/deployment.md +41 -0
  160. package/src/monorepo/.claude/rules-snippets/documentation.md +210 -0
  161. package/src/monorepo/.claude/rules-snippets/environment-tooling.md +4 -0
  162. package/src/monorepo/.claude/rules-snippets/logging-comments.md +4 -0
  163. package/src/monorepo/.claude/rules-snippets/logging.md +107 -0
  164. package/src/monorepo/.claude/rules-snippets/patterns.md +134 -0
  165. package/src/monorepo/.claude/rules-snippets/ponytail.md +24 -0
  166. package/src/monorepo/.claude/rules-snippets/prisma-migrations.md +6 -0
  167. package/src/monorepo/.claude/rules-snippets/project-context.md +8 -0
  168. package/src/monorepo/.claude/rules-snippets/server-client-separation.md +5 -0
  169. package/src/monorepo/.claude/rules-snippets/subagent-workflow.md +134 -0
  170. package/src/monorepo/.claude/rules-snippets/testing-quality.md +5 -0
  171. package/src/monorepo/.claude/rules-snippets/testing.md +42 -0
  172. package/src/monorepo/.claude/rules-snippets/ui-accessibility.md +5 -0
  173. package/src/monorepo/.claude/rules-snippets/version-control.md +4 -0
  174. package/src/monorepo/.claude/rules-snippets/what-to-avoid.md +6 -0
  175. package/src/monorepo/.claude/rules-snippets/workflows.md +81 -0
  176. package/src/monorepo/.claude/settings.json +7 -0
  177. package/src/monorepo/.claude/skills/README.md +50 -0
  178. package/src/monorepo/.cursor/agents/admin-portal.agent.md +11 -0
  179. package/src/monorepo/.cursor/agents/api-specialist.agent.md +11 -0
  180. package/src/monorepo/.cursor/agents/backend-architect.agent.md +11 -0
  181. package/src/monorepo/.cursor/agents/documenter.agent.md +11 -0
  182. package/src/monorepo/.cursor/agents/feature-builder.agent.md +11 -0
  183. package/src/monorepo/.cursor/agents/frontend-developer.agent.md +11 -0
  184. package/src/monorepo/.cursor/agents/green.agent.md +11 -0
  185. package/src/monorepo/.cursor/agents/implementer.agent.md +11 -0
  186. package/src/monorepo/.cursor/agents/planner.agent.md +11 -0
  187. package/src/monorepo/.cursor/agents/red.agent.md +11 -0
  188. package/src/monorepo/.cursor/agents/refactor.agent.md +11 -0
  189. package/src/monorepo/.cursor/agents/researcher.agent.md +11 -0
  190. package/src/monorepo/.cursor/agents/reviewer.agent.md +11 -0
  191. package/src/monorepo/.cursor/agents/tdd.agent.md +11 -0
  192. package/src/monorepo/.cursor/commands/assign-tasks.md +13 -0
  193. package/src/monorepo/.cursor/commands/bootstrap-patch.md +17 -0
  194. package/src/monorepo/.cursor/commands/bootstrap-upgrade.md +15 -0
  195. package/src/monorepo/.cursor/commands/bootstrap.md +17 -0
  196. package/src/monorepo/.cursor/commands/commit-push.md +15 -0
  197. package/src/monorepo/.cursor/commands/constitution.md +17 -0
  198. package/src/monorepo/.cursor/commands/create-skill.md +17 -0
  199. package/src/monorepo/.cursor/commands/implement-feature.md +17 -0
  200. package/src/monorepo/.cursor/commands/implement-fixes.md +17 -0
  201. package/src/monorepo/.cursor/commands/implement.md +17 -0
  202. package/src/monorepo/.cursor/commands/plan.md +17 -0
  203. package/src/monorepo/.cursor/commands/playwright-test.md +15 -0
  204. package/src/monorepo/.cursor/commands/ponytail-audit.md +13 -0
  205. package/src/monorepo/.cursor/commands/ponytail-debt.md +13 -0
  206. package/src/monorepo/.cursor/commands/ponytail-gain.md +13 -0
  207. package/src/monorepo/.cursor/commands/ponytail-help.md +13 -0
  208. package/src/monorepo/.cursor/commands/ponytail-review.md +13 -0
  209. package/src/monorepo/.cursor/commands/ponytail.md +13 -0
  210. package/src/monorepo/.cursor/commands/release-notes.md +15 -0
  211. package/src/monorepo/.cursor/commands/review-pr.md +17 -0
  212. package/src/monorepo/.cursor/commands/review-staged.md +10 -0
  213. package/src/monorepo/.cursor/commands/review.md +17 -0
  214. package/src/monorepo/.cursor/commands/specify.md +17 -0
  215. package/src/monorepo/.cursor/commands/tasks.md +15 -0
  216. package/src/monorepo/.cursor/mcp.json +13 -0
  217. package/src/monorepo/.cursor/rules/agent-conduct.mdc +11 -0
  218. package/src/monorepo/.cursor/rules/api-server.mdc +11 -0
  219. package/src/monorepo/.cursor/rules/coding-standards.mdc +11 -0
  220. package/src/monorepo/.cursor/rules/component-structure.mdc +11 -0
  221. package/src/monorepo/.cursor/rules/core-libraries.mdc +11 -0
  222. package/src/monorepo/.cursor/rules/environment-tooling.mdc +11 -0
  223. package/src/monorepo/.cursor/rules/logging-comments.mdc +11 -0
  224. package/src/monorepo/.cursor/rules/logging.mdc +10 -0
  225. package/src/monorepo/.cursor/rules/orient-to-recent-work.mdc +9 -0
  226. package/src/monorepo/.cursor/rules/ponytail.mdc +9 -0
  227. package/src/monorepo/.cursor/rules/prisma-migrations.mdc +11 -0
  228. package/src/monorepo/.cursor/rules/project-context.mdc +11 -0
  229. package/src/monorepo/.cursor/rules/server-client-separation.mdc +11 -0
  230. package/src/monorepo/.cursor/rules/subagent-workflow.mdc +11 -0
  231. package/src/monorepo/.cursor/rules/testing-quality.mdc +11 -0
  232. package/src/monorepo/.cursor/rules/ui-accessibility.mdc +11 -0
  233. package/src/monorepo/.cursor/rules/version-control.mdc +11 -0
  234. package/src/monorepo/.cursor/rules/what-to-avoid.mdc +11 -0
  235. package/src/monorepo/.cursor/skills/README.md +50 -0
  236. package/src/monorepo/.github/agents/admin-portal.agent.md +11 -0
  237. package/src/monorepo/.github/agents/api-specialist.agent.md +11 -0
  238. package/src/monorepo/.github/agents/backend-architect.agent.md +11 -0
  239. package/src/monorepo/.github/agents/documenter.agent.md +11 -0
  240. package/src/monorepo/.github/agents/feature-builder.agent.md +24 -0
  241. package/src/monorepo/.github/agents/frontend-developer.agent.md +11 -0
  242. package/src/monorepo/.github/agents/green.agent.md +12 -0
  243. package/src/monorepo/.github/agents/implementer.agent.md +12 -0
  244. package/src/monorepo/.github/agents/planner.agent.md +12 -0
  245. package/src/monorepo/.github/agents/red.agent.md +12 -0
  246. package/src/monorepo/.github/agents/refactor.agent.md +12 -0
  247. package/src/monorepo/.github/agents/researcher.agent.md +12 -0
  248. package/src/monorepo/.github/agents/reviewer.agent.md +11 -0
  249. package/src/monorepo/.github/agents/tdd.agent.md +13 -0
  250. package/src/monorepo/.github/copilot-instructions.md +95 -0
  251. package/src/monorepo/.github/instructions/agent-conduct.instructions.md +14 -0
  252. package/src/monorepo/.github/instructions/api-server.instructions.md +14 -0
  253. package/src/monorepo/.github/instructions/coding-standards.instructions.md +13 -0
  254. package/src/monorepo/.github/instructions/component-structure.instructions.md +14 -0
  255. package/src/monorepo/.github/instructions/core-libraries.instructions.md +14 -0
  256. package/src/monorepo/.github/instructions/deployment.instructions.md +13 -0
  257. package/src/monorepo/.github/instructions/documentation.instructions.md +14 -0
  258. package/src/monorepo/.github/instructions/environment-tooling.instructions.md +14 -0
  259. package/src/monorepo/.github/instructions/logging-comments.instructions.md +14 -0
  260. package/src/monorepo/.github/instructions/logging.instructions.md +14 -0
  261. package/src/monorepo/.github/instructions/patterns.instructions.md +14 -0
  262. package/src/monorepo/.github/instructions/prisma-migrations.instructions.md +14 -0
  263. package/src/monorepo/.github/instructions/project-context.instructions.md +13 -0
  264. package/src/monorepo/.github/instructions/server-client-separation.instructions.md +14 -0
  265. package/src/monorepo/.github/instructions/subagent-workflow.instructions.md +14 -0
  266. package/src/monorepo/.github/instructions/testing-quality.instructions.md +15 -0
  267. package/src/monorepo/.github/instructions/testing.instructions.md +14 -0
  268. package/src/monorepo/.github/instructions/ui-accessibility.instructions.md +14 -0
  269. package/src/monorepo/.github/instructions/version-control.instructions.md +14 -0
  270. package/src/monorepo/.github/instructions/what-to-avoid.instructions.md +14 -0
  271. package/src/monorepo/.github/instructions/workflows.instructions.md +14 -0
  272. package/src/monorepo/.github/prompts/assign-tasks.prompt.md +14 -0
  273. package/src/monorepo/.github/prompts/bootstrap-patch.prompt.md +15 -0
  274. package/src/monorepo/.github/prompts/bootstrap-upgrade.prompt.md +15 -0
  275. package/src/monorepo/.github/prompts/bootstrap.prompt.md +15 -0
  276. package/src/monorepo/.github/prompts/commit-push.prompt.md +13 -0
  277. package/src/monorepo/.github/prompts/constitution.prompt.md +15 -0
  278. package/src/monorepo/.github/prompts/create-skill.prompt.md +15 -0
  279. package/src/monorepo/.github/prompts/implement-feature.prompt.md +15 -0
  280. package/src/monorepo/.github/prompts/implement-fixes.prompt.md +15 -0
  281. package/src/monorepo/.github/prompts/implement.prompt.md +15 -0
  282. package/src/monorepo/.github/prompts/plan.prompt.md +15 -0
  283. package/src/monorepo/.github/prompts/playwright-test.prompt.md +13 -0
  284. package/src/monorepo/.github/prompts/ponytail-audit.prompt.md +13 -0
  285. package/src/monorepo/.github/prompts/ponytail-debt.prompt.md +13 -0
  286. package/src/monorepo/.github/prompts/ponytail-gain.prompt.md +13 -0
  287. package/src/monorepo/.github/prompts/ponytail-help.prompt.md +13 -0
  288. package/src/monorepo/.github/prompts/ponytail-review.prompt.md +13 -0
  289. package/src/monorepo/.github/prompts/ponytail.prompt.md +13 -0
  290. package/src/monorepo/.github/prompts/release-notes.prompt.md +13 -0
  291. package/src/monorepo/.github/prompts/review-pr.prompt.md +15 -0
  292. package/src/monorepo/.github/prompts/review-staged.prompt.md +16 -0
  293. package/src/monorepo/.github/prompts/review.prompt.md +15 -0
  294. package/src/monorepo/.github/prompts/specify.prompt.md +15 -0
  295. package/src/monorepo/.github/prompts/tasks.prompt.md +13 -0
  296. package/src/monorepo/.github/skills/README.md +36 -0
  297. package/src/monorepo/.mcp.json +13 -0
  298. package/src/monorepo/.opencode/agents/admin-portal.md +14 -0
  299. package/src/monorepo/.opencode/agents/api-specialist.md +14 -0
  300. package/src/monorepo/.opencode/agents/backend-architect.md +14 -0
  301. package/src/monorepo/.opencode/agents/documenter.md +14 -0
  302. package/src/monorepo/.opencode/agents/feature-builder.md +15 -0
  303. package/src/monorepo/.opencode/agents/frontend-developer.md +14 -0
  304. package/src/monorepo/.opencode/agents/green.md +14 -0
  305. package/src/monorepo/.opencode/agents/implementer.md +14 -0
  306. package/src/monorepo/.opencode/agents/planner.md +14 -0
  307. package/src/monorepo/.opencode/agents/red.md +14 -0
  308. package/src/monorepo/.opencode/agents/refactor.md +14 -0
  309. package/src/monorepo/.opencode/agents/researcher.md +14 -0
  310. package/src/monorepo/.opencode/agents/reviewer.md +14 -0
  311. package/src/monorepo/.opencode/agents/tdd.md +15 -0
  312. package/src/monorepo/.opencode/commands/assign-tasks.md +16 -0
  313. package/src/monorepo/.opencode/commands/bootstrap-patch.md +18 -0
  314. package/src/monorepo/.opencode/commands/bootstrap-upgrade.md +18 -0
  315. package/src/monorepo/.opencode/commands/bootstrap.md +18 -0
  316. package/src/monorepo/.opencode/commands/commit-push.md +16 -0
  317. package/src/monorepo/.opencode/commands/constitution.md +18 -0
  318. package/src/monorepo/.opencode/commands/create-skill.md +16 -0
  319. package/src/monorepo/.opencode/commands/implement-feature.md +18 -0
  320. package/src/monorepo/.opencode/commands/implement-fixes.md +20 -0
  321. package/src/monorepo/.opencode/commands/implement.md +18 -0
  322. package/src/monorepo/.opencode/commands/plan.md +18 -0
  323. package/src/monorepo/.opencode/commands/playwright-test.md +16 -0
  324. package/src/monorepo/.opencode/commands/ponytail-audit.md +10 -0
  325. package/src/monorepo/.opencode/commands/ponytail-debt.md +10 -0
  326. package/src/monorepo/.opencode/commands/ponytail-gain.md +10 -0
  327. package/src/monorepo/.opencode/commands/ponytail-help.md +10 -0
  328. package/src/monorepo/.opencode/commands/ponytail-review.md +10 -0
  329. package/src/monorepo/.opencode/commands/ponytail.md +10 -0
  330. package/src/monorepo/.opencode/commands/release-notes.md +16 -0
  331. package/src/monorepo/.opencode/commands/review-pr.md +18 -0
  332. package/src/monorepo/.opencode/commands/review-staged.md +11 -0
  333. package/src/monorepo/.opencode/commands/review.md +18 -0
  334. package/src/monorepo/.opencode/commands/specify.md +18 -0
  335. package/src/monorepo/.opencode/commands/tasks.md +16 -0
  336. package/src/monorepo/.opencode/opencode.json +9 -0
  337. package/src/monorepo/.opencode/plugins/ponytail.mjs +79 -0
  338. package/src/monorepo/.opencode/rules/agent-conduct.md +12 -0
  339. package/src/monorepo/.opencode/rules/api-server.md +11 -0
  340. package/src/monorepo/.opencode/rules/coding-standards.md +11 -0
  341. package/src/monorepo/.opencode/rules/component-structure.md +11 -0
  342. package/src/monorepo/.opencode/rules/core-libraries.md +11 -0
  343. package/src/monorepo/.opencode/rules/environment-tooling.md +11 -0
  344. package/src/monorepo/.opencode/rules/logging-comments.md +11 -0
  345. package/src/monorepo/.opencode/rules/logging.md +11 -0
  346. package/src/monorepo/.opencode/rules/ponytail.md +3 -0
  347. package/src/monorepo/.opencode/rules/prisma-migrations.md +11 -0
  348. package/src/monorepo/.opencode/rules/project-context.md +11 -0
  349. package/src/monorepo/.opencode/rules/server-client-separation.md +11 -0
  350. package/src/monorepo/.opencode/rules/subagent-workflow.md +11 -0
  351. package/src/monorepo/.opencode/rules/testing-quality.md +11 -0
  352. package/src/monorepo/.opencode/rules/ui-accessibility.md +11 -0
  353. package/src/monorepo/.opencode/rules/version-control.md +11 -0
  354. package/src/monorepo/.opencode/rules/what-to-avoid.md +11 -0
  355. package/src/monorepo/.vscode/mcp.json +13 -0
  356. package/src/monorepo/AGENTS.md +367 -0
  357. package/src/monorepo/CLAUDE.md +63 -0
  358. package/src/monorepo/README.md +182 -0
  359. package/src/monorepo/apps/app-template/AGENTS.md +169 -0
  360. package/src/monorepo/apps/app-template/README.md +77 -0
  361. package/src/monorepo/docs/api/README.md +82 -0
  362. package/src/monorepo/docs/architecture/README.md +56 -0
  363. package/src/monorepo/docs/features/README.md +82 -0
  364. package/src/monorepo/docs/fixes/README.md +117 -0
  365. package/src/monorepo/hooks/claude-codex-hooks.json +31 -0
  366. package/src/monorepo/hooks/copilot-hooks.json +21 -0
  367. package/src/monorepo/hooks/ponytail-activate.js +91 -0
  368. package/src/monorepo/hooks/ponytail-config.js +122 -0
  369. package/src/monorepo/hooks/ponytail-instructions.js +92 -0
  370. package/src/monorepo/hooks/ponytail-mode-tracker.js +55 -0
  371. package/src/monorepo/hooks/ponytail-runtime.js +51 -0
  372. package/src/monorepo/hooks/ponytail-statusline.ps1 +21 -0
  373. package/src/monorepo/hooks/ponytail-statusline.sh +12 -0
  374. package/src/monorepo/packages/package-template/README.md +63 -0
  375. package/src/monorepo/templates/README.md +106 -0
  376. package/src/monorepo/templates/adr.template.md +156 -0
  377. package/src/monorepo/templates/complex-fix-plan.template.md +154 -0
  378. package/src/monorepo/templates/complex-fix-spec.template.md +160 -0
  379. package/src/monorepo/templates/feature-plan.template.md +192 -0
  380. package/src/monorepo/templates/feature-spec.template.md +148 -0
  381. package/src/monorepo/templates/monthly-fix-log.template.md +92 -0
  382. package/src/repo/.agents/rules/ponytail.md +3 -0
  383. package/src/repo/.agents/skills/acli/SKILL.md +424 -0
  384. package/src/repo/.agents/skills/bkt-cli/SKILL.md +374 -0
  385. package/src/repo/.agents/skills/brainstorming/SKILL.md +54 -0
  386. package/src/repo/.agents/skills/code-simplifier/SKILL.md +109 -0
  387. package/src/repo/.agents/skills/debugger/SKILL.md +123 -0
  388. package/src/repo/.agents/skills/dispatching-parallel-agents/SKILL.md +206 -0
  389. package/src/repo/.agents/skills/executing-plans/SKILL.md +76 -0
  390. package/src/repo/.agents/skills/finishing-a-development-branch/SKILL.md +200 -0
  391. package/src/repo/.agents/skills/gh-cli/SKILL.md +461 -0
  392. package/src/repo/.agents/skills/glab-cli/SKILL.md +468 -0
  393. package/src/repo/.agents/skills/issue-tracker/SKILL.md +119 -0
  394. package/src/repo/.agents/skills/linear-cli/SKILL.md +276 -0
  395. package/src/repo/.agents/skills/logging/SKILL.md +559 -0
  396. package/src/repo/.agents/skills/orient-to-recent-work/SKILL.md +43 -0
  397. package/src/repo/.agents/skills/ponytail/SKILL.md +101 -0
  398. package/src/repo/.agents/skills/ponytail-audit/SKILL.md +41 -0
  399. package/src/repo/.agents/skills/ponytail-debt/SKILL.md +44 -0
  400. package/src/repo/.agents/skills/ponytail-gain/SKILL.md +51 -0
  401. package/src/repo/.agents/skills/ponytail-help/SKILL.md +74 -0
  402. package/src/repo/.agents/skills/ponytail-review/SKILL.md +57 -0
  403. package/src/repo/.agents/skills/project-documentation/SKILL.md +367 -0
  404. package/src/repo/.agents/skills/receiving-code-review/SKILL.md +213 -0
  405. package/src/repo/.agents/skills/requesting-code-review/SKILL.md +105 -0
  406. package/src/repo/.agents/skills/requesting-code-review/code-reviewer.md +146 -0
  407. package/src/repo/.agents/skills/security-reviewer/SKILL.md +144 -0
  408. package/src/repo/.agents/skills/subagent-driven-development/SKILL.md +279 -0
  409. package/src/repo/.agents/skills/subagent-driven-development/code-quality-reviewer-prompt.md +20 -0
  410. package/src/repo/.agents/skills/subagent-driven-development/implementer-prompt.md +78 -0
  411. package/src/repo/.agents/skills/subagent-driven-development/spec-reviewer-prompt.md +61 -0
  412. package/src/repo/.agents/skills/systematic-debugging/CREATION-LOG.md +119 -0
  413. package/src/repo/.agents/skills/systematic-debugging/SKILL.md +296 -0
  414. package/src/repo/.agents/skills/systematic-debugging/condition-based-waiting-example.ts +158 -0
  415. package/src/repo/.agents/skills/systematic-debugging/condition-based-waiting.md +115 -0
  416. package/src/repo/.agents/skills/systematic-debugging/defense-in-depth.md +122 -0
  417. package/src/repo/.agents/skills/systematic-debugging/find-polluter.sh +63 -0
  418. package/src/repo/.agents/skills/systematic-debugging/root-cause-tracing.md +169 -0
  419. package/src/repo/.agents/skills/systematic-debugging/test-academic.md +14 -0
  420. package/src/repo/.agents/skills/systematic-debugging/test-pressure-1.md +58 -0
  421. package/src/repo/.agents/skills/systematic-debugging/test-pressure-2.md +68 -0
  422. package/src/repo/.agents/skills/systematic-debugging/test-pressure-3.md +69 -0
  423. package/src/repo/.agents/skills/test-driven-development/SKILL.md +371 -0
  424. package/src/repo/.agents/skills/test-driven-development/testing-anti-patterns.md +299 -0
  425. package/src/repo/.agents/skills/using-git-worktrees/SKILL.md +291 -0
  426. package/src/repo/.agents/skills/using-superpowers/SKILL.md +87 -0
  427. package/src/repo/.agents/skills/verification-before-completion/SKILL.md +148 -0
  428. package/src/repo/.agents/skills/writing-plans/SKILL.md +116 -0
  429. package/src/repo/.agents/skills/writing-skills/SKILL.md +655 -0
  430. package/src/repo/.agents/skills/writing-skills/anthropic-best-practices.md +1150 -0
  431. package/src/repo/.agents/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  432. package/src/repo/.agents/skills/writing-skills/graphviz-conventions.dot +172 -0
  433. package/src/repo/.agents/skills/writing-skills/persuasion-principles.md +187 -0
  434. package/src/repo/.agents/skills/writing-skills/render-graphs.js +168 -0
  435. package/src/repo/.agents/skills/writing-skills/testing-skills-with-subagents.md +384 -0
  436. package/src/repo/.claude/agents/admin-portal.agent.md +12 -0
  437. package/src/repo/.claude/agents/api-specialist.agent.md +12 -0
  438. package/src/repo/.claude/agents/backend-architect.agent.md +12 -0
  439. package/src/repo/.claude/agents/documenter.agent.md +12 -0
  440. package/src/repo/.claude/agents/feature-builder.agent.md +12 -0
  441. package/src/repo/.claude/agents/frontend-developer.agent.md +12 -0
  442. package/src/repo/.claude/agents/green.agent.md +12 -0
  443. package/src/repo/.claude/agents/implementer.agent.md +12 -0
  444. package/src/repo/.claude/agents/planner.agent.md +12 -0
  445. package/src/repo/.claude/agents/red.agent.md +12 -0
  446. package/src/repo/.claude/agents/refactor.agent.md +12 -0
  447. package/src/repo/.claude/agents/researcher.agent.md +12 -0
  448. package/src/repo/.claude/agents/reviewer.agent.md +12 -0
  449. package/src/repo/.claude/agents/tdd.agent.md +12 -0
  450. package/src/repo/.claude/agents-snippets/admin-portal.md +90 -0
  451. package/src/repo/.claude/agents-snippets/api-specialist.md +57 -0
  452. package/src/repo/.claude/agents-snippets/backend-architect.md +49 -0
  453. package/src/repo/.claude/agents-snippets/documenter.md +58 -0
  454. package/src/repo/.claude/agents-snippets/feature-builder.md +49 -0
  455. package/src/repo/.claude/agents-snippets/frontend-developer.md +49 -0
  456. package/src/repo/.claude/agents-snippets/green.md +18 -0
  457. package/src/repo/.claude/agents-snippets/implementer.md +31 -0
  458. package/src/repo/.claude/agents-snippets/planner.md +40 -0
  459. package/src/repo/.claude/agents-snippets/red.md +14 -0
  460. package/src/repo/.claude/agents-snippets/refactor.md +22 -0
  461. package/src/repo/.claude/agents-snippets/researcher.md +43 -0
  462. package/src/repo/.claude/agents-snippets/reviewer.md +83 -0
  463. package/src/repo/.claude/agents-snippets/tdd.md +18 -0
  464. package/src/repo/.claude/commands/assign-tasks.md +13 -0
  465. package/src/repo/.claude/commands/bootstrap-patch.md +15 -0
  466. package/src/repo/.claude/commands/bootstrap-upgrade.md +15 -0
  467. package/src/repo/.claude/commands/bootstrap.md +15 -0
  468. package/src/repo/.claude/commands/commit-push.md +13 -0
  469. package/src/repo/.claude/commands/constitution.md +15 -0
  470. package/src/repo/.claude/commands/create-skill.md +13 -0
  471. package/src/repo/.claude/commands/implement-feature.md +15 -0
  472. package/src/repo/.claude/commands/implement-fixes.md +15 -0
  473. package/src/repo/.claude/commands/implement.md +15 -0
  474. package/src/repo/.claude/commands/plan.md +15 -0
  475. package/src/repo/.claude/commands/playwright-test.md +13 -0
  476. package/src/repo/.claude/commands/ponytail-audit.md +15 -0
  477. package/src/repo/.claude/commands/ponytail-debt.md +15 -0
  478. package/src/repo/.claude/commands/ponytail-gain.md +15 -0
  479. package/src/repo/.claude/commands/ponytail-help.md +15 -0
  480. package/src/repo/.claude/commands/ponytail-review.md +15 -0
  481. package/src/repo/.claude/commands/ponytail.md +15 -0
  482. package/src/repo/.claude/commands/release-notes.md +13 -0
  483. package/src/repo/.claude/commands/review-pr.md +15 -0
  484. package/src/repo/.claude/commands/review-staged.md +15 -0
  485. package/src/repo/.claude/commands/review.md +15 -0
  486. package/src/repo/.claude/commands/specify.md +15 -0
  487. package/src/repo/.claude/commands/tasks.md +13 -0
  488. package/src/repo/.claude/prompt-snippets/assign-tasks.md +170 -0
  489. package/src/repo/.claude/prompt-snippets/bootstrap-patch.md +200 -0
  490. package/src/repo/.claude/prompt-snippets/bootstrap-upgrade.md +357 -0
  491. package/src/repo/.claude/prompt-snippets/bootstrap.md +1026 -0
  492. package/src/repo/.claude/prompt-snippets/commit-push.md +70 -0
  493. package/src/repo/.claude/prompt-snippets/constitution.md +57 -0
  494. package/src/repo/.claude/prompt-snippets/create-skill.md +490 -0
  495. package/src/repo/.claude/prompt-snippets/implement-feature.md +124 -0
  496. package/src/repo/.claude/prompt-snippets/implement-fixes.md +116 -0
  497. package/src/repo/.claude/prompt-snippets/implement.md +56 -0
  498. package/src/repo/.claude/prompt-snippets/plan.md +94 -0
  499. package/src/repo/.claude/prompt-snippets/playwright-test.md +58 -0
  500. package/src/repo/.claude/prompt-snippets/ponytail-audit.md +5 -0
  501. package/src/repo/.claude/prompt-snippets/ponytail-debt.md +5 -0
  502. package/src/repo/.claude/prompt-snippets/ponytail-gain.md +5 -0
  503. package/src/repo/.claude/prompt-snippets/ponytail-help.md +5 -0
  504. package/src/repo/.claude/prompt-snippets/ponytail-review.md +5 -0
  505. package/src/repo/.claude/prompt-snippets/ponytail.md +5 -0
  506. package/src/repo/.claude/prompt-snippets/release-notes.md +204 -0
  507. package/src/repo/.claude/prompt-snippets/review-pr.md +156 -0
  508. package/src/repo/.claude/prompt-snippets/review-staged.md +35 -0
  509. package/src/repo/.claude/prompt-snippets/review.md +139 -0
  510. package/src/repo/.claude/prompt-snippets/specify.md +84 -0
  511. package/src/repo/.claude/prompt-snippets/tasks.md +146 -0
  512. package/src/repo/.claude/rules/agent-conduct.md +13 -0
  513. package/src/repo/.claude/rules/api-server.md +16 -0
  514. package/src/repo/.claude/rules/coding-standards.md +13 -0
  515. package/src/repo/.claude/rules/component-structure.md +15 -0
  516. package/src/repo/.claude/rules/core-libraries.md +13 -0
  517. package/src/repo/.claude/rules/environment-tooling.md +13 -0
  518. package/src/repo/.claude/rules/logging-comments.md +13 -0
  519. package/src/repo/.claude/rules/logging.md +13 -0
  520. package/src/repo/.claude/rules/orient-to-recent-work.md +13 -0
  521. package/src/repo/.claude/rules/prisma-migrations.md +16 -0
  522. package/src/repo/.claude/rules/project-context.md +13 -0
  523. package/src/repo/.claude/rules/server-client-separation.md +13 -0
  524. package/src/repo/.claude/rules/subagent-workflow.md +13 -0
  525. package/src/repo/.claude/rules/testing-quality.md +16 -0
  526. package/src/repo/.claude/rules/testing.md +16 -0
  527. package/src/repo/.claude/rules/ui-accessibility.md +15 -0
  528. package/src/repo/.claude/rules/version-control.md +13 -0
  529. package/src/repo/.claude/rules/what-to-avoid.md +13 -0
  530. package/src/repo/.claude/rules-snippets/agent-conduct.md +51 -0
  531. package/src/repo/.claude/rules-snippets/api-server.md +7 -0
  532. package/src/repo/.claude/rules-snippets/coding-standards.md +45 -0
  533. package/src/repo/.claude/rules-snippets/component-structure.md +8 -0
  534. package/src/repo/.claude/rules-snippets/core-libraries.md +6 -0
  535. package/src/repo/.claude/rules-snippets/deployment.md +38 -0
  536. package/src/repo/.claude/rules-snippets/documentation.md +621 -0
  537. package/src/repo/.claude/rules-snippets/environment-tooling.md +6 -0
  538. package/src/repo/.claude/rules-snippets/logging-comments.md +4 -0
  539. package/src/repo/.claude/rules-snippets/logging.md +352 -0
  540. package/src/repo/.claude/rules-snippets/patterns.md +29 -0
  541. package/src/repo/.claude/rules-snippets/ponytail.md +24 -0
  542. package/src/repo/.claude/rules-snippets/prisma-migrations.md +8 -0
  543. package/src/repo/.claude/rules-snippets/project-context.md +25 -0
  544. package/src/repo/.claude/rules-snippets/server-client-separation.md +7 -0
  545. package/src/repo/.claude/rules-snippets/subagent-workflow.md +134 -0
  546. package/src/repo/.claude/rules-snippets/testing-quality.md +5 -0
  547. package/src/repo/.claude/rules-snippets/testing.md +38 -0
  548. package/src/repo/.claude/rules-snippets/ui-accessibility.md +7 -0
  549. package/src/repo/.claude/rules-snippets/version-control.md +6 -0
  550. package/src/repo/.claude/rules-snippets/what-to-avoid.md +8 -0
  551. package/src/repo/.claude/rules-snippets/workflows.md +25 -0
  552. package/src/repo/.claude/settings.json +7 -0
  553. package/src/repo/.claude/skills/README.md +50 -0
  554. package/src/repo/.cursor/agents/admin-portal.agent.md +11 -0
  555. package/src/repo/.cursor/agents/api-specialist.agent.md +11 -0
  556. package/src/repo/.cursor/agents/backend-architect.agent.md +11 -0
  557. package/src/repo/.cursor/agents/documenter.agent.md +11 -0
  558. package/src/repo/.cursor/agents/feature-builder.agent.md +11 -0
  559. package/src/repo/.cursor/agents/frontend-developer.agent.md +11 -0
  560. package/src/repo/.cursor/agents/green.agent.md +11 -0
  561. package/src/repo/.cursor/agents/implementer.agent.md +11 -0
  562. package/src/repo/.cursor/agents/planner.agent.md +11 -0
  563. package/src/repo/.cursor/agents/red.agent.md +11 -0
  564. package/src/repo/.cursor/agents/refactor.agent.md +11 -0
  565. package/src/repo/.cursor/agents/researcher.agent.md +11 -0
  566. package/src/repo/.cursor/agents/reviewer.agent.md +11 -0
  567. package/src/repo/.cursor/agents/tdd.agent.md +11 -0
  568. package/src/repo/.cursor/commands/assign-tasks.md +13 -0
  569. package/src/repo/.cursor/commands/bootstrap-patch.md +17 -0
  570. package/src/repo/.cursor/commands/bootstrap-upgrade.md +15 -0
  571. package/src/repo/.cursor/commands/bootstrap.md +17 -0
  572. package/src/repo/.cursor/commands/commit-push.md +15 -0
  573. package/src/repo/.cursor/commands/constitution.md +17 -0
  574. package/src/repo/.cursor/commands/create-skill.md +15 -0
  575. package/src/repo/.cursor/commands/implement-feature.md +17 -0
  576. package/src/repo/.cursor/commands/implement-fixes.md +17 -0
  577. package/src/repo/.cursor/commands/implement.md +17 -0
  578. package/src/repo/.cursor/commands/plan.md +17 -0
  579. package/src/repo/.cursor/commands/playwright-test.md +15 -0
  580. package/src/repo/.cursor/commands/ponytail-audit.md +13 -0
  581. package/src/repo/.cursor/commands/ponytail-debt.md +13 -0
  582. package/src/repo/.cursor/commands/ponytail-gain.md +13 -0
  583. package/src/repo/.cursor/commands/ponytail-help.md +13 -0
  584. package/src/repo/.cursor/commands/ponytail-review.md +13 -0
  585. package/src/repo/.cursor/commands/ponytail.md +13 -0
  586. package/src/repo/.cursor/commands/release-notes.md +15 -0
  587. package/src/repo/.cursor/commands/review-pr.md +17 -0
  588. package/src/repo/.cursor/commands/review-staged.md +10 -0
  589. package/src/repo/.cursor/commands/review.md +17 -0
  590. package/src/repo/.cursor/commands/specify.md +17 -0
  591. package/src/repo/.cursor/commands/tasks.md +15 -0
  592. package/src/repo/.cursor/mcp.json +13 -0
  593. package/src/repo/.cursor/rules/agent-conduct.mdc +11 -0
  594. package/src/repo/.cursor/rules/api-server.mdc +11 -0
  595. package/src/repo/.cursor/rules/coding-standards.mdc +11 -0
  596. package/src/repo/.cursor/rules/component-structure.mdc +11 -0
  597. package/src/repo/.cursor/rules/core-libraries.mdc +11 -0
  598. package/src/repo/.cursor/rules/environment-tooling.mdc +11 -0
  599. package/src/repo/.cursor/rules/logging-comments.mdc +11 -0
  600. package/src/repo/.cursor/rules/logging.mdc +11 -0
  601. package/src/repo/.cursor/rules/orient-to-recent-work.mdc +9 -0
  602. package/src/repo/.cursor/rules/ponytail.mdc +9 -0
  603. package/src/repo/.cursor/rules/prisma-migrations.mdc +11 -0
  604. package/src/repo/.cursor/rules/project-context.mdc +11 -0
  605. package/src/repo/.cursor/rules/server-client-separation.mdc +11 -0
  606. package/src/repo/.cursor/rules/subagent-workflow.mdc +11 -0
  607. package/src/repo/.cursor/rules/testing-quality.mdc +11 -0
  608. package/src/repo/.cursor/rules/ui-accessibility.mdc +11 -0
  609. package/src/repo/.cursor/rules/version-control.mdc +11 -0
  610. package/src/repo/.cursor/rules/what-to-avoid.mdc +11 -0
  611. package/src/repo/.cursor/skills/README.md +50 -0
  612. package/src/repo/.github/agents/admin-portal.agent.md +11 -0
  613. package/src/repo/.github/agents/api-specialist.agent.md +11 -0
  614. package/src/repo/.github/agents/backend-architect.agent.md +11 -0
  615. package/src/repo/.github/agents/documenter.agent.md +11 -0
  616. package/src/repo/.github/agents/feature-builder.agent.md +24 -0
  617. package/src/repo/.github/agents/frontend-developer.agent.md +11 -0
  618. package/src/repo/.github/agents/green.agent.md +12 -0
  619. package/src/repo/.github/agents/implementer.agent.md +12 -0
  620. package/src/repo/.github/agents/planner.agent.md +12 -0
  621. package/src/repo/.github/agents/red.agent.md +12 -0
  622. package/src/repo/.github/agents/refactor.agent.md +12 -0
  623. package/src/repo/.github/agents/researcher.agent.md +12 -0
  624. package/src/repo/.github/agents/reviewer.agent.md +11 -0
  625. package/src/repo/.github/agents/tdd.agent.md +13 -0
  626. package/src/repo/.github/copilot-instructions.md +89 -0
  627. package/src/repo/.github/instructions/agent-conduct.instructions.md +13 -0
  628. package/src/repo/.github/instructions/api-server.instructions.md +13 -0
  629. package/src/repo/.github/instructions/coding-standards.instructions.md +13 -0
  630. package/src/repo/.github/instructions/component-structure.instructions.md +13 -0
  631. package/src/repo/.github/instructions/core-libraries.instructions.md +13 -0
  632. package/src/repo/.github/instructions/deployment.instructions.md +13 -0
  633. package/src/repo/.github/instructions/documentation.instructions.md +14 -0
  634. package/src/repo/.github/instructions/environment-tooling.instructions.md +13 -0
  635. package/src/repo/.github/instructions/logging-comments.instructions.md +13 -0
  636. package/src/repo/.github/instructions/logging.instructions.md +13 -0
  637. package/src/repo/.github/instructions/patterns.instructions.md +13 -0
  638. package/src/repo/.github/instructions/prisma-migrations.instructions.md +13 -0
  639. package/src/repo/.github/instructions/project-context.instructions.md +13 -0
  640. package/src/repo/.github/instructions/server-client-separation.instructions.md +13 -0
  641. package/src/repo/.github/instructions/subagent-workflow.instructions.md +13 -0
  642. package/src/repo/.github/instructions/testing-quality.instructions.md +13 -0
  643. package/src/repo/.github/instructions/testing.instructions.md +13 -0
  644. package/src/repo/.github/instructions/ui-accessibility.instructions.md +13 -0
  645. package/src/repo/.github/instructions/version-control.instructions.md +13 -0
  646. package/src/repo/.github/instructions/what-to-avoid.instructions.md +13 -0
  647. package/src/repo/.github/instructions/workflows.instructions.md +13 -0
  648. package/src/repo/.github/prompts/assign-tasks.prompt.md +14 -0
  649. package/src/repo/.github/prompts/bootstrap-patch.prompt.md +16 -0
  650. package/src/repo/.github/prompts/bootstrap-upgrade.prompt.md +15 -0
  651. package/src/repo/.github/prompts/bootstrap.prompt.md +16 -0
  652. package/src/repo/.github/prompts/commit-push.prompt.md +14 -0
  653. package/src/repo/.github/prompts/constitution.prompt.md +16 -0
  654. package/src/repo/.github/prompts/create-skill.prompt.md +16 -0
  655. package/src/repo/.github/prompts/implement-feature.prompt.md +16 -0
  656. package/src/repo/.github/prompts/implement-fixes.prompt.md +16 -0
  657. package/src/repo/.github/prompts/implement.prompt.md +16 -0
  658. package/src/repo/.github/prompts/plan.prompt.md +16 -0
  659. package/src/repo/.github/prompts/playwright-test.prompt.md +14 -0
  660. package/src/repo/.github/prompts/ponytail-audit.prompt.md +13 -0
  661. package/src/repo/.github/prompts/ponytail-debt.prompt.md +13 -0
  662. package/src/repo/.github/prompts/ponytail-gain.prompt.md +13 -0
  663. package/src/repo/.github/prompts/ponytail-help.prompt.md +13 -0
  664. package/src/repo/.github/prompts/ponytail-review.prompt.md +13 -0
  665. package/src/repo/.github/prompts/ponytail.prompt.md +13 -0
  666. package/src/repo/.github/prompts/release-notes.prompt.md +14 -0
  667. package/src/repo/.github/prompts/review-pr.prompt.md +16 -0
  668. package/src/repo/.github/prompts/review-staged.prompt.md +16 -0
  669. package/src/repo/.github/prompts/review.prompt.md +16 -0
  670. package/src/repo/.github/prompts/specify.prompt.md +16 -0
  671. package/src/repo/.github/prompts/tasks.prompt.md +14 -0
  672. package/src/repo/.github/skills/README.md +36 -0
  673. package/src/repo/.mcp.json +13 -0
  674. package/src/repo/.opencode/agents/admin-portal.md +14 -0
  675. package/src/repo/.opencode/agents/api-specialist.md +14 -0
  676. package/src/repo/.opencode/agents/backend-architect.md +14 -0
  677. package/src/repo/.opencode/agents/documenter.md +14 -0
  678. package/src/repo/.opencode/agents/feature-builder.md +15 -0
  679. package/src/repo/.opencode/agents/frontend-developer.md +14 -0
  680. package/src/repo/.opencode/agents/green.md +14 -0
  681. package/src/repo/.opencode/agents/implementer.md +14 -0
  682. package/src/repo/.opencode/agents/planner.md +14 -0
  683. package/src/repo/.opencode/agents/red.md +14 -0
  684. package/src/repo/.opencode/agents/refactor.md +14 -0
  685. package/src/repo/.opencode/agents/researcher.md +14 -0
  686. package/src/repo/.opencode/agents/reviewer.md +14 -0
  687. package/src/repo/.opencode/agents/tdd.md +15 -0
  688. package/src/repo/.opencode/commands/assign-tasks.md +16 -0
  689. package/src/repo/.opencode/commands/bootstrap-patch.md +18 -0
  690. package/src/repo/.opencode/commands/bootstrap-upgrade.md +18 -0
  691. package/src/repo/.opencode/commands/bootstrap.md +18 -0
  692. package/src/repo/.opencode/commands/commit-push.md +16 -0
  693. package/src/repo/.opencode/commands/constitution.md +18 -0
  694. package/src/repo/.opencode/commands/create-skill.md +16 -0
  695. package/src/repo/.opencode/commands/implement-feature.md +18 -0
  696. package/src/repo/.opencode/commands/implement-fixes.md +20 -0
  697. package/src/repo/.opencode/commands/implement.md +18 -0
  698. package/src/repo/.opencode/commands/plan.md +18 -0
  699. package/src/repo/.opencode/commands/playwright-test.md +16 -0
  700. package/src/repo/.opencode/commands/ponytail-audit.md +10 -0
  701. package/src/repo/.opencode/commands/ponytail-debt.md +10 -0
  702. package/src/repo/.opencode/commands/ponytail-gain.md +10 -0
  703. package/src/repo/.opencode/commands/ponytail-help.md +10 -0
  704. package/src/repo/.opencode/commands/ponytail-review.md +10 -0
  705. package/src/repo/.opencode/commands/ponytail.md +10 -0
  706. package/src/repo/.opencode/commands/release-notes.md +16 -0
  707. package/src/repo/.opencode/commands/review-pr.md +18 -0
  708. package/src/repo/.opencode/commands/review-staged.md +11 -0
  709. package/src/repo/.opencode/commands/review.md +18 -0
  710. package/src/repo/.opencode/commands/specify.md +18 -0
  711. package/src/repo/.opencode/commands/tasks.md +16 -0
  712. package/src/repo/.opencode/opencode.json +9 -0
  713. package/src/repo/.opencode/plugins/ponytail.mjs +79 -0
  714. package/src/repo/.opencode/rules/agent-conduct.md +11 -0
  715. package/src/repo/.opencode/rules/api-server.md +11 -0
  716. package/src/repo/.opencode/rules/coding-standards.md +11 -0
  717. package/src/repo/.opencode/rules/component-structure.md +11 -0
  718. package/src/repo/.opencode/rules/core-libraries.md +11 -0
  719. package/src/repo/.opencode/rules/environment-tooling.md +11 -0
  720. package/src/repo/.opencode/rules/logging-comments.md +11 -0
  721. package/src/repo/.opencode/rules/logging.md +11 -0
  722. package/src/repo/.opencode/rules/ponytail.md +3 -0
  723. package/src/repo/.opencode/rules/prisma-migrations.md +11 -0
  724. package/src/repo/.opencode/rules/project-context.md +11 -0
  725. package/src/repo/.opencode/rules/server-client-separation.md +11 -0
  726. package/src/repo/.opencode/rules/subagent-workflow.md +11 -0
  727. package/src/repo/.opencode/rules/testing-quality.md +11 -0
  728. package/src/repo/.opencode/rules/ui-accessibility.md +11 -0
  729. package/src/repo/.opencode/rules/version-control.md +11 -0
  730. package/src/repo/.opencode/rules/what-to-avoid.md +11 -0
  731. package/src/repo/.vscode/mcp.json +13 -0
  732. package/src/repo/AGENTS.md +387 -0
  733. package/src/repo/CLAUDE.md +51 -0
  734. package/src/repo/README.md +145 -0
  735. package/src/repo/docs/api/README.md +82 -0
  736. package/src/repo/docs/architecture/README.md +56 -0
  737. package/src/repo/docs/features/README.md +82 -0
  738. package/src/repo/docs/fixes/README.md +117 -0
  739. package/src/repo/hooks/claude-codex-hooks.json +31 -0
  740. package/src/repo/hooks/copilot-hooks.json +21 -0
  741. package/src/repo/hooks/ponytail-activate.js +91 -0
  742. package/src/repo/hooks/ponytail-config.js +122 -0
  743. package/src/repo/hooks/ponytail-instructions.js +92 -0
  744. package/src/repo/hooks/ponytail-mode-tracker.js +55 -0
  745. package/src/repo/hooks/ponytail-runtime.js +51 -0
  746. package/src/repo/hooks/ponytail-statusline.ps1 +21 -0
  747. package/src/repo/hooks/ponytail-statusline.sh +12 -0
  748. package/src/repo/templates/README.md +80 -0
  749. package/src/repo/templates/adr.template.md +162 -0
  750. package/src/repo/templates/complex-fix-plan.template.md +162 -0
  751. package/src/repo/templates/complex-fix-spec.template.md +163 -0
  752. package/src/repo/templates/feature-plan.template.md +202 -0
  753. package/src/repo/templates/feature-spec.template.md +148 -0
  754. package/src/repo/templates/monthly-fix-log.template.md +91 -0
@@ -0,0 +1,105 @@
1
+ ---
2
+ name: requesting-code-review
3
+ description: Use when completing tasks, implementing major features, or before merging to verify work meets requirements
4
+ ---
5
+
6
+ # Requesting Code Review
7
+
8
+ Dispatch superpowers:code-reviewer subagent to catch issues before they cascade.
9
+
10
+ **Core principle:** Review early, review often.
11
+
12
+ ## When to Request Review
13
+
14
+ **Mandatory:**
15
+ - After each task in subagent-driven development
16
+ - After completing major feature
17
+ - Before merge to main
18
+
19
+ **Optional but valuable:**
20
+ - When stuck (fresh perspective)
21
+ - Before refactoring (baseline check)
22
+ - After fixing complex bug
23
+
24
+ ## How to Request
25
+
26
+ **1. Get git SHAs:**
27
+ ```bash
28
+ BASE_SHA=$(git rev-parse HEAD~1) # or origin/main
29
+ HEAD_SHA=$(git rev-parse HEAD)
30
+ ```
31
+
32
+ **2. Dispatch code-reviewer subagent:**
33
+
34
+ Use Task tool with superpowers:code-reviewer type, fill template at `code-reviewer.md`
35
+
36
+ **Placeholders:**
37
+ - `{WHAT_WAS_IMPLEMENTED}` - What you just built
38
+ - `{PLAN_OR_REQUIREMENTS}` - What it should do
39
+ - `{BASE_SHA}` - Starting commit
40
+ - `{HEAD_SHA}` - Ending commit
41
+ - `{DESCRIPTION}` - Brief summary
42
+
43
+ **3. Act on feedback:**
44
+ - Fix Critical issues immediately
45
+ - Fix Important issues before proceeding
46
+ - Note Minor issues for later
47
+ - Push back if reviewer is wrong (with reasoning)
48
+
49
+ ## Example
50
+
51
+ ```
52
+ [Just completed Task 2: Add verification function]
53
+
54
+ You: Let me request code review before proceeding.
55
+
56
+ BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | awk '{print $1}')
57
+ HEAD_SHA=$(git rev-parse HEAD)
58
+
59
+ [Dispatch superpowers:code-reviewer subagent]
60
+ WHAT_WAS_IMPLEMENTED: Verification and repair functions for conversation index
61
+ PLAN_OR_REQUIREMENTS: Task 2 from apps/{{APP_NAME}}/docs/features/{{ISSUE_ID}}-deployment/plan.md
62
+ BASE_SHA: a7981ec
63
+ HEAD_SHA: 3df7661
64
+ DESCRIPTION: Added verifyIndex() and repairIndex() with 4 issue types
65
+
66
+ [Subagent returns]:
67
+ Strengths: Clean architecture, real tests
68
+ Issues:
69
+ Important: Missing progress indicators
70
+ Minor: Magic number (100) for reporting interval
71
+ Assessment: Ready to proceed
72
+
73
+ You: [Fix progress indicators]
74
+ [Continue to Task 3]
75
+ ```
76
+
77
+ ## Integration with Workflows
78
+
79
+ **Subagent-Driven Development:**
80
+ - Review after EACH task
81
+ - Catch issues before they compound
82
+ - Fix before moving to next task
83
+
84
+ **Executing Plans:**
85
+ - Review after each batch (3 tasks)
86
+ - Get feedback, apply, continue
87
+
88
+ **Ad-Hoc Development:**
89
+ - Review before merge
90
+ - Review when stuck
91
+
92
+ ## Red Flags
93
+
94
+ **Never:**
95
+ - Skip review because "it's simple"
96
+ - Ignore Critical issues
97
+ - Proceed with unfixed Important issues
98
+ - Argue with valid technical feedback
99
+
100
+ **If reviewer wrong:**
101
+ - Push back with technical reasoning
102
+ - Show code/tests that prove it works
103
+ - Request clarification
104
+
105
+ See template at: requesting-code-review/code-reviewer.md
@@ -0,0 +1,146 @@
1
+ # Code Review Agent
2
+
3
+ You are reviewing code changes for production readiness.
4
+
5
+ **Your task:**
6
+ 1. Review {WHAT_WAS_IMPLEMENTED}
7
+ 2. Compare against {PLAN_OR_REQUIREMENTS}
8
+ 3. Check code quality, architecture, testing
9
+ 4. Categorize issues by severity
10
+ 5. Assess production readiness
11
+
12
+ ## What Was Implemented
13
+
14
+ {DESCRIPTION}
15
+
16
+ ## Requirements/Plan
17
+
18
+ {PLAN_REFERENCE}
19
+
20
+ ## Git Range to Review
21
+
22
+ **Base:** {BASE_SHA}
23
+ **Head:** {HEAD_SHA}
24
+
25
+ ```bash
26
+ git diff --stat {BASE_SHA}..{HEAD_SHA}
27
+ git diff {BASE_SHA}..{HEAD_SHA}
28
+ ```
29
+
30
+ ## Review Checklist
31
+
32
+ **Code Quality:**
33
+ - Clean separation of concerns?
34
+ - Proper error handling?
35
+ - Type safety (if applicable)?
36
+ - DRY principle followed?
37
+ - Edge cases handled?
38
+
39
+ **Architecture:**
40
+ - Sound design decisions?
41
+ - Scalability considerations?
42
+ - Performance implications?
43
+ - Security concerns?
44
+
45
+ **Testing:**
46
+ - Tests actually test logic (not mocks)?
47
+ - Edge cases covered?
48
+ - Integration tests where needed?
49
+ - All tests passing?
50
+
51
+ **Requirements:**
52
+ - All plan requirements met?
53
+ - Implementation matches spec?
54
+ - No scope creep?
55
+ - Breaking changes documented?
56
+
57
+ **Production Readiness:**
58
+ - Migration strategy (if schema changes)?
59
+ - Backward compatibility considered?
60
+ - Documentation complete?
61
+ - No obvious bugs?
62
+
63
+ ## Output Format
64
+
65
+ ### Strengths
66
+ [What's well done? Be specific.]
67
+
68
+ ### Issues
69
+
70
+ #### Critical (Must Fix)
71
+ [Bugs, security issues, data loss risks, broken functionality]
72
+
73
+ #### Important (Should Fix)
74
+ [Architecture problems, missing features, poor error handling, test gaps]
75
+
76
+ #### Minor (Nice to Have)
77
+ [Code style, optimization opportunities, documentation improvements]
78
+
79
+ **For each issue:**
80
+ - File:line reference
81
+ - What's wrong
82
+ - Why it matters
83
+ - How to fix (if not obvious)
84
+
85
+ ### Recommendations
86
+ [Improvements for code quality, architecture, or process]
87
+
88
+ ### Assessment
89
+
90
+ **Ready to merge?** [Yes/No/With fixes]
91
+
92
+ **Reasoning:** [Technical assessment in 1-2 sentences]
93
+
94
+ ## Critical Rules
95
+
96
+ **DO:**
97
+ - Categorize by actual severity (not everything is Critical)
98
+ - Be specific (file:line, not vague)
99
+ - Explain WHY issues matter
100
+ - Acknowledge strengths
101
+ - Give clear verdict
102
+
103
+ **DON'T:**
104
+ - Say "looks good" without checking
105
+ - Mark nitpicks as Critical
106
+ - Give feedback on code you didn't review
107
+ - Be vague ("improve error handling")
108
+ - Avoid giving a clear verdict
109
+
110
+ ## Example Output
111
+
112
+ ```
113
+ ### Strengths
114
+ - Clean database schema with proper migrations (db.ts:15-42)
115
+ - Comprehensive test coverage (18 tests, all edge cases)
116
+ - Good error handling with fallbacks (summarizer.ts:85-92)
117
+
118
+ ### Issues
119
+
120
+ #### Important
121
+ 1. **Missing help text in CLI wrapper**
122
+ - File: index-conversations:1-31
123
+ - Issue: No --help flag, users won't discover --concurrency
124
+ - Fix: Add --help case with usage examples
125
+
126
+ 2. **Date validation missing**
127
+ - File: search.ts:25-27
128
+ - Issue: Invalid dates silently return no results
129
+ - Fix: Validate ISO format, throw error with example
130
+
131
+ #### Minor
132
+ 1. **Progress indicators**
133
+ - File: indexer.ts:130
134
+ - Issue: No "X of Y" counter for long operations
135
+ - Impact: Users don't know how long to wait
136
+
137
+ ### Recommendations
138
+ - Add progress reporting for user experience
139
+ - Consider config file for excluded projects (portability)
140
+
141
+ ### Assessment
142
+
143
+ **Ready to merge: With fixes**
144
+
145
+ **Reasoning:** Core implementation is solid with good architecture and tests. Important issues (help text, date validation) are easily fixed and don't affect core functionality.
146
+ ```
@@ -0,0 +1,144 @@
1
+ ---
2
+ name: security-reviewer
3
+ description: Use for security-focused code audits on auth, payments, user data, API endpoints, or file uploads. Performs OWASP Top 10 checklist review. Dispatch as a fresh subagent with no shared context to avoid anchoring bias.
4
+ ---
5
+
6
+ # Security Reviewer
7
+
8
+ Security-focused code audit using OWASP Top 10 checklist.
9
+
10
+ **Purpose:** Find security vulnerabilities before they reach production — think like an attacker.
11
+
12
+ **When to use:**
13
+ - Security-sensitive code changes (auth, payments, user data, API endpoints, file uploads)
14
+ - As part of comprehensive code review
15
+ - Before merging security-critical features
16
+
17
+ **CRITICAL:** Dispatch as a fresh subagent with NO shared conversation context. Shared context creates anchoring bias and causes reviewers to rubber-stamp work they watched being built.
18
+
19
+ ## Dispatch Template
20
+
21
+ ```
22
+ You are a Staff Security Engineer performing a security-focused code audit.
23
+ Your job is to find vulnerabilities before they reach production. Think like
24
+ an attacker — what can be exploited?
25
+
26
+ ## What Was Changed
27
+
28
+ [Summary of what was implemented — endpoints, models, auth changes, etc.]
29
+
30
+ ## Files to Review
31
+
32
+ [List all changed files, especially controllers, models, services, middleware, config]
33
+
34
+ ## Git Context
35
+
36
+ - Base SHA: [commit before changes]
37
+ - Head SHA: [current commit]
38
+
39
+ Run `git diff {Base SHA}..{Head SHA}` to view all changes before beginning the audit.
40
+ ```
41
+
42
+ ## Security Audit Checklist
43
+
44
+ ### Injection (CRITICAL)
45
+
46
+ - [ ] **SQL injection**: String concatenation in queries? Unparameterized inputs?
47
+ Check for `.where("column = '#{value}'")`, `Arel.sql()` with user input,
48
+ `.whereRaw()`, `.raw()`, template literals in SQL strings.
49
+ - [ ] **Command injection**: `system()`, `exec()`, backticks with user input?
50
+ Unsanitized arguments to shell commands?
51
+ - [ ] **XSS**: Unescaped user input in HTML/templates? `html_safe` on user content?
52
+ `innerHTML`, `dangerouslySetInnerHTML` with user data?
53
+ - [ ] **NoSQL injection**: Unvalidated query operators in MongoDB/similar?
54
+ - [ ] **Header injection**: User input in HTTP headers without sanitization?
55
+
56
+ ### Broken Authentication & Authorization (CRITICAL)
57
+
58
+ - [ ] **Missing authentication**: Are new endpoints protected by auth middleware?
59
+ - [ ] **Missing authorization**: Do actions check that the current user is allowed?
60
+ - [ ] **IDOR**: Can users access other users' resources by changing IDs in URLs/params?
61
+ Are queries scoped: `current_user.resources.find(params[:id])` vs `Resource.find(params[:id])`?
62
+ - [ ] **Privilege escalation**: Can regular users access admin-only actions?
63
+ Are role checks enforced server-side (not just UI)?
64
+ - [ ] **Session management**: Secure token generation? Proper expiration? HttpOnly cookies?
65
+
66
+ ### Sensitive Data Exposure (CRITICAL)
67
+
68
+ - [ ] **Secrets in code**: API keys, passwords, tokens hardcoded? Check for Base64-encoded secrets.
69
+ - [ ] **Secrets in logs**: PII, credentials, tokens logged? Check logger, console.log statements.
70
+ - [ ] **Sensitive API responses**: Password hashes, internal IDs, admin flags, other users' PII
71
+ in API responses? Check serializers for overexposure.
72
+ - [ ] **Missing encryption**: Sensitive data stored/transmitted without encryption?
73
+ - [ ] **CORS**: Overly permissive `Access-Control-Allow-Origin: *`?
74
+
75
+ ### Input Validation (IMPORTANT)
76
+
77
+ - [ ] **Missing validation**: Are controller params validated before use? Strong parameters?
78
+ - [ ] **Type coercion**: Could type confusion bypass checks?
79
+ - [ ] **File uploads**: Type validation? Size limits? Content sniffing protection?
80
+ Filename sanitization?
81
+ - [ ] **ReDoS**: Complex regex patterns on user input that could cause catastrophic backtracking?
82
+ - [ ] **Mass assignment**: `permit!` or overly broad `params.permit(...)` allowing
83
+ role/admin/internal fields to be set by users?
84
+
85
+ ### Security Misconfiguration (IMPORTANT)
86
+
87
+ - [ ] **Debug/verbose errors**: Stack traces or internal details exposed in error responses?
88
+ - [ ] **Default credentials**: Default passwords, API keys, or configurations?
89
+ - [ ] **Missing security headers**: CSP, X-Frame-Options, X-Content-Type-Options?
90
+ - [ ] **Dependency vulnerabilities**: Known CVEs in added/updated dependencies?
91
+
92
+ ### SSRF — Server-Side Request Forgery (IMPORTANT)
93
+
94
+ - [ ] **User-controlled URLs**: Are user-supplied URLs passed to HTTP clients?
95
+ - [ ] **Domain allowlist**: Are outbound HTTP requests restricted to a known-safe list of domains?
96
+ - [ ] **Internal metadata**: Could a user trigger requests to internal metadata endpoints
97
+ (AWS `169.254.169.254`, GCP metadata server)?
98
+
99
+ ### Cryptographic Failures (IMPORTANT)
100
+
101
+ - [ ] **Weak hash algorithms**: MD5 or SHA1 used for security-sensitive data?
102
+ Should use bcrypt/argon2 for passwords, SHA-256+ for tokens.
103
+ - [ ] **Hardcoded secrets**: Encryption keys, salts, IVs, or API tokens hardcoded in source?
104
+ - [ ] **`.env` committed**: Secret ENV files committed to version control?
105
+ - [ ] **JWT payload exposure**: Sensitive data in JWT payload without encryption (signed ≠ encrypted)?
106
+
107
+ ### Logging & Monitoring (MINOR)
108
+
109
+ - [ ] **Missing security event logs**: Failed auth attempts, permission denials, input validation
110
+ failures — are they logged for monitoring?
111
+ - [ ] **Missing audit trail**: Sensitive operations (delete, role change, data export) — is there
112
+ an audit log?
113
+ - [ ] **Error message leakage**: Do error messages reveal internal structure, file paths,
114
+ database schema, or stack traces?
115
+
116
+ ## Report Format
117
+
118
+ For each finding, report:
119
+
120
+ **[CRITICAL/IMPORTANT/MINOR] — [Category] — [Short description]**
121
+ - File: `path/to/file:line_number`
122
+ - Problem: [What's wrong — describe the attack vector clearly]
123
+ - Recommendation: [Specific remediation with code snippet]
124
+ - Impact: [What an attacker could do — data breach, privilege escalation, RCE, etc.]
125
+ - CWE: [CWE ID, e.g., CWE-89 (SQL Injection), CWE-79 (XSS), CWE-862 (Missing Authorization)]
126
+
127
+ ## Assessment
128
+
129
+ - **CRITICAL findings MUST be fixed before merge.** No exceptions.
130
+ - **IMPORTANT findings MUST be fixed before merge.** No exceptions.
131
+ - **MINOR findings** are noted but do not block merge.
132
+
133
+ Final verdict:
134
+ - **APPROVED**: No critical or important security findings
135
+ - **CHANGES REQUIRED**: Critical or important security findings that must be fixed before merge
136
+
137
+ ## Review Loop
138
+
139
+ 1. **Critical findings:** Author MUST fix, re-run tests, then re-request security review
140
+ 2. **Important findings:** Author MUST fix, re-run tests, then re-request security review
141
+ 3. **Minor findings:** Note in review but do not block
142
+ 4. **Max 3 review cycles.** If critical or important findings persist after 3 cycles, escalate to user.
143
+
144
+ After fixes, dispatch another security review to verify critical and important findings are resolved.
@@ -0,0 +1,279 @@
1
+ ---
2
+ name: subagent-driven-development
3
+ description: Use when executing implementation plans with independent tasks in the current session
4
+ ---
5
+
6
+ # Subagent-Driven Development
7
+
8
+ Execute plan by dispatching fresh subagent per task, with two-stage review after each: spec compliance review first, then code quality review.
9
+
10
+ **Core principle:** Fresh subagent per task + two-stage review (spec then quality) = high quality, fast iteration
11
+
12
+ ## When to Use
13
+
14
+ ```dot
15
+ digraph when_to_use {
16
+ "Have implementation plan?" [shape=diamond];
17
+ "Tasks mostly independent?" [shape=diamond];
18
+ "Stay in this session?" [shape=diamond];
19
+ "subagent-driven-development" [shape=box];
20
+ "executing-plans" [shape=box];
21
+ "Manual execution or brainstorm first" [shape=box];
22
+
23
+ "Have implementation plan?" -> "Tasks mostly independent?" [label="yes"];
24
+ "Have implementation plan?" -> "Manual execution or brainstorm first" [label="no"];
25
+ "Tasks mostly independent?" -> "Stay in this session?" [label="yes"];
26
+ "Tasks mostly independent?" -> "Manual execution or brainstorm first" [label="no - tightly coupled"];
27
+ "Stay in this session?" -> "subagent-driven-development" [label="yes"];
28
+ "Stay in this session?" -> "executing-plans" [label="no - parallel session"];
29
+ }
30
+ ```
31
+
32
+ **vs. Executing Plans (parallel session):**
33
+
34
+ - Same session (no context switch)
35
+ - Fresh subagent per task (no context pollution)
36
+ - Two-stage review after each task: spec compliance first, then code quality
37
+ - Faster iteration (no human-in-loop between tasks)
38
+
39
+ ## The Process
40
+
41
+ ```dot
42
+ digraph process {
43
+ rankdir=TB;
44
+
45
+ subgraph cluster_per_task {
46
+ label="Per Task";
47
+ "Dispatch implementer subagent (./implementer-prompt.md)" [shape=box];
48
+ "Implementer subagent asks questions?" [shape=diamond];
49
+ "Answer questions, provide context" [shape=box];
50
+ "Implementer subagent implements, tests, commits, self-reviews" [shape=box];
51
+ "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [shape=box];
52
+ "Spec reviewer subagent confirms code matches spec?" [shape=diamond];
53
+ "Implementer subagent fixes spec gaps" [shape=box];
54
+ "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [shape=box];
55
+ "Code quality reviewer subagent approves?" [shape=diamond];
56
+ "Implementer subagent fixes quality issues" [shape=box];
57
+ "Mark task complete in TodoWrite" [shape=box];
58
+ }
59
+
60
+ "Read plan, extract all tasks with full text, note context, create TodoWrite" [shape=box];
61
+ "More tasks remain?" [shape=diamond];
62
+ "Dispatch final code reviewer subagent for entire implementation" [shape=box];
63
+ "Use superpowers:finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen];
64
+
65
+ "Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer subagent (./implementer-prompt.md)";
66
+ "Dispatch implementer subagent (./implementer-prompt.md)" -> "Implementer subagent asks questions?";
67
+ "Implementer subagent asks questions?" -> "Answer questions, provide context" [label="yes"];
68
+ "Answer questions, provide context" -> "Dispatch implementer subagent (./implementer-prompt.md)";
69
+ "Implementer subagent asks questions?" -> "Implementer subagent implements, tests, commits, self-reviews" [label="no"];
70
+ "Implementer subagent implements, tests, commits, self-reviews" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)";
71
+ "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" -> "Spec reviewer subagent confirms code matches spec?";
72
+ "Spec reviewer subagent confirms code matches spec?" -> "Implementer subagent fixes spec gaps" [label="no"];
73
+ "Implementer subagent fixes spec gaps" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [label="re-review"];
74
+ "Spec reviewer subagent confirms code matches spec?" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="yes"];
75
+ "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" -> "Code quality reviewer subagent approves?";
76
+ "Code quality reviewer subagent approves?" -> "Implementer subagent fixes quality issues" [label="no"];
77
+ "Implementer subagent fixes quality issues" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="re-review"];
78
+ "Code quality reviewer subagent approves?" -> "Mark task complete in TodoWrite" [label="yes"];
79
+ "Mark task complete in TodoWrite" -> "More tasks remain?";
80
+ "More tasks remain?" -> "Dispatch implementer subagent (./implementer-prompt.md)" [label="yes"];
81
+ "More tasks remain?" -> "Dispatch final code reviewer subagent for entire implementation" [label="no"];
82
+ "Dispatch final code reviewer subagent for entire implementation" -> "Use superpowers:finishing-a-development-branch";
83
+ }
84
+ ```
85
+
86
+ ## Prompt Templates
87
+
88
+ - `./implementer-prompt.md` - Dispatch implementer subagent
89
+ - `./spec-reviewer-prompt.md` - Dispatch spec compliance reviewer subagent
90
+ - `./code-quality-reviewer-prompt.md` - Dispatch code quality reviewer subagent
91
+
92
+ ## Example Workflow
93
+
94
+ ```
95
+ You: I'm using Subagent-Driven Development to execute this plan.
96
+
97
+ [Read plan file once: apps/{{APP_NAME}}/docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/plan.md]
98
+ [Extract all 5 tasks with full text and context]
99
+ [Create TodoWrite with all tasks]
100
+
101
+ Task 1: Hook installation script
102
+
103
+ [Get Task 1 text and context (already extracted)]
104
+ [Dispatch implementation subagent with full task text + context]
105
+
106
+ Implementer: "Before I begin - should the hook be installed at user or system level?"
107
+
108
+ You: "User level (~/.config/superpowers/hooks/)"
109
+
110
+ Implementer: "Got it. Implementing now..."
111
+ [Later] Implementer:
112
+ - Implemented install-hook command
113
+ - Added tests, 5/5 passing
114
+ - Self-review: Found I missed --force flag, added it
115
+ - Committed
116
+
117
+ [Dispatch spec compliance reviewer]
118
+ Spec reviewer: ✅ Spec compliant - all requirements met, nothing extra
119
+
120
+ [Get git SHAs, dispatch code quality reviewer]
121
+ Code reviewer: Strengths: Good test coverage, clean. Issues: None. Approved.
122
+
123
+ [Mark Task 1 complete]
124
+
125
+ Task 2: Recovery modes
126
+
127
+ [Get Task 2 text and context (already extracted)]
128
+ [Dispatch implementation subagent with full task text + context]
129
+
130
+ Implementer: [No questions, proceeds]
131
+ Implementer:
132
+ - Added verify/repair modes
133
+ - 8/8 tests passing
134
+ - Self-review: All good
135
+ - Committed
136
+
137
+ [Dispatch spec compliance reviewer]
138
+ Spec reviewer: ❌ Issues:
139
+ - Missing: Progress reporting (spec says "report every 100 items")
140
+ - Extra: Added --json flag (not requested)
141
+
142
+ [Implementer fixes issues]
143
+ Implementer: Removed --json flag, added progress reporting
144
+
145
+ [Spec reviewer reviews again]
146
+ Spec reviewer: ✅ Spec compliant now
147
+
148
+ [Dispatch code quality reviewer]
149
+ Code reviewer: Strengths: Solid. Issues (Important): Magic number (100)
150
+
151
+ [Implementer fixes]
152
+ Implementer: Extracted PROGRESS_INTERVAL constant
153
+
154
+ [Code reviewer reviews again]
155
+ Code reviewer: ✅ Approved
156
+
157
+ [Mark Task 2 complete]
158
+
159
+ ...
160
+
161
+ [After all tasks]
162
+ [Dispatch final code-reviewer]
163
+ Final reviewer: All requirements met, ready to merge
164
+
165
+ Done!
166
+ ```
167
+
168
+ ## Advantages
169
+
170
+ **vs. Manual execution:**
171
+
172
+ - Subagents follow TDD naturally
173
+ - Fresh context per task (no confusion)
174
+ - Parallel-safe (subagents don't interfere)
175
+ - Subagent can ask questions (before AND during work)
176
+
177
+ **vs. Executing Plans:**
178
+
179
+ - Same session (no handoff)
180
+ - Continuous progress (no waiting)
181
+ - Review checkpoints automatic
182
+
183
+ **Efficiency gains:**
184
+
185
+ - No file reading overhead (controller provides full text)
186
+ - Controller curates exactly what context is needed
187
+ - Subagent gets complete information upfront
188
+ - Questions surfaced before work begins (not after)
189
+
190
+ **Quality gates:**
191
+
192
+ - Self-review catches issues before handoff
193
+ - Two-stage review: spec compliance, then code quality
194
+ - Review loops ensure fixes actually work
195
+ - Spec compliance prevents over/under-building
196
+ - Code quality ensures implementation is well-built
197
+
198
+ **Cost:**
199
+
200
+ - More subagent invocations (implementer + 2 reviewers per task)
201
+ - Controller does more prep work (extracting all tasks upfront)
202
+ - Review loops add iterations
203
+ - But catches issues early (cheaper than debugging later)
204
+
205
+ ## Red Flags
206
+
207
+ **Never:**
208
+
209
+ - Skip reviews (spec compliance OR code quality)
210
+ - Proceed with unfixed issues
211
+ - Dispatch multiple implementation subagents in parallel (conflicts)
212
+ - Make subagent read plan file (provide full text instead)
213
+ - Skip scene-setting context (subagent needs to understand where task fits)
214
+ - Ignore subagent questions (answer before letting them proceed)
215
+ - Accept "close enough" on spec compliance (spec reviewer found issues = not done)
216
+ - Skip review loops (reviewer found issues = implementer fixes = review again)
217
+ - Let implementer self-review replace actual review (both are needed)
218
+ - **Start code quality review before spec compliance is ✅** (wrong order)
219
+ - Move to next task while either review has open issues
220
+
221
+ **If subagent asks questions:**
222
+
223
+ - Answer clearly and completely
224
+ - Provide additional context if needed
225
+ - Don't rush them into implementation
226
+
227
+ **If reviewer finds issues:**
228
+
229
+ - Implementer (same subagent) fixes them
230
+ - Reviewer reviews again
231
+ - Repeat until approved
232
+ - Don't skip the re-review
233
+
234
+ **If subagent fails task:**
235
+
236
+ - Dispatch fix subagent with specific instructions
237
+ - Don't try to fix manually (context pollution)
238
+
239
+ ## Domain-Aware Dispatch
240
+
241
+ When dispatching an implementer subagent, choose the agent whose expertise matches the task domain:
242
+
243
+ | Task Domain | Agent | When to Use |
244
+ | --------------------------------------------- | ---------------------- | --------------------------------------------------------- |
245
+ | API design, databases, system architecture | **Backend Architect** | Schema changes, service layer, auth, performance |
246
+ | UI components, state management, styling | **Frontend Developer** | Components, layouts, responsive design, accessibility |
247
+ | API contracts, docs, versioning | **API Specialist** | OpenAPI specs, client SDKs, API versioning, integration |
248
+ | Admin dashboards, RBAC, reporting, monitoring | **Admin Portal** | Admin panels, roles/permissions, analytics, system health |
249
+ | Documentation | **Documenter** | README updates, ADRs, API docs, AGENTS.md |
250
+ | General implementation | **Implementer** | Tasks that don't fit a specialist domain |
251
+
252
+ **Multi-domain tasks:** If a task spans domains (e.g., "add endpoint with UI"), dispatch the primary domain specialist and note the secondary concern. For example, dispatch **Backend Architect** for the endpoint, then **Frontend Developer** for the UI — as separate tasks.
253
+
254
+ The implementer-prompt.md template works for any of these agents — just specify which agent to dispatch.
255
+
256
+ ## Integration
257
+
258
+ **Required workflow skills:**
259
+
260
+ - **superpowers:writing-plans** - Creates the plan this skill executes
261
+ - **superpowers:requesting-code-review** - Code review template for reviewer subagents
262
+ - **superpowers:finishing-a-development-branch** - Complete development after all tasks
263
+
264
+ **Subagents should use:**
265
+
266
+ - **superpowers:test-driven-development** - Subagents follow TDD for each task
267
+
268
+ **Domain specialist agents (see `.github/agents/` or `.cursor/agents/`):**
269
+
270
+ - **Backend Architect** - Backend and infrastructure tasks
271
+ - **Frontend Developer** - UI and frontend tasks
272
+ - **API Specialist** - API contract and integration tasks
273
+ - **Admin Portal** - Admin dashboards, RBAC, reporting, monitoring tasks
274
+ - **Documenter** - Documentation tasks
275
+ - **Reviewer** - Code review (replaces generic code quality reviewer when invoked directly)
276
+
277
+ **Alternative workflow:**
278
+
279
+ - **superpowers:executing-plans** - Use for parallel session instead of same-session execution
@@ -0,0 +1,20 @@
1
+ # Code Quality Reviewer Prompt Template
2
+
3
+ Use this template when dispatching a code quality reviewer subagent.
4
+
5
+ **Purpose:** Verify implementation is well-built (clean, tested, maintainable)
6
+
7
+ **Only dispatch after spec compliance review passes.**
8
+
9
+ ```
10
+ Task tool (superpowers:code-reviewer):
11
+ Use template at requesting-code-review/code-reviewer.md
12
+
13
+ WHAT_WAS_IMPLEMENTED: [from implementer's report]
14
+ PLAN_OR_REQUIREMENTS: Task N from [plan-file]
15
+ BASE_SHA: [commit before task]
16
+ HEAD_SHA: [current commit]
17
+ DESCRIPTION: [task summary]
18
+ ```
19
+
20
+ **Code reviewer returns:** Strengths, Issues (Critical/Important/Minor), Assessment