@arthai/agents 1.0.0

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 (390) hide show
  1. package/README.md +123 -0
  2. package/VERSION +1 -0
  3. package/agents/ai-consultant.md +999 -0
  4. package/agents/architect.md +174 -0
  5. package/agents/code-reviewer.md +115 -0
  6. package/agents/competitive-analyst.md +688 -0
  7. package/agents/content-strategist.md +607 -0
  8. package/agents/design-studio-create.md +304 -0
  9. package/agents/design-studio-critique.md +258 -0
  10. package/agents/design-studio-think.md +79 -0
  11. package/agents/domain-hunter.md +519 -0
  12. package/agents/explore-light.md +52 -0
  13. package/agents/frontend.md +261 -0
  14. package/agents/gtm-expert.md +811 -0
  15. package/agents/meeting-prep.md +318 -0
  16. package/agents/ops.md +149 -0
  17. package/agents/product-manager.md +563 -0
  18. package/agents/python-backend.md +286 -0
  19. package/agents/qa-baseline-updater.md +45 -0
  20. package/agents/qa-challenger.md +97 -0
  21. package/agents/qa-domain.md +145 -0
  22. package/agents/qa-e2e.md +184 -0
  23. package/agents/qa-test-promoter.md +97 -0
  24. package/agents/qa.md +226 -0
  25. package/agents/setup.md +134 -0
  26. package/agents/sre.md +165 -0
  27. package/agents/stakeholder-reporter.md +94 -0
  28. package/agents/user-researcher.md +602 -0
  29. package/bin/cli.js +322 -0
  30. package/bundles/canvas.json +16 -0
  31. package/bundles/compass.json +16 -0
  32. package/bundles/counsel.json +31 -0
  33. package/bundles/cruise.json +11 -0
  34. package/bundles/forge.json +26 -0
  35. package/bundles/prime.json +10 -0
  36. package/bundles/prism.json +23 -0
  37. package/bundles/scalpel.json +17 -0
  38. package/bundles/sentinel.json +19 -0
  39. package/bundles/shield.json +14 -0
  40. package/bundles/spark.json +19 -0
  41. package/compiler.sh +305 -0
  42. package/dist/plugins/canvas/.claude-plugin/plugin.json +6 -0
  43. package/dist/plugins/canvas/agents/design-studio-create.md +304 -0
  44. package/dist/plugins/canvas/agents/design-studio-critique.md +258 -0
  45. package/dist/plugins/canvas/agents/design-studio-think.md +79 -0
  46. package/dist/plugins/canvas/agents/frontend.md +261 -0
  47. package/dist/plugins/canvas/skills/planning/SKILL.md +436 -0
  48. package/dist/plugins/compass/.claude-plugin/plugin.json +6 -0
  49. package/dist/plugins/compass/agents/content-strategist.md +607 -0
  50. package/dist/plugins/compass/agents/gtm-expert.md +811 -0
  51. package/dist/plugins/compass/agents/product-manager.md +563 -0
  52. package/dist/plugins/compass/agents/user-researcher.md +602 -0
  53. package/dist/plugins/compass/skills/planning/SKILL.md +436 -0
  54. package/dist/plugins/counsel/.claude-plugin/plugin.json +6 -0
  55. package/dist/plugins/counsel/agents/ai-consultant.md +999 -0
  56. package/dist/plugins/counsel/agents/competitive-analyst.md +688 -0
  57. package/dist/plugins/counsel/agents/meeting-prep.md +318 -0
  58. package/dist/plugins/counsel/agents/stakeholder-reporter.md +94 -0
  59. package/dist/plugins/counsel/hooks/check-deliverable.sh +65 -0
  60. package/dist/plugins/counsel/hooks/ensure-client-dir.sh +59 -0
  61. package/dist/plugins/counsel/hooks/hooks.json +28 -0
  62. package/dist/plugins/counsel/skills/client-discovery/SKILL.md +266 -0
  63. package/dist/plugins/counsel/skills/consulting/SKILL.md +282 -0
  64. package/dist/plugins/counsel/skills/deliverable-builder/SKILL.md +928 -0
  65. package/dist/plugins/counsel/skills/engagement-tracker/SKILL.md +380 -0
  66. package/dist/plugins/counsel/skills/market-research/SKILL.md +300 -0
  67. package/dist/plugins/counsel/skills/opportunity-map/SKILL.md +307 -0
  68. package/dist/plugins/counsel/skills/pitch-generator/SKILL.md +378 -0
  69. package/dist/plugins/counsel/skills/roi-calculator/SKILL.md +469 -0
  70. package/dist/plugins/counsel/skills/share/SKILL.md +211 -0
  71. package/dist/plugins/counsel/skills/solution-architect/SKILL.md +566 -0
  72. package/dist/plugins/counsel/skills/templates/SKILL.md +194 -0
  73. package/dist/plugins/counsel/skills/welcome/SKILL.md +136 -0
  74. package/dist/plugins/counsel/skills/wizard/SKILL.md +411 -0
  75. package/dist/plugins/cruise/.claude-plugin/plugin.json +6 -0
  76. package/dist/plugins/cruise/skills/autopilot/SKILL.md +425 -0
  77. package/dist/plugins/forge/.claude-plugin/plugin.json +6 -0
  78. package/dist/plugins/forge/agents/architect.md +174 -0
  79. package/dist/plugins/forge/agents/code-reviewer.md +115 -0
  80. package/dist/plugins/forge/agents/frontend.md +261 -0
  81. package/dist/plugins/forge/agents/product-manager.md +563 -0
  82. package/dist/plugins/forge/agents/python-backend.md +286 -0
  83. package/dist/plugins/forge/agents/qa.md +226 -0
  84. package/dist/plugins/forge/hooks/hooks.json +28 -0
  85. package/dist/plugins/forge/hooks/post-test-summary.sh +115 -0
  86. package/dist/plugins/forge/hooks/triage-router.sh +740 -0
  87. package/dist/plugins/forge/skills/implement/SKILL.md +532 -0
  88. package/dist/plugins/forge/skills/planning/SKILL.md +436 -0
  89. package/dist/plugins/forge/skills/pr/SKILL.md +275 -0
  90. package/dist/plugins/forge/skills/precheck/SKILL.md +159 -0
  91. package/dist/plugins/forge/skills/qa/SKILL.md +127 -0
  92. package/dist/plugins/forge/skills/review-pr/SKILL.md +367 -0
  93. package/dist/plugins/prime/.claude-plugin/plugin.json +6 -0
  94. package/dist/plugins/prime/agents/ai-consultant.md +999 -0
  95. package/dist/plugins/prime/agents/architect.md +174 -0
  96. package/dist/plugins/prime/agents/code-reviewer.md +115 -0
  97. package/dist/plugins/prime/agents/competitive-analyst.md +688 -0
  98. package/dist/plugins/prime/agents/content-strategist.md +607 -0
  99. package/dist/plugins/prime/agents/design-studio-create.md +304 -0
  100. package/dist/plugins/prime/agents/design-studio-critique.md +258 -0
  101. package/dist/plugins/prime/agents/design-studio-think.md +79 -0
  102. package/dist/plugins/prime/agents/explore-light.md +52 -0
  103. package/dist/plugins/prime/agents/frontend.md +261 -0
  104. package/dist/plugins/prime/agents/gtm-expert.md +811 -0
  105. package/dist/plugins/prime/agents/meeting-prep.md +318 -0
  106. package/dist/plugins/prime/agents/ops.md +149 -0
  107. package/dist/plugins/prime/agents/product-manager.md +563 -0
  108. package/dist/plugins/prime/agents/python-backend.md +286 -0
  109. package/dist/plugins/prime/agents/qa-baseline-updater.md +45 -0
  110. package/dist/plugins/prime/agents/qa-challenger.md +97 -0
  111. package/dist/plugins/prime/agents/qa-domain.md +145 -0
  112. package/dist/plugins/prime/agents/qa-e2e.md +184 -0
  113. package/dist/plugins/prime/agents/qa-test-promoter.md +97 -0
  114. package/dist/plugins/prime/agents/qa.md +226 -0
  115. package/dist/plugins/prime/agents/setup.md +134 -0
  116. package/dist/plugins/prime/agents/sre.md +165 -0
  117. package/dist/plugins/prime/agents/stakeholder-reporter.md +94 -0
  118. package/dist/plugins/prime/agents/user-researcher.md +602 -0
  119. package/dist/plugins/prime/hooks/check-deliverable.sh +65 -0
  120. package/dist/plugins/prime/hooks/ensure-client-dir.sh +59 -0
  121. package/dist/plugins/prime/hooks/hooks.json +184 -0
  122. package/dist/plugins/prime/hooks/post-deploy-health.sh +83 -0
  123. package/dist/plugins/prime/hooks/post-diff-test-compare.sh +125 -0
  124. package/dist/plugins/prime/hooks/post-edit-lint.sh +92 -0
  125. package/dist/plugins/prime/hooks/post-git-state.sh +54 -0
  126. package/dist/plugins/prime/hooks/post-merge-cleanup.sh +101 -0
  127. package/dist/plugins/prime/hooks/post-test-summary.sh +115 -0
  128. package/dist/plugins/prime/hooks/pre-bash-guard.sh +142 -0
  129. package/dist/plugins/prime/hooks/pre-edit-guard.sh +121 -0
  130. package/dist/plugins/prime/hooks/pre-task-context.sh +113 -0
  131. package/dist/plugins/prime/hooks/session-bootstrap.sh +379 -0
  132. package/dist/plugins/prime/hooks/session-end.sh +107 -0
  133. package/dist/plugins/prime/hooks/session-summary.sh +97 -0
  134. package/dist/plugins/prime/hooks/sync-agents.sh +269 -0
  135. package/dist/plugins/prime/hooks/triage-router.sh +740 -0
  136. package/dist/plugins/prime/skills/arth/SKILL.md +165 -0
  137. package/dist/plugins/prime/skills/autopilot/SKILL.md +425 -0
  138. package/dist/plugins/prime/skills/calibrate/SKILL.md +1807 -0
  139. package/dist/plugins/prime/skills/ci-fix/SKILL.md +293 -0
  140. package/dist/plugins/prime/skills/client-discovery/SKILL.md +266 -0
  141. package/dist/plugins/prime/skills/consulting/SKILL.md +282 -0
  142. package/dist/plugins/prime/skills/custom-domain/SKILL.md +261 -0
  143. package/dist/plugins/prime/skills/deliverable-builder/SKILL.md +928 -0
  144. package/dist/plugins/prime/skills/discord-ops/SKILL.md +125 -0
  145. package/dist/plugins/prime/skills/engagement-tracker/SKILL.md +380 -0
  146. package/dist/plugins/prime/skills/explore.md +43 -0
  147. package/dist/plugins/prime/skills/fix/SKILL.md +1058 -0
  148. package/dist/plugins/prime/skills/implement/SKILL.md +532 -0
  149. package/dist/plugins/prime/skills/incident/SKILL.md +910 -0
  150. package/dist/plugins/prime/skills/issue/SKILL.md +134 -0
  151. package/dist/plugins/prime/skills/market-research/SKILL.md +300 -0
  152. package/dist/plugins/prime/skills/onboard/SKILL.md +344 -0
  153. package/dist/plugins/prime/skills/opportunity-map/SKILL.md +307 -0
  154. package/dist/plugins/prime/skills/pitch-generator/SKILL.md +378 -0
  155. package/dist/plugins/prime/skills/planning/SKILL.md +436 -0
  156. package/dist/plugins/prime/skills/pr/SKILL.md +275 -0
  157. package/dist/plugins/prime/skills/precheck/SKILL.md +159 -0
  158. package/dist/plugins/prime/skills/qa/SKILL.md +127 -0
  159. package/dist/plugins/prime/skills/qa-incident/SKILL.md +54 -0
  160. package/dist/plugins/prime/skills/qa-learn/SKILL.md +47 -0
  161. package/dist/plugins/prime/skills/restart/SKILL.md +70 -0
  162. package/dist/plugins/prime/skills/review-pr/SKILL.md +367 -0
  163. package/dist/plugins/prime/skills/roi-calculator/SKILL.md +469 -0
  164. package/dist/plugins/prime/skills/scan/SKILL.md +232 -0
  165. package/dist/plugins/prime/skills/setup/SKILL.md +691 -0
  166. package/dist/plugins/prime/skills/share/SKILL.md +211 -0
  167. package/dist/plugins/prime/skills/solution-architect/SKILL.md +566 -0
  168. package/dist/plugins/prime/skills/sre/SKILL.md +362 -0
  169. package/dist/plugins/prime/skills/sync/SKILL.md +188 -0
  170. package/dist/plugins/prime/skills/templates/SKILL.md +194 -0
  171. package/dist/plugins/prime/skills/welcome/SKILL.md +136 -0
  172. package/dist/plugins/prime/skills/wizard/SKILL.md +411 -0
  173. package/dist/plugins/prism/.claude-plugin/plugin.json +6 -0
  174. package/dist/plugins/prism/agents/qa-baseline-updater.md +45 -0
  175. package/dist/plugins/prism/agents/qa-challenger.md +97 -0
  176. package/dist/plugins/prism/agents/qa-domain.md +145 -0
  177. package/dist/plugins/prism/agents/qa-e2e.md +184 -0
  178. package/dist/plugins/prism/agents/qa-test-promoter.md +97 -0
  179. package/dist/plugins/prism/agents/qa.md +226 -0
  180. package/dist/plugins/prism/hooks/hooks.json +26 -0
  181. package/dist/plugins/prism/hooks/post-diff-test-compare.sh +125 -0
  182. package/dist/plugins/prism/hooks/post-test-summary.sh +115 -0
  183. package/dist/plugins/prism/skills/qa/SKILL.md +127 -0
  184. package/dist/plugins/prism/skills/qa-incident/SKILL.md +54 -0
  185. package/dist/plugins/prism/skills/qa-learn/SKILL.md +47 -0
  186. package/dist/plugins/scalpel/.claude-plugin/plugin.json +6 -0
  187. package/dist/plugins/scalpel/agents/code-reviewer.md +115 -0
  188. package/dist/plugins/scalpel/hooks/hooks.json +26 -0
  189. package/dist/plugins/scalpel/hooks/pre-edit-guard.sh +121 -0
  190. package/dist/plugins/scalpel/skills/ci-fix/SKILL.md +293 -0
  191. package/dist/plugins/scalpel/skills/fix/SKILL.md +1058 -0
  192. package/dist/plugins/scalpel/skills/issue/SKILL.md +134 -0
  193. package/dist/plugins/sentinel/.claude-plugin/plugin.json +6 -0
  194. package/dist/plugins/sentinel/agents/ops.md +149 -0
  195. package/dist/plugins/sentinel/agents/sre.md +165 -0
  196. package/dist/plugins/sentinel/hooks/hooks.json +26 -0
  197. package/dist/plugins/sentinel/hooks/post-deploy-health.sh +83 -0
  198. package/dist/plugins/sentinel/hooks/post-git-state.sh +54 -0
  199. package/dist/plugins/sentinel/skills/incident/SKILL.md +910 -0
  200. package/dist/plugins/sentinel/skills/restart/SKILL.md +70 -0
  201. package/dist/plugins/sentinel/skills/sre/SKILL.md +362 -0
  202. package/dist/plugins/shield/.claude-plugin/plugin.json +6 -0
  203. package/dist/plugins/shield/hooks/hooks.json +60 -0
  204. package/dist/plugins/shield/hooks/pre-bash-guard.sh +142 -0
  205. package/dist/plugins/shield/hooks/pre-edit-guard.sh +121 -0
  206. package/dist/plugins/shield/hooks/session-bootstrap.sh +379 -0
  207. package/dist/plugins/shield/hooks/triage-router.sh +740 -0
  208. package/dist/plugins/spark/.claude-plugin/plugin.json +6 -0
  209. package/dist/plugins/spark/agents/explore-light.md +52 -0
  210. package/dist/plugins/spark/agents/setup.md +134 -0
  211. package/dist/plugins/spark/hooks/hooks.json +16 -0
  212. package/dist/plugins/spark/hooks/session-bootstrap.sh +379 -0
  213. package/dist/plugins/spark/skills/calibrate/SKILL.md +1807 -0
  214. package/dist/plugins/spark/skills/onboard/SKILL.md +344 -0
  215. package/dist/plugins/spark/skills/scan/SKILL.md +232 -0
  216. package/dist/plugins/spark/skills/setup/SKILL.md +691 -0
  217. package/hook-defs.json +104 -0
  218. package/hooks/check-deliverable.sh +65 -0
  219. package/hooks/ensure-client-dir.sh +59 -0
  220. package/hooks/hooks.json +16 -0
  221. package/hooks/post-deploy-health.sh +83 -0
  222. package/hooks/post-diff-test-compare.sh +125 -0
  223. package/hooks/post-edit-lint.sh +92 -0
  224. package/hooks/post-git-state.sh +54 -0
  225. package/hooks/post-merge-cleanup.sh +101 -0
  226. package/hooks/post-test-summary.sh +115 -0
  227. package/hooks/pre-bash-guard.sh +142 -0
  228. package/hooks/pre-edit-guard.sh +121 -0
  229. package/hooks/pre-task-context.sh +113 -0
  230. package/hooks/session-bootstrap.sh +379 -0
  231. package/hooks/session-end.sh +107 -0
  232. package/hooks/session-start.sh +46 -0
  233. package/hooks/session-summary.sh +97 -0
  234. package/hooks/sync-agents.sh +269 -0
  235. package/hooks/triage-router.sh +740 -0
  236. package/install.sh +3185 -0
  237. package/package.json +40 -0
  238. package/portable.manifest +112 -0
  239. package/skills/arth/SKILL.md +165 -0
  240. package/skills/autopilot/SKILL.md +425 -0
  241. package/skills/calibrate/SKILL.md +1807 -0
  242. package/skills/ci-fix/SKILL.md +293 -0
  243. package/skills/client-discovery/SKILL.md +266 -0
  244. package/skills/consulting/SKILL.md +282 -0
  245. package/skills/continue/SKILL.md +174 -0
  246. package/skills/custom-domain/SKILL.md +261 -0
  247. package/skills/deliverable-builder/SKILL.md +928 -0
  248. package/skills/discord-ops/SKILL.md +125 -0
  249. package/skills/engagement-tracker/SKILL.md +380 -0
  250. package/skills/explore.md +43 -0
  251. package/skills/fix/SKILL.md +1058 -0
  252. package/skills/implement/SKILL.md +532 -0
  253. package/skills/incident/SKILL.md +910 -0
  254. package/skills/issue/SKILL.md +134 -0
  255. package/skills/market-research/SKILL.md +300 -0
  256. package/skills/onboard/SKILL.md +344 -0
  257. package/skills/opportunity-map/SKILL.md +307 -0
  258. package/skills/pitch-generator/SKILL.md +378 -0
  259. package/skills/planning/SKILL.md +436 -0
  260. package/skills/pr/SKILL.md +275 -0
  261. package/skills/precheck/SKILL.md +159 -0
  262. package/skills/qa/SKILL.md +127 -0
  263. package/skills/qa-incident/SKILL.md +54 -0
  264. package/skills/qa-learn/SKILL.md +47 -0
  265. package/skills/railway/central-station/SKILL.md +226 -0
  266. package/skills/railway/central-station/references/environment-config.md +183 -0
  267. package/skills/railway/central-station/references/monorepo.md +216 -0
  268. package/skills/railway/central-station/references/railpack.md +257 -0
  269. package/skills/railway/central-station/references/variables.md +170 -0
  270. package/skills/railway/database/SKILL.md +284 -0
  271. package/skills/railway/database/references/environment-config.md +183 -0
  272. package/skills/railway/database/references/monorepo.md +216 -0
  273. package/skills/railway/database/references/railpack.md +257 -0
  274. package/skills/railway/database/references/variables.md +170 -0
  275. package/skills/railway/database/scripts/railway-api.sh +41 -0
  276. package/skills/railway/deploy/SKILL.md +128 -0
  277. package/skills/railway/deploy/references/environment-config.md +183 -0
  278. package/skills/railway/deploy/references/monorepo.md +216 -0
  279. package/skills/railway/deploy/references/railpack.md +257 -0
  280. package/skills/railway/deploy/references/variables.md +170 -0
  281. package/skills/railway/deployment/SKILL.md +222 -0
  282. package/skills/railway/deployment/references/environment-config.md +183 -0
  283. package/skills/railway/deployment/references/monorepo.md +216 -0
  284. package/skills/railway/deployment/references/railpack.md +257 -0
  285. package/skills/railway/deployment/references/variables.md +170 -0
  286. package/skills/railway/domain/SKILL.md +137 -0
  287. package/skills/railway/domain/references/environment-config.md +183 -0
  288. package/skills/railway/domain/references/monorepo.md +216 -0
  289. package/skills/railway/domain/references/railpack.md +257 -0
  290. package/skills/railway/domain/references/variables.md +170 -0
  291. package/skills/railway/environment/SKILL.md +266 -0
  292. package/skills/railway/environment/references/environment-config.md +183 -0
  293. package/skills/railway/environment/references/monorepo.md +216 -0
  294. package/skills/railway/environment/references/railpack.md +257 -0
  295. package/skills/railway/environment/references/variables.md +170 -0
  296. package/skills/railway/metrics/SKILL.md +211 -0
  297. package/skills/railway/metrics/references/environment-config.md +183 -0
  298. package/skills/railway/metrics/references/monorepo.md +216 -0
  299. package/skills/railway/metrics/references/railpack.md +257 -0
  300. package/skills/railway/metrics/references/variables.md +170 -0
  301. package/skills/railway/metrics/scripts/railway-api.sh +41 -0
  302. package/skills/railway/new/SKILL.md +489 -0
  303. package/skills/railway/new/references/environment-config.md +183 -0
  304. package/skills/railway/new/references/monorepo.md +216 -0
  305. package/skills/railway/new/references/railpack.md +257 -0
  306. package/skills/railway/new/references/variables.md +170 -0
  307. package/skills/railway/projects/SKILL.md +142 -0
  308. package/skills/railway/projects/references/environment-config.md +183 -0
  309. package/skills/railway/projects/references/monorepo.md +216 -0
  310. package/skills/railway/projects/references/railpack.md +257 -0
  311. package/skills/railway/projects/references/variables.md +170 -0
  312. package/skills/railway/projects/scripts/railway-api.sh +41 -0
  313. package/skills/railway/railway-docs/SKILL.md +47 -0
  314. package/skills/railway/railway-docs/references/environment-config.md +183 -0
  315. package/skills/railway/railway-docs/references/monorepo.md +216 -0
  316. package/skills/railway/railway-docs/references/railpack.md +257 -0
  317. package/skills/railway/railway-docs/references/variables.md +170 -0
  318. package/skills/railway/service/SKILL.md +249 -0
  319. package/skills/railway/service/references/environment-config.md +183 -0
  320. package/skills/railway/service/references/monorepo.md +216 -0
  321. package/skills/railway/service/references/railpack.md +257 -0
  322. package/skills/railway/service/references/variables.md +170 -0
  323. package/skills/railway/service/scripts/railway-api.sh +41 -0
  324. package/skills/railway/status/SKILL.md +91 -0
  325. package/skills/railway/status/references/environment-config.md +183 -0
  326. package/skills/railway/status/references/monorepo.md +216 -0
  327. package/skills/railway/status/references/railpack.md +257 -0
  328. package/skills/railway/status/references/variables.md +170 -0
  329. package/skills/railway/templates/SKILL.md +275 -0
  330. package/skills/railway/templates/references/environment-config.md +183 -0
  331. package/skills/railway/templates/references/monorepo.md +216 -0
  332. package/skills/railway/templates/references/railpack.md +257 -0
  333. package/skills/railway/templates/references/variables.md +170 -0
  334. package/skills/railway/templates/scripts/railway-api.sh +41 -0
  335. package/skills/restart/SKILL.md +70 -0
  336. package/skills/review-pr/SKILL.md +367 -0
  337. package/skills/roi-calculator/SKILL.md +469 -0
  338. package/skills/scan/SKILL.md +232 -0
  339. package/skills/setup/SKILL.md +691 -0
  340. package/skills/share/SKILL.md +211 -0
  341. package/skills/solution-architect/SKILL.md +566 -0
  342. package/skills/sre/SKILL.md +362 -0
  343. package/skills/superpowers/brainstorming/SKILL.md +96 -0
  344. package/skills/superpowers/dispatching-parallel-agents/SKILL.md +180 -0
  345. package/skills/superpowers/executing-plans/SKILL.md +84 -0
  346. package/skills/superpowers/finishing-a-development-branch/SKILL.md +200 -0
  347. package/skills/superpowers/receiving-code-review/SKILL.md +213 -0
  348. package/skills/superpowers/requesting-code-review/SKILL.md +105 -0
  349. package/skills/superpowers/requesting-code-review/code-reviewer.md +146 -0
  350. package/skills/superpowers/subagent-driven-development/SKILL.md +242 -0
  351. package/skills/superpowers/subagent-driven-development/code-quality-reviewer-prompt.md +20 -0
  352. package/skills/superpowers/subagent-driven-development/implementer-prompt.md +78 -0
  353. package/skills/superpowers/subagent-driven-development/spec-reviewer-prompt.md +61 -0
  354. package/skills/superpowers/systematic-debugging/CREATION-LOG.md +119 -0
  355. package/skills/superpowers/systematic-debugging/SKILL.md +296 -0
  356. package/skills/superpowers/systematic-debugging/condition-based-waiting-example.ts +158 -0
  357. package/skills/superpowers/systematic-debugging/condition-based-waiting.md +115 -0
  358. package/skills/superpowers/systematic-debugging/defense-in-depth.md +122 -0
  359. package/skills/superpowers/systematic-debugging/find-polluter.sh +63 -0
  360. package/skills/superpowers/systematic-debugging/root-cause-tracing.md +169 -0
  361. package/skills/superpowers/systematic-debugging/test-academic.md +14 -0
  362. package/skills/superpowers/systematic-debugging/test-pressure-1.md +58 -0
  363. package/skills/superpowers/systematic-debugging/test-pressure-2.md +68 -0
  364. package/skills/superpowers/systematic-debugging/test-pressure-3.md +69 -0
  365. package/skills/superpowers/test-driven-development/SKILL.md +371 -0
  366. package/skills/superpowers/test-driven-development/testing-anti-patterns.md +299 -0
  367. package/skills/superpowers/using-git-worktrees/SKILL.md +218 -0
  368. package/skills/superpowers/using-superpowers/SKILL.md +95 -0
  369. package/skills/superpowers/verification-before-completion/SKILL.md +139 -0
  370. package/skills/superpowers/writing-plans/SKILL.md +116 -0
  371. package/skills/superpowers/writing-skills/SKILL.md +655 -0
  372. package/skills/superpowers/writing-skills/anthropic-best-practices.md +1150 -0
  373. package/skills/superpowers/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  374. package/skills/superpowers/writing-skills/graphviz-conventions.dot +172 -0
  375. package/skills/superpowers/writing-skills/persuasion-principles.md +187 -0
  376. package/skills/superpowers/writing-skills/render-graphs.js +168 -0
  377. package/skills/superpowers/writing-skills/testing-skills-with-subagents.md +384 -0
  378. package/skills/sync/SKILL.md +188 -0
  379. package/skills/templates/SKILL.md +194 -0
  380. package/skills/welcome/SKILL.md +136 -0
  381. package/skills/wizard/SKILL.md +411 -0
  382. package/templates/CLAUDE.md.managed-block +123 -0
  383. package/templates/CLAUDE.md.template +111 -0
  384. package/templates/consulting/engagement-tracker-template.md +181 -0
  385. package/templates/consulting/executive-summary-template.md +83 -0
  386. package/templates/consulting/maturity-assessment-template.md +182 -0
  387. package/templates/consulting/proposal-template.md +209 -0
  388. package/templates/consulting/roi-model-template.md +139 -0
  389. package/templates/consulting/solution-architecture-template.md +313 -0
  390. package/templates/settings.json +130 -0
@@ -0,0 +1,411 @@
1
+ ---
2
+ name: wizard
3
+ description: "Guided step-by-step workflows for non-engineers. Role-based flows that walk you through common tasks. Usage: /wizard <role> <step>"
4
+ user-invocable: true
5
+ arguments: "<role> <step>"
6
+ ---
7
+
8
+ Guided workflows that walk non-engineers through multi-step processes. Each workflow is designed
9
+ for a specific role and breaks complex tasks into manageable steps, bringing in the right
10
+ specialist at each stage.
11
+
12
+ ## Argument Parsing
13
+
14
+ | Input | Action |
15
+ |---|---|
16
+ | `/wizard` | Detect role or ask, then show available workflows |
17
+ | `/wizard pm` | Show PM workflow steps |
18
+ | `/wizard pm 1` | Jump to PM workflow step 1 |
19
+ | `/wizard pm next` | Continue to next incomplete step |
20
+ | `/wizard founder` | Show Founder workflow steps |
21
+ | `/wizard designer` | Show Designer workflow steps |
22
+ | `/wizard marketer` | Show Marketer workflow steps |
23
+ | `/wizard status` | Show progress across all workflows |
24
+ | `/wizard resume` | Resume where you left off |
25
+ | `/wizard reset` | Clear saved progress and start fresh |
26
+
27
+ ## Role Detection
28
+
29
+ Check `.claude/.claude-agents.conf` for `USER_ROLE`. If not set, present this menu using AskUserQuestion:
30
+
31
+ ```
32
+ What best describes your role?
33
+ 1. Product Manager — I plan features and prioritize what to build
34
+ 2. Founder — I oversee everything from vision to shipping
35
+ 3. Designer — I design experiences and visual interfaces
36
+ 4. Marketer — I position products and drive awareness
37
+
38
+ Pick the one closest to your work.
39
+ ```
40
+
41
+ ## State Management
42
+
43
+ Progress is saved in `.claude/.wizard-state.json` so you can resume across sessions.
44
+
45
+ **State schema:**
46
+ ```json
47
+ {
48
+ "role": "pm",
49
+ "active_workflow": "plan-and-ship",
50
+ "current_step": 2,
51
+ "steps_completed": [1],
52
+ "step_outputs": {
53
+ "1": {
54
+ "summary": "Feature brief for user notifications",
55
+ "file": ".claude/plans/notifications-brief.md"
56
+ }
57
+ },
58
+ "started_at": "2026-03-23T10:00:00Z",
59
+ "last_active": "2026-03-23T14:30:00Z"
60
+ }
61
+ ```
62
+
63
+ **State operations:**
64
+ - Read state at the start of every `/wizard` invocation
65
+ - Write state after every step completion
66
+ - On `/wizard resume`: read state, show summary, continue from `current_step`
67
+ - On `/wizard reset`: delete `.claude/.wizard-state.json`
68
+ - On `/wizard status`: read state, show progress table
69
+
70
+ ---
71
+
72
+ ## Workflow 1: Product Manager — "Plan and Ship a Feature"
73
+
74
+ Present this overview when the PM role is selected:
75
+
76
+ ```
77
+ Plan and Ship a Feature
78
+ ═══════════════════════
79
+
80
+ This workflow walks you through taking an idea from concept to launch:
81
+
82
+ Step 1: Describe Your Idea ← Tell us what you want to build
83
+ Step 2: Understand Your Users ← Learn who needs this and why
84
+ Step 3: Write the Plan ← Create a detailed plan for the team
85
+ Step 4: Create a Launch Plan ← Figure out how to tell people about it
86
+ Step 5: Track Progress ← See how things are going
87
+
88
+ You can do these in order, skip ahead, or come back later.
89
+ Which step would you like to start with?
90
+ ```
91
+
92
+ ### Step 1: Describe Your Idea
93
+
94
+ **What happens:** You describe the feature or product idea in your own words. A specialist helps turn it into a structured brief.
95
+
96
+ **Execution:**
97
+ 1. Ask the user: "What do you want to build? Describe it in a few sentences — who it helps and what problem it solves."
98
+ 2. Read CLAUDE.md for project context
99
+ 3. Spawn the `product-manager` agent with:
100
+ > Write a product brief for: {user's description}
101
+ > Project context: {CLAUDE.md content}
102
+ > Structure with: Problem statement, Target user, Desired outcome, Success metrics, Scope, Open questions.
103
+ > Write in plain language. Under 500 words.
104
+ 4. Save the brief output to `.claude/plans/{topic}-brief.md`
105
+ 5. Update state: step 1 complete, save file reference
106
+
107
+ **After completion:**
108
+ ```
109
+ Your feature brief is ready!
110
+
111
+ Here's a quick summary: [2-sentence summary of the brief]
112
+
113
+ What would you like to do?
114
+ - "next" to move on to understanding your users
115
+ - "revise" to change something in the brief
116
+ - "share this" to send the brief to your team
117
+ - "save and stop" to come back later
118
+ ```
119
+
120
+ ### Step 2: Understand Your Users
121
+
122
+ **What happens:** A research specialist analyzes who needs this feature and what they struggle with, using your brief from Step 1 as context.
123
+
124
+ **Execution:**
125
+ 1. Read Step 1 output (brief) for context
126
+ 2. Spawn the `user-researcher` agent with:
127
+ > Based on this product brief: {brief content}
128
+ > Generate 2-3 behavior-based user personas who would benefit from this feature.
129
+ > For each persona: behavior pattern, motivation (functional/emotional/social jobs), current pain, trigger, and what success looks like.
130
+ > Also identify the top 3 assumptions we should validate before building.
131
+ 3. Save output to state
132
+
133
+ **After completion:**
134
+ ```
135
+ User research is ready! Here's what we found:
136
+
137
+ [1-sentence summary of key personas and insights]
138
+
139
+ What would you like to do?
140
+ - "next" to write the full plan
141
+ - "revise" to adjust the research
142
+ - "share this" to send to your team
143
+ - "save and stop" to come back later
144
+ ```
145
+
146
+ ### Step 3: Write the Plan
147
+
148
+ **What happens:** A planning team creates a detailed implementation plan using your brief and user research.
149
+
150
+ **Execution:**
151
+ 1. Read Step 1 (brief) and Step 2 (research) outputs
152
+ 2. Invoke `/planning {topic}` with context from previous steps injected
153
+ 3. The planning skill spawns its own team (PM + Architect) to create the plan
154
+ 4. Save plan output to state
155
+
156
+ **After completion:**
157
+ ```
158
+ Your implementation plan is ready!
159
+
160
+ The team created: [brief summary — scope, timeline, key decisions]
161
+
162
+ What would you like to do?
163
+ - "next" to plan how to launch this
164
+ - "revise" to change the plan
165
+ - "share this" to send to your team
166
+ - "save and stop" to come back later
167
+ ```
168
+
169
+ ### Step 4: Create a Launch Plan
170
+
171
+ **What happens:** A go-to-market specialist creates a launch plan for your feature.
172
+
173
+ **Execution:**
174
+ 1. Read Step 1 (brief) and Step 2 (research) for context
175
+ 2. Spawn the `gtm-expert` agent with:
176
+ > Create a launch plan for: {topic}
177
+ > Product brief: {brief content}
178
+ > Target users: {persona summaries from step 2}
179
+ > Structure with: What's launching, Who it's for, Positioning, Channels, Timeline (4 weeks), Success metrics, Risks.
180
+ > Write in plain language. Under 600 words.
181
+ 3. Save output to state
182
+
183
+ ### Step 5: Track Progress
184
+
185
+ **What happens:** A status specialist reads the project's actual data and generates a progress report.
186
+
187
+ **Execution:**
188
+ 1. Spawn the `stakeholder-reporter` agent with:
189
+ > Generate a project status report focused on: {topic from step 1}
190
+ > Context: we planned this feature in [date]. Here's what the plan included: {brief summary}
191
+ > Read git history, PRs, and issues to report on progress.
192
+ 2. Save output to state
193
+
194
+ **After completion:**
195
+ ```
196
+ Here's your project status! [summary]
197
+
198
+ You've completed all 5 steps of the Plan and Ship workflow.
199
+
200
+ What would you like to do?
201
+ - "share this" to send the status to your team
202
+ - "start over" to plan a new feature
203
+ - "run step 5 again" to get a fresh status update later
204
+ ```
205
+
206
+ ---
207
+
208
+ ## Workflow 2: Founder — "Build and Ship"
209
+
210
+ ```
211
+ Build and Ship
212
+ ══════════════
213
+
214
+ This workflow takes you from vision to launched product:
215
+
216
+ Step 1: Describe Your Vision ← What are you building and why?
217
+ Step 2: Research the Market ← Who else is doing this? What's your edge?
218
+ Step 3: Plan the Build ← Turn vision into a concrete plan
219
+ Step 4: Build It ← Get the team building
220
+ Step 5: Ship and Learn ← Launch and see what happens
221
+
222
+ Which step would you like to start with?
223
+ ```
224
+
225
+ ### Step 1: Describe Your Vision
226
+ - Ask: "What are you building? Who is it for? Why does the world need it?"
227
+ - Spawn `product-manager` with product vision template prompt
228
+ - Save vision document to state
229
+
230
+ ### Step 2: Research the Market
231
+ - Read Step 1 (vision) for context
232
+ - Spawn `competitive-analyst` with:
233
+ > Research the competitive landscape for: {vision summary}
234
+ > Identify direct competitors, indirect competitors, and potential entrants.
235
+ > Run a Strategy Canvas and 7 Powers analysis on the top 3 competitors.
236
+ > What is the blue ocean opportunity?
237
+ - Save competitive intelligence to state
238
+
239
+ ### Step 3: Plan the Build
240
+ - Read Steps 1-2 for context
241
+ - Invoke `/planning {topic}` with vision + competitive context
242
+ - Save plan to state
243
+
244
+ ### Step 4: Build It
245
+ - Read Step 3 (plan) for context
246
+ - Invoke `/implement {topic}` with plan context
247
+ - Save implementation progress to state
248
+
249
+ ### Step 5: Ship and Learn
250
+ - Read Steps 1-2 for context
251
+ - Spawn `gtm-expert` for launch plan based on competitive intelligence
252
+ - Spawn `stakeholder-reporter` for current project status
253
+ - Present both outputs together
254
+
255
+ ---
256
+
257
+ ## Workflow 3: Designer — "Design, Validate, Ship"
258
+
259
+ ```
260
+ Design, Validate, Ship
261
+ ══════════════════════
262
+
263
+ This workflow guides you through a complete design cycle:
264
+
265
+ Step 1: Define the Challenge ← What problem is this design solving?
266
+ Step 2: Get Expert Critique ← Honest feedback from design principles
267
+ Step 3: Iterate ← Refine based on feedback
268
+ Step 4: Plan Implementation ← Turn the design into a build plan
269
+ Step 5: Review Final Result ← Check the build against the original intent
270
+
271
+ Which step would you like to start with?
272
+ ```
273
+
274
+ ### Step 1: Define the Challenge
275
+ - Ask: "What design problem are you trying to solve? Who is the user and what should they be able to do?"
276
+ - Spawn `design-studio-think` with design thinking prompt
277
+ - Save design brief to state
278
+
279
+ ### Step 2: Get Expert Critique
280
+ - Ask for the design to critique (URL, screenshot path, or description)
281
+ - Spawn `design-studio-critique` with design brief context from Step 1
282
+ - Save critique to state
283
+
284
+ ### Step 3: Iterate
285
+ - Read Steps 1-2 (brief + critique) for context
286
+ - Spawn `design-studio-create` with:
287
+ > Based on this design challenge: {brief}
288
+ > And this critique feedback: {critique summary}
289
+ > Create an improved design that addresses the top recommendations.
290
+ - Save iteration output to state
291
+
292
+ ### Step 4: Plan Implementation
293
+ - Read Steps 1-3 for context
294
+ - Invoke `/planning --design {topic}` with design brief and iteration context
295
+ - Save plan to state
296
+
297
+ ### Step 5: Review Final Result
298
+ - Ask: "Has the design been implemented? Point me to what to review."
299
+ - Spawn `design-studio-critique` for final review against original brief from Step 1
300
+ - Compare: does the implementation match the design intent?
301
+
302
+ ---
303
+
304
+ ## Workflow 4: Marketer — "Research, Position, Launch"
305
+
306
+ ```
307
+ Research, Position, Launch
308
+ ═════════════════════════
309
+
310
+ This workflow guides you from market research to launch execution:
311
+
312
+ Step 1: Understand the Landscape ← Who are the competitors and what's our edge?
313
+ Step 2: Define Positioning ← How do we describe what we do and for whom?
314
+ Step 3: Create Content ← Blog posts, copy, and marketing materials
315
+ Step 4: Plan the Launch ← Week-by-week launch execution plan
316
+ Step 5: Measure Results ← How did it go? What's next?
317
+
318
+ Which step would you like to start with?
319
+ ```
320
+
321
+ ### Step 1: Understand the Landscape
322
+ - Ask: "What product or feature are we marketing? Who do you think the competitors are?"
323
+ - Spawn `competitive-analyst` with competitive intelligence gathering protocol
324
+ - Save landscape analysis to state
325
+
326
+ ### Step 2: Define Positioning
327
+ - Read Step 1 (landscape) for context
328
+ - Spawn `gtm-expert` with:
329
+ > Based on this competitive landscape: {landscape summary}
330
+ > Complete a Positioning Canvas for: {product}
331
+ > Identify: competitive alternatives, unique attributes, value, target customers, market category.
332
+ > Write the positioning statement.
333
+ - Save positioning to state
334
+
335
+ ### Step 3: Create Content
336
+ - Read Steps 1-2 (landscape + positioning) for context
337
+ - Spawn `content-strategist` with:
338
+ > Based on this positioning: {positioning statement}
339
+ > And this competitive landscape: {key findings}
340
+ > Create: 1 blog post draft, 3 social media posts (Twitter/LinkedIn), and 1 product announcement.
341
+ > Ground all content in real product capabilities (read CLAUDE.md and codebase).
342
+ > Use the PAS framework for the blog post and AIDA for social.
343
+ - Save content drafts to state
344
+
345
+ ### Step 4: Plan the Launch
346
+ - Read Steps 1-3 for full context
347
+ - Spawn `gtm-expert` for a full launch plan with GACC brief
348
+ - Save launch plan to state
349
+
350
+ ### Step 5: Measure Results
351
+ - Spawn `stakeholder-reporter` for project status
352
+ - Present status alongside launch plan metrics from Step 4
353
+ - Suggest: what to double down on, what to adjust
354
+
355
+ ---
356
+
357
+ ## Step Execution Protocol
358
+
359
+ For every step in every workflow, follow this protocol:
360
+
361
+ 1. **Read state** from `.claude/.wizard-state.json`
362
+ 2. **Check prerequisites** — if previous steps have outputs, load them as context
363
+ 3. **Present what this step does** in plain language before executing
364
+ 4. **Confirm** — "Ready to start? Or would you like to skip this step?"
365
+ 5. **Execute** — spawn the appropriate agent/skill with full context
366
+ 6. **Save output** to state (summary + file reference if applicable)
367
+ 7. **Present results** with a brief summary
368
+ 8. **Offer next actions:**
369
+ ```
370
+ What would you like to do?
371
+ - "next" to continue to [next step name]
372
+ - "revise" to redo this step with changes
373
+ - "share this" to format for your team
374
+ - "save and stop" to come back later
375
+ - "skip to step [N]" to jump ahead
376
+ ```
377
+
378
+ ## Resume Protocol
379
+
380
+ On `/wizard resume`:
381
+ 1. Read `.claude/.wizard-state.json`
382
+ 2. If no state exists: "No workflow in progress. Type /wizard to start one."
383
+ 3. If state exists, present:
384
+ ```
385
+ Welcome back! You're working on: [workflow name]
386
+ Role: [role]
387
+ Started: [date]
388
+
389
+ Progress:
390
+ ✓ Step 1: [name] — [summary]
391
+ ✓ Step 2: [name] — [summary]
392
+ → Step 3: [name] — not started yet
393
+ Step 4: [name]
394
+ Step 5: [name]
395
+
396
+ Ready to continue with Step 3: [name]?
397
+ ```
398
+
399
+ ## Rules
400
+
401
+ - Never show agent names — say "bringing in a specialist" or "running analysis"
402
+ - Never show model names or cost tiers
403
+ - Never show slash command syntax — all interaction is natural language
404
+ - All text must be in everyday language — no jargon, no technical terms
405
+ - Always save state before spawning agents (crash recovery)
406
+ - Always offer "save and stop" at every checkpoint — respect the user's time
407
+ - Pass context from previous steps to every agent invocation — continuity is critical
408
+ - If a step fails, explain what happened in plain English and offer to retry
409
+ - Keep step summaries under 2 sentences — the full output is always available
410
+ - The user can do steps out of order — warn but don't block
411
+ - Each step should complete in under 60 seconds
@@ -0,0 +1,123 @@
1
+ ## Engineering Principles (MANDATORY — applies to ALL work)
2
+
3
+ ### Research Before Fixing
4
+ - **Never guess.** Before changing code, read the relevant source files, docs, and configs.
5
+ - Understand WHY something is broken before attempting a fix.
6
+ - If your first fix doesn't work, STOP. Don't try another guess. Re-read the code.
7
+ - Use explore-light (Haiku, 1x cost) to scan the codebase before expensive agents investigate.
8
+
9
+ ### No Over-Engineering
10
+ - **Do exactly what's needed.** Don't add abstractions, utilities, or frameworks unless the code already uses them.
11
+ - Match existing patterns — run explore-light to find how similar code is structured before writing new code.
12
+ - A bug fix touches the minimum files possible. A feature matches the existing architecture.
13
+ - If you're creating a new class/helper/utility that nothing else in the codebase uses, you're over-engineering.
14
+
15
+ ### Test Before Shipping
16
+ - **Run tests locally before pushing.** Never push untested code.
17
+ - If the project has `/precheck`, run it. If it has `/qa`, run it in commit mode.
18
+ - After fixing a bug, verify the fix AND verify nothing else broke (differential testing).
19
+ - If 3+ consecutive fix attempts fail, STOP. Step back and reassess the root cause from scratch.
20
+
21
+ ### Deployment Safety
22
+ - **Never modify production systems without explicit confirmation.**
23
+ - Don't change deploy targets, CI pipeline structure, or infrastructure config silently.
24
+ - Don't overwrite existing files during deployment without asking.
25
+ - If a deployment breaks something, investigate before attempting to fix. Don't cascade.
26
+
27
+ ## Toolkit Awareness (MANDATORY — READ THIS FIRST)
28
+
29
+ You have a **claude-agents toolkit** installed in this project. It provides specialized
30
+ agents, skills, and hooks that handle domain-specific work better and cheaper.
31
+
32
+ **You are the ORCHESTRATOR.** The triage router fires on every message with a routing
33
+ table and SPEED score. Use it to decide: toolkit or you?
34
+
35
+ ### When to use the toolkit (SPEED score 2+):
36
+ - **Multi-step workflows**: `/pr`, `/deploy`, `/planning`, `/implement`, `/qa`, `/ci-fix`
37
+ encode battle-tested sequences you'd otherwise do manually and forget steps
38
+ - **Domain expertise**: SRE, QA, frontend, backend agents have project context baked in
39
+ - **Cost savings**: Haiku/Sonnet agents handle 80% of tasks at 1/60th the cost of Opus
40
+ - **Parallelism**: Team skills spawn multiple agents working simultaneously
41
+
42
+ ### When to use YOU directly (SPEED score 0-1):
43
+ - **Quick lookups**: Read/Grep/Glob for finding a file, checking a value, reading code
44
+ - **Small targeted edits**: 1-2 file changes where you already know what to do
45
+ - **Complex reasoning**: Architecture decisions, debugging novel problems, nuanced tradeoffs
46
+ - **Conversation flow**: Follow-up questions, clarifications, explaining code
47
+ - **Creative problem-solving**: When the task doesn't fit any existing pattern
48
+ - **Judgment calls**: Security reviews, design decisions, "should we even do this?"
49
+
50
+ ### The balance:
51
+ The toolkit handles **process** (repeatable workflows, domain-specific checks, multi-step
52
+ sequences). You handle **judgment** (reasoning, creativity, novel problems, architecture).
53
+
54
+ A senior engineer doesn't do everything themselves — they delegate routine work and focus
55
+ their expertise where it matters most. That's you. The toolkit is your team.
56
+
57
+ **Don't over-delegate**: If it's faster to just Read a file and answer, do it.
58
+ **Don't under-delegate**: If it's a 5-step workflow the toolkit has a skill for, use it.
59
+
60
+ ### Project Knowledge System
61
+
62
+ If this project has been calibrated (`/calibrate`), deep context is available:
63
+
64
+ - **`.claude/project-profile.md`** — Architecture patterns, coding conventions, domain model,
65
+ testing style. Read this before writing any code to match the project's patterns.
66
+ - **`.claude/knowledge/`** — The toolkit's long-term memory for this project:
67
+ - `shared/conventions.md` — Coding rules learned from corrections. **Read before writing code.**
68
+ - `shared/domain.md` — Business rules beyond what's in the code. **Read before domain decisions.**
69
+ - `shared/vocabulary.md` — What the team calls things. **Use these terms.**
70
+ - `shared/patterns.md` — Architecture patterns. **Follow these when adding new code.**
71
+ - `agents/{your-name}.md` — Your past learning. **Read on session start.**
72
+ - **Write back** when you learn something new — corrections, discoveries, decisions.
73
+ - See `knowledge/README.md` for the full protocol.
74
+ - **`.claude/knowledge/external/sources.md`** — Where team knowledge lives outside code
75
+ (Notion, Linear, Figma, etc.). Check before making decisions that might already be documented.
76
+
77
+ ## Session Start Behavior (MANDATORY)
78
+
79
+ On your FIRST response in every new session, ALWAYS start with a brief status line
80
+ using context from the SessionStart hook. Include:
81
+ - Current branch + uncommitted file count
82
+ - Docker/infra status (if problems detected)
83
+ - Open PRs or assigned issues (if any)
84
+ - Any red flags (pending migrations, expired tokens)
85
+
86
+ Format: 1-3 compact lines before addressing the user's request. Example:
87
+ ```
88
+ 📋 project — main | 5 uncommitted | Docker: postgres ✓ redis ✓ | 2 open PRs
89
+ ```
90
+ Then proceed with the user's actual request.
91
+
92
+ **CRITICAL — Greetings and vague first messages**: If the user's first message is a
93
+ greeting ("hey", "hi", "hello", "yo", "sup") or vague ("help", "what's up",
94
+ "what should I work on") or ANY message under 5 words with no specific task —
95
+ **ALWAYS use the `/onboard` skill**. Never respond to greetings yourself. The
96
+ bootstrap hook status line is a quick snapshot — `/onboard` gives the real briefing
97
+ with open PRs, issues, priorities, and actionable next steps.
98
+
99
+ ## Routing Trace (MANDATORY)
100
+
101
+ On EVERY response, show a compact routing trace so the user understands the decision
102
+ path. Place it at the end of your response in a dimmed block:
103
+
104
+ ```
105
+ 🔀 Routing: [what triage decided] → [agent/skill/tool used] ([cost tier])
106
+ Why: [1-line reason for this routing choice]
107
+ ```
108
+
109
+ Examples:
110
+ ```
111
+ 🔀 Routing: backend bug fix → python-backend agent (Sonnet, 10x)
112
+ Why: touches backend/app/services/, needs CLAUDE.md context, SPEED=4
113
+ ```
114
+ ```
115
+ 🔀 Routing: file lookup → Grep (built-in, 0x)
116
+ Why: single-file search, no project context needed, SPEED=0
117
+ ```
118
+
119
+ Rules:
120
+ - Always show the SPEED score breakdown if score >= 2
121
+ - Show which hook provided the context (triage-router, bootstrap, etc.)
122
+ - If you chose NOT to use the triage router's suggestion, explain why
123
+ - Skip the trace only for simple follow-up messages in an ongoing conversation
@@ -0,0 +1,111 @@
1
+ # CLAUDE.md — {{PROJECT_NAME}}
2
+
3
+ <!-- Generated by claude-agents install.sh --init -->
4
+ <!-- TODO: Replace {{placeholders}} with your project details -->
5
+
6
+ ## Project Overview
7
+
8
+ {{PROJECT_NAME}} is a {{DESCRIPTION}}.
9
+
10
+ ## Tech Stack
11
+
12
+ - **Frontend**: <!-- TODO: e.g., Next.js 14, React 18, TypeScript, Tailwind -->
13
+ - **Backend**: <!-- TODO: e.g., FastAPI, SQLAlchemy, PostgreSQL -->
14
+ - **Auth**: <!-- TODO: e.g., Stytch, Auth0, Clerk -->
15
+ - **Deploy**: <!-- TODO: e.g., Railway, Vercel, AWS -->
16
+
17
+ ## Project Structure
18
+
19
+ ```
20
+ {{PROJECT_NAME}}/
21
+ ├── frontend/ <!-- TODO: Frontend directory -->
22
+ ├── backend/ <!-- TODO: Backend directory -->
23
+ └── ...
24
+ ```
25
+
26
+ ## Key Architecture
27
+
28
+ <!-- TODO: Describe your auth flow, API patterns, database schema, etc. -->
29
+
30
+ ## Local Dev Services
31
+
32
+ <!-- TODO: Auto-populated by /scan or fill manually -->
33
+
34
+ | Service | Port | Directory | Start Command |
35
+ |----------|------|-----------|---------------|
36
+ | Frontend | <!-- TODO --> | frontend/ | <!-- TODO: e.g., npm run dev --> |
37
+ | Backend | <!-- TODO --> | backend/ | <!-- TODO: e.g., uvicorn app.main:app --reload --> |
38
+
39
+ ## Test Commands
40
+
41
+ <!-- TODO: Auto-populated by /scan or fill manually -->
42
+
43
+ | What | Command | Directory |
44
+ |------|---------|-----------|
45
+ | Backend tests | <!-- TODO: e.g., pytest --> | backend/ |
46
+ | Backend lint | <!-- TODO: e.g., ruff check . --> | backend/ |
47
+ | Frontend tests | <!-- TODO: e.g., npm test --> | frontend/ |
48
+ | Frontend lint | <!-- TODO: e.g., npm run lint --> | frontend/ |
49
+ | Type check | <!-- TODO: e.g., npx tsc --noEmit --> | frontend/ |
50
+ | E2E tests | <!-- TODO: e.g., npx playwright test --> | frontend/ |
51
+
52
+ ## Infrastructure
53
+
54
+ <!-- TODO: Auto-populated by /scan or fill manually -->
55
+
56
+ | Platform | Service | Domain |
57
+ |----------|---------|--------|
58
+ | <!-- TODO: e.g., Railway --> | <!-- TODO --> | <!-- TODO --> |
59
+
60
+ Health endpoints: <!-- TODO: e.g., /health, /api/health -->
61
+
62
+ ## Environments
63
+
64
+ <!-- TODO: Auto-populated by /scan environments or /calibrate -->
65
+
66
+ | Name | Type | URL | Health | Deploy | Branch |
67
+ |------|------|-----|--------|--------|--------|
68
+ | local | development | <!-- TODO --> | <!-- TODO: e.g., /health --> | manual | — |
69
+ | <!-- TODO --> | <!-- TODO: staging/production/preview/canary --> | <!-- TODO --> | <!-- TODO --> | <!-- TODO --> | <!-- TODO --> |
70
+
71
+ Access notes: <!-- TODO: e.g., Railway MCP for staging/prod. Env vars: .env.local, .env.staging -->
72
+
73
+ ## Domain
74
+
75
+ <!-- TODO: Auto-populated by /scan or fill manually -->
76
+ <!-- Describe what this app does, its core entities, and business rules. -->
77
+ <!-- Used by qa-domain agent for domain-aware testing. -->
78
+
79
+ ## Running Locally
80
+
81
+ ```bash
82
+ # TODO: Add your local development commands
83
+ # Frontend
84
+ cd frontend && npm run dev
85
+
86
+ # Backend
87
+ cd backend && source .venv/bin/activate && uvicorn app.main:app --reload
88
+ ```
89
+
90
+ ## Critical Rules
91
+
92
+ <!-- TODO: Add project-specific rules, e.g.: -->
93
+ - Never push to main directly — always create a PR
94
+ - Secrets in .env.local only — never committed
95
+
96
+ ## Agent Customization
97
+
98
+ The following agents/skills are managed by `claude-agents` (symlinked):
99
+ - Run `~/.claude-agents/install.sh --status` to see what's linked
100
+ - To override any portable file, replace the symlink with a regular file
101
+ - Your override won't be touched by future syncs
102
+
103
+ ### Project-Specific Agents
104
+
105
+ Add project-specific agents as regular files in `.claude/agents/`:
106
+ - See `~/.claude-agents/examples/agents/` for templates (frontend, backend, ops, sre, qa)
107
+
108
+ ### Project-Specific Skills
109
+
110
+ Add project-specific skills as regular directories in `.claude/skills/`:
111
+ - See `~/.claude-agents/examples/skills/` for templates (ci-fix, qa, restart)