@c0x12c/ai-toolkit 1.15.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 (255) hide show
  1. package/.claude-plugin/marketplace.json +16 -0
  2. package/.claude-plugin/plugin.json +12 -0
  3. package/README.md +439 -0
  4. package/VERSION +1 -0
  5. package/agents/design-critic.md +127 -0
  6. package/agents/idea-killer.md +72 -0
  7. package/agents/infrastructure-expert.md +49 -0
  8. package/agents/micronaut-backend-expert.md +45 -0
  9. package/agents/phase-reviewer.md +150 -0
  10. package/agents/research-planner.md +70 -0
  11. package/agents/solution-architect-cto.md +49 -0
  12. package/agents/sre-architect.md +49 -0
  13. package/agents/team-coordinator.md +111 -0
  14. package/bin/cli.js +780 -0
  15. package/claude-md/00-header.md +39 -0
  16. package/claude-md/01-core.md +105 -0
  17. package/claude-md/05-database.md +20 -0
  18. package/claude-md/11-backend-micronaut.md +19 -0
  19. package/claude-md/20-frontend-react.md +44 -0
  20. package/claude-md/25-ux-design.md +56 -0
  21. package/claude-md/30-infrastructure.md +24 -0
  22. package/claude-md/30-project-mgmt.md +119 -0
  23. package/claude-md/40-product.md +39 -0
  24. package/claude-md/50-ops.md +34 -0
  25. package/claude-md/60-research.md +27 -0
  26. package/claude-md/90-footer.md +21 -0
  27. package/commands/spartan/brainstorm.md +134 -0
  28. package/commands/spartan/brownfield.md +157 -0
  29. package/commands/spartan/build.md +435 -0
  30. package/commands/spartan/careful.md +94 -0
  31. package/commands/spartan/commit-message.md +112 -0
  32. package/commands/spartan/content.md +17 -0
  33. package/commands/spartan/context-save.md +161 -0
  34. package/commands/spartan/contribute.md +140 -0
  35. package/commands/spartan/daily.md +42 -0
  36. package/commands/spartan/debug.md +308 -0
  37. package/commands/spartan/deep-dive.md +55 -0
  38. package/commands/spartan/deploy.md +207 -0
  39. package/commands/spartan/e2e.md +264 -0
  40. package/commands/spartan/env-setup.md +166 -0
  41. package/commands/spartan/epic.md +199 -0
  42. package/commands/spartan/fe-review.md +181 -0
  43. package/commands/spartan/figma-to-code.md +260 -0
  44. package/commands/spartan/forensics.md +46 -0
  45. package/commands/spartan/freeze.md +84 -0
  46. package/commands/spartan/fundraise.md +53 -0
  47. package/commands/spartan/gate-review.md +229 -0
  48. package/commands/spartan/gsd-upgrade.md +376 -0
  49. package/commands/spartan/guard.md +42 -0
  50. package/commands/spartan/init-project.md +178 -0
  51. package/commands/spartan/init-rules.md +298 -0
  52. package/commands/spartan/interview.md +154 -0
  53. package/commands/spartan/kickoff.md +73 -0
  54. package/commands/spartan/kotlin-service.md +109 -0
  55. package/commands/spartan/lean-canvas.md +222 -0
  56. package/commands/spartan/lint-rules.md +122 -0
  57. package/commands/spartan/map-codebase.md +124 -0
  58. package/commands/spartan/migration.md +82 -0
  59. package/commands/spartan/next-app.md +317 -0
  60. package/commands/spartan/next-feature.md +212 -0
  61. package/commands/spartan/onboard.md +326 -0
  62. package/commands/spartan/outreach.md +16 -0
  63. package/commands/spartan/phase.md +142 -0
  64. package/commands/spartan/pitch.md +18 -0
  65. package/commands/spartan/plan.md +210 -0
  66. package/commands/spartan/pr-ready.md +202 -0
  67. package/commands/spartan/project.md +106 -0
  68. package/commands/spartan/qa.md +222 -0
  69. package/commands/spartan/research.md +254 -0
  70. package/commands/spartan/review.md +132 -0
  71. package/commands/spartan/scan-rules.md +173 -0
  72. package/commands/spartan/sessions.md +143 -0
  73. package/commands/spartan/spec.md +131 -0
  74. package/commands/spartan/startup.md +257 -0
  75. package/commands/spartan/team.md +570 -0
  76. package/commands/spartan/teardown.md +161 -0
  77. package/commands/spartan/testcontainer.md +97 -0
  78. package/commands/spartan/tf-cost.md +123 -0
  79. package/commands/spartan/tf-deploy.md +116 -0
  80. package/commands/spartan/tf-drift.md +100 -0
  81. package/commands/spartan/tf-import.md +107 -0
  82. package/commands/spartan/tf-module.md +121 -0
  83. package/commands/spartan/tf-plan.md +100 -0
  84. package/commands/spartan/tf-review.md +106 -0
  85. package/commands/spartan/tf-scaffold.md +109 -0
  86. package/commands/spartan/tf-security.md +147 -0
  87. package/commands/spartan/think.md +221 -0
  88. package/commands/spartan/unfreeze.md +13 -0
  89. package/commands/spartan/update.md +134 -0
  90. package/commands/spartan/ux.md +1233 -0
  91. package/commands/spartan/validate.md +193 -0
  92. package/commands/spartan/web-to-prd.md +706 -0
  93. package/commands/spartan/workstreams.md +109 -0
  94. package/commands/spartan/write.md +16 -0
  95. package/commands/spartan.md +386 -0
  96. package/frameworks/00-framework-comparison-guide.md +317 -0
  97. package/frameworks/01-lean-canvas.md +196 -0
  98. package/frameworks/02-design-sprint.md +304 -0
  99. package/frameworks/03-foundation-sprint.md +337 -0
  100. package/frameworks/04-business-model-canvas.md +391 -0
  101. package/frameworks/05-customer-development.md +426 -0
  102. package/frameworks/06-jobs-to-be-done.md +358 -0
  103. package/frameworks/07-mom-test.md +392 -0
  104. package/frameworks/08-value-proposition-canvas.md +488 -0
  105. package/frameworks/09-javelin-board.md +428 -0
  106. package/frameworks/10-build-measure-learn.md +467 -0
  107. package/frameworks/11-mvp-approaches.md +533 -0
  108. package/frameworks/think-before-build.md +593 -0
  109. package/lib/assembler.js +197 -0
  110. package/lib/assembler.test.js +159 -0
  111. package/lib/detector.js +166 -0
  112. package/lib/detector.test.js +221 -0
  113. package/lib/packs.js +16 -0
  114. package/lib/resolver.js +272 -0
  115. package/lib/resolver.test.js +298 -0
  116. package/lib/worktree.sh +104 -0
  117. package/package.json +50 -0
  118. package/packs/backend-micronaut.yaml +35 -0
  119. package/packs/backend-nodejs.yaml +15 -0
  120. package/packs/backend-python.yaml +15 -0
  121. package/packs/core.yaml +37 -0
  122. package/packs/database.yaml +21 -0
  123. package/packs/frontend-react.yaml +24 -0
  124. package/packs/infrastructure.yaml +40 -0
  125. package/packs/ops.yaml +16 -0
  126. package/packs/packs.compiled.json +371 -0
  127. package/packs/product.yaml +22 -0
  128. package/packs/project-mgmt.yaml +24 -0
  129. package/packs/research.yaml +39 -0
  130. package/packs/shared-backend.yaml +14 -0
  131. package/packs/ux-design.yaml +21 -0
  132. package/rules/backend-micronaut/API_DESIGN.md +313 -0
  133. package/rules/backend-micronaut/BATCH_PROCESSING.md +92 -0
  134. package/rules/backend-micronaut/CONTROLLERS.md +388 -0
  135. package/rules/backend-micronaut/KOTLIN.md +414 -0
  136. package/rules/backend-micronaut/RETROFIT_PLACEMENT.md +290 -0
  137. package/rules/backend-micronaut/SERVICES_AND_BEANS.md +325 -0
  138. package/rules/core/NAMING_CONVENTIONS.md +208 -0
  139. package/rules/core/SKILL_AUTHORING.md +174 -0
  140. package/rules/core/TIMEZONE.md +316 -0
  141. package/rules/database/ORM_AND_REPO.md +289 -0
  142. package/rules/database/SCHEMA.md +146 -0
  143. package/rules/database/TRANSACTIONS.md +311 -0
  144. package/rules/frontend-react/FRONTEND.md +344 -0
  145. package/rules/infrastructure/MODULES.md +260 -0
  146. package/rules/infrastructure/NAMING.md +196 -0
  147. package/rules/infrastructure/PROVIDERS.md +309 -0
  148. package/rules/infrastructure/SECURITY.md +310 -0
  149. package/rules/infrastructure/STATE_AND_BACKEND.md +237 -0
  150. package/rules/infrastructure/STRUCTURE.md +234 -0
  151. package/rules/infrastructure/VARIABLES.md +285 -0
  152. package/rules/shared-backend/ARCHITECTURE.md +46 -0
  153. package/rules/ux-design/DESIGN_PROCESS.md +176 -0
  154. package/skills/api-endpoint-creator/SKILL.md +455 -0
  155. package/skills/api-endpoint-creator/error-handling-guide.md +244 -0
  156. package/skills/api-endpoint-creator/examples.md +522 -0
  157. package/skills/api-endpoint-creator/testing-patterns.md +302 -0
  158. package/skills/article-writing/SKILL.md +109 -0
  159. package/skills/article-writing/examples.md +59 -0
  160. package/skills/backend-api-design/SKILL.md +84 -0
  161. package/skills/backend-api-design/code-patterns.md +138 -0
  162. package/skills/brainstorm/SKILL.md +95 -0
  163. package/skills/browser-qa/SKILL.md +87 -0
  164. package/skills/browser-qa/playwright-snippets.md +110 -0
  165. package/skills/ci-cd-patterns/SKILL.md +108 -0
  166. package/skills/ci-cd-patterns/workflows.md +149 -0
  167. package/skills/competitive-teardown/SKILL.md +93 -0
  168. package/skills/competitive-teardown/example-analysis.md +50 -0
  169. package/skills/content-engine/SKILL.md +131 -0
  170. package/skills/content-engine/examples.md +72 -0
  171. package/skills/database-patterns/SKILL.md +72 -0
  172. package/skills/database-patterns/code-templates.md +114 -0
  173. package/skills/database-table-creator/SKILL.md +141 -0
  174. package/skills/database-table-creator/examples.md +552 -0
  175. package/skills/database-table-creator/kotlin-templates.md +400 -0
  176. package/skills/database-table-creator/migration-template.sql +68 -0
  177. package/skills/database-table-creator/validation-checklist.md +337 -0
  178. package/skills/deep-research/SKILL.md +80 -0
  179. package/skills/design-intelligence/SKILL.md +268 -0
  180. package/skills/design-workflow/SKILL.md +127 -0
  181. package/skills/design-workflow/checklists.md +45 -0
  182. package/skills/idea-validation/SKILL.md +129 -0
  183. package/skills/idea-validation/example-report.md +50 -0
  184. package/skills/investor-materials/SKILL.md +122 -0
  185. package/skills/investor-materials/example-outline.md +70 -0
  186. package/skills/investor-outreach/SKILL.md +112 -0
  187. package/skills/investor-outreach/examples.md +76 -0
  188. package/skills/kotlin-best-practices/SKILL.md +58 -0
  189. package/skills/kotlin-best-practices/code-patterns.md +132 -0
  190. package/skills/market-research/SKILL.md +99 -0
  191. package/skills/security-checklist/SKILL.md +65 -0
  192. package/skills/security-checklist/audit-reference.md +95 -0
  193. package/skills/service-debugging/SKILL.md +116 -0
  194. package/skills/service-debugging/common-issues.md +65 -0
  195. package/skills/startup-pipeline/SKILL.md +152 -0
  196. package/skills/terraform-best-practices/SKILL.md +244 -0
  197. package/skills/terraform-module-creator/SKILL.md +284 -0
  198. package/skills/terraform-review/SKILL.md +222 -0
  199. package/skills/terraform-security-audit/SKILL.md +280 -0
  200. package/skills/terraform-service-scaffold/SKILL.md +574 -0
  201. package/skills/testing-strategies/SKILL.md +116 -0
  202. package/skills/testing-strategies/examples.md +103 -0
  203. package/skills/testing-strategies/integration-test-setup.md +71 -0
  204. package/skills/ui-ux-pro-max/SKILL.md +238 -0
  205. package/skills/ui-ux-pro-max/data/charts.csv +26 -0
  206. package/skills/ui-ux-pro-max/data/colors.csv +97 -0
  207. package/skills/ui-ux-pro-max/data/icons.csv +101 -0
  208. package/skills/ui-ux-pro-max/data/landing.csv +31 -0
  209. package/skills/ui-ux-pro-max/data/products.csv +97 -0
  210. package/skills/ui-ux-pro-max/data/react-performance.csv +45 -0
  211. package/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -0
  212. package/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  213. package/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  214. package/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  215. package/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  216. package/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  217. package/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  218. package/skills/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  219. package/skills/ui-ux-pro-max/data/stacks/react.csv +54 -0
  220. package/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  221. package/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  222. package/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  223. package/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  224. package/skills/ui-ux-pro-max/data/styles.csv +68 -0
  225. package/skills/ui-ux-pro-max/data/typography.csv +58 -0
  226. package/skills/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  227. package/skills/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  228. package/skills/ui-ux-pro-max/data/web-interface.csv +31 -0
  229. package/skills/ui-ux-pro-max/python-setup.md +146 -0
  230. package/skills/ui-ux-pro-max/scripts/core.py +253 -0
  231. package/skills/ui-ux-pro-max/scripts/design_system.py +1067 -0
  232. package/skills/ui-ux-pro-max/scripts/search.py +114 -0
  233. package/skills/web-to-prd/SKILL.md +478 -0
  234. package/templates/build-config.yaml +44 -0
  235. package/templates/commands-config.yaml +55 -0
  236. package/templates/competitor-analysis.md +60 -0
  237. package/templates/content/AGENT_TEMPLATE.md +47 -0
  238. package/templates/content/COMMAND_TEMPLATE.md +27 -0
  239. package/templates/content/RULE_TEMPLATE.md +40 -0
  240. package/templates/content/SKILL_TEMPLATE.md +41 -0
  241. package/templates/design-config.md +105 -0
  242. package/templates/design-doc.md +207 -0
  243. package/templates/epic.md +100 -0
  244. package/templates/feature-spec.md +181 -0
  245. package/templates/idea-canvas.md +47 -0
  246. package/templates/implementation-plan.md +159 -0
  247. package/templates/prd-template.md +86 -0
  248. package/templates/preamble.md +89 -0
  249. package/templates/project-readme.md +35 -0
  250. package/templates/quality-gates.md +230 -0
  251. package/templates/spartan-config.yaml +164 -0
  252. package/templates/user-interview.md +69 -0
  253. package/templates/validation-checklist.md +108 -0
  254. package/templates/workflow-backend-micronaut.md +409 -0
  255. package/templates/workflow-frontend-react.md +233 -0
@@ -0,0 +1,16 @@
1
+ {
2
+ "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
3
+ "name": "spartan-marketplace",
4
+ "description": "Spartan AI Toolkit — engineering discipline layer for Claude Code",
5
+ "owner": {
6
+ "name": "Spartan Stratos"
7
+ },
8
+ "plugins": [
9
+ {
10
+ "name": "ai-toolkit",
11
+ "description": "5 workflows, 69 commands, 21 rules, 29 skills, 9 agents — organized in 12 packs with dependencies",
12
+ "source": "./toolkit",
13
+ "version": "1.15.0"
14
+ }
15
+ ]
16
+ }
@@ -0,0 +1,12 @@
1
+ {
2
+ "name": "ai-toolkit",
3
+ "version": "1.14.0",
4
+ "description": "Engineering discipline layer for Claude Code — 5 workflows, 69 commands, 21 rules, 29 skills, 9 agents organized in 12 packs",
5
+ "author": {
6
+ "name": "Khoa Tran",
7
+ "url": "https://github.com/c0x12c"
8
+ },
9
+ "repository": "https://github.com/c0x12c/ai-toolkit",
10
+ "license": "MIT",
11
+ "keywords": ["engineering", "workflow", "kotlin", "micronaut", "nextjs", "product-thinking"]
12
+ }
package/README.md ADDED
@@ -0,0 +1,439 @@
1
+ # Spartan AI Toolkit
2
+
3
+ > Workflow-first engineering discipline for AI coding tools. Workflows solve problems end-to-end. Skills provide knowledge at each step. Agent memory carries context across sessions.
4
+
5
+ ---
6
+
7
+ ## Install
8
+
9
+ Three ways to install. Pick one.
10
+
11
+ ### Option 1: npx (recommended)
12
+
13
+ ```bash
14
+ npx @c0x12c/ai-toolkit@latest
15
+ ```
16
+
17
+ Interactive menu — pick your AI tool and packs. Works out of the box.
18
+
19
+ ```bash
20
+ # Or specify packs directly
21
+ npx @c0x12c/ai-toolkit@latest --packs=backend-micronaut,product
22
+
23
+ # Install everything
24
+ npx @c0x12c/ai-toolkit@latest --all
25
+
26
+ # Install for Cursor instead of Claude Code
27
+ npx @c0x12c/ai-toolkit@latest --agent=cursor
28
+ ```
29
+
30
+ **Supported agents:** `claude-code` (default), `cursor`, `windsurf`, `codex`, `copilot`
31
+
32
+ ### Option 2: Setup script
33
+
34
+ ```bash
35
+ git clone https://github.com/c0x12c/ai-toolkit.git
36
+ cd ai-toolkit/toolkit
37
+ chmod +x scripts/setup.sh
38
+ ./scripts/setup.sh --global
39
+ ```
40
+
41
+ ### Option 3: Claude Code plugin
42
+
43
+ Search for **"Spartan AI Toolkit"** in the Claude Code plugin marketplace.
44
+
45
+ ### Global vs Local
46
+
47
+ - `--global` installs to `~/.claude/` — works across all projects (default)
48
+ - `--local` installs to `./.claude/` — only this project
49
+
50
+ After install, open any project, run `claude`, then type `/spartan`.
51
+
52
+ ---
53
+
54
+ ## Demo: Web-to-PRD
55
+
56
+ Scan a live web app, extract every feature, generate a structured PRD with epics and stories, then export to Notion.
57
+
58
+ ```
59
+ /spartan:web-to-prd "https://screensdesign.com"
60
+ ```
61
+
62
+ ![Web-to-PRD scanning screensdesign.com](../docs/images/web-to-prd-demo.png)
63
+
64
+ Uses Playwright MCP (browser control) + Notion MCP (export). Auto-installs prerequisites, handles login, and asks for confirmation at each step.
65
+
66
+ ---
67
+
68
+ ## How to Use
69
+
70
+ ### The core workflow
71
+
72
+ Every feature follows the same pipeline. Skip steps that don't apply.
73
+
74
+ ```
75
+ /spartan:spec → /spartan:ux → /spartan:plan → /spartan:build → /spartan:pr-ready
76
+ ↑ ↑ ↑ ↑ + 3.5 ↑
77
+ Gate 1 Design Gate Gate 2 Gate 3 Gate 4
78
+ ```
79
+
80
+ | Step | What happens |
81
+ |------|-------------|
82
+ | `spec` | Interactive Q&A → saved spec → Gate 1 checks quality |
83
+ | `design` | Design doc + dual-agent review (skip for backend-only) |
84
+ | `plan` | Architecture + task breakdown from spec → Gate 2 |
85
+ | `build` | TDD task by task, picks up saved spec/plan |
86
+ | `gate-review` | Builder + reviewer agent both must accept |
87
+ | `pr-ready` | Rebase, test, lint, create PR |
88
+
89
+ **Bigger work?** Use `/spartan:epic` to break it into features first, then run the pipeline for each one. For multi-week projects, use `/spartan:project new` with milestones and phases.
90
+
91
+ **Skills load automatically** based on your stack. Kotlin files → `kotlin-best-practices`. React components → `ui-ux-pro-max`. Migrations → `database-patterns`. You don't pick them.
92
+
93
+ **Agent memory** (`.planning/`, `.memory/`) carries specs, plans, decisions, and patterns across sessions. The AI builds on what it already knows instead of starting from scratch.
94
+
95
+ **Rules** load every session with zero tokens. They enforce coding standards silently.
96
+
97
+ ---
98
+
99
+ ## Pick Your Packs
100
+
101
+ Packs group commands, rules, skills, and agents by use case. **Core is always installed.** Pick the rest based on what you're building.
102
+
103
+ ### "I'm building a Kotlin + Micronaut backend"
104
+
105
+ ```bash
106
+ npx @c0x12c/ai-toolkit@latest --packs=backend-micronaut
107
+ ```
108
+
109
+ This pulls in `backend-micronaut` + its dependencies (`database` and `shared-backend` auto-included). You get migration commands, API design rules, Kotlin coding standards, test patterns, and two expert agents.
110
+
111
+ ### "I'm building a React + Next.js frontend"
112
+
113
+ ```bash
114
+ npx @c0x12c/ai-toolkit@latest --packs=frontend-react
115
+ ```
116
+
117
+ You get Next.js scaffolding, Figma-to-code, E2E testing setup, frontend review, and the UI/UX design skill.
118
+
119
+ ### "Full-stack Kotlin + Next.js"
120
+
121
+ ```bash
122
+ npx @c0x12c/ai-toolkit@latest --packs=backend-micronaut,frontend-react
123
+ ```
124
+
125
+ ### "I'm managing AWS infrastructure with Terraform"
126
+
127
+ ```bash
128
+ npx @c0x12c/ai-toolkit@latest --packs=infrastructure
129
+ ```
130
+
131
+ You get Terraform scaffolding (ECS + EKS), module creation, security audits, drift detection, cost optimization, and two infrastructure agents. Rules enforce naming, state management, provider placement, and security patterns.
132
+
133
+ ### "I'm running a multi-week project"
134
+
135
+ ```bash
136
+ npx @c0x12c/ai-toolkit@latest --packs=backend-micronaut,project-mgmt
137
+ ```
138
+
139
+ Adds project lifecycle, phases, workstreams, and GSD v5 wave execution on top of your backend tools.
140
+
141
+ ### "I'm exploring startup ideas"
142
+
143
+ ```bash
144
+ npx @c0x12c/ai-toolkit@latest --packs=research
145
+ ```
146
+
147
+ Research pack pulls in `product` as a dependency. You get brainstorming, validation, market research, competitor teardowns, pitch materials, and investor outreach.
148
+
149
+ ### "Give me everything"
150
+
151
+ ```bash
152
+ npx @c0x12c/ai-toolkit@latest --all
153
+ ```
154
+
155
+ ---
156
+
157
+ ## All Packs
158
+
159
+ | Pack | Category | Depends on | What you get |
160
+ |------|----------|------------|--------------|
161
+ | **core** | Core | — | Always installed. Workflows (build, fix, onboard), spec, plan, gate-review, pr-ready, daily, safety commands, phase-reviewer agent |
162
+ | **backend-micronaut** | Backend | database, shared-backend | Kotlin service scaffold, code review, testcontainers, API/DB/Kotlin rules, 5 skills, 2 agents |
163
+ | **backend-nodejs** | Backend | database, shared-backend | Coming soon |
164
+ | **backend-python** | Backend | database, shared-backend | Coming soon |
165
+ | **frontend-react** | Frontend | — | Design workflow, Next.js scaffold, Figma-to-code, E2E, frontend review, UI/UX + design-workflow skills, design-critic agent |
166
+ | **project-mgmt** | Planning | — | Epics, project lifecycle, phases, workstreams, GSD upgrade, forensics, brownfield, codebase mapping |
167
+ | **product** | Planning | — | Think-before-build, validate, teardown, interview, lean canvas, brainstorm |
168
+ | **infrastructure** | Ops | — | Terraform + AWS: scaffold, modules, review, plan, deploy, import, drift, cost, security. 7 rules, 5 skills, 2 agents |
169
+ | **ops** | Ship | — | Deploy + env-setup |
170
+ | **research** | Research | product | Startup + research workflows, kickoff to investor outreach, 10 skills, 2 agents |
171
+
172
+ Hidden packs (`database`, `shared-backend`) get pulled in as dependencies — you don't pick them directly.
173
+
174
+ ---
175
+
176
+ ## Commands
177
+
178
+ All commands start with `/spartan:` (e.g., `/spartan:spec "feature"`).
179
+
180
+ Type `/spartan` to get the smart router — it asks what you need and picks the right command.
181
+
182
+ ### Workflows (core + research packs)
183
+ | Command | What it does |
184
+ |---------|-------------|
185
+ | `build [mode] [feature]` | Build a feature end-to-end (backend, frontend, or auto-detect) |
186
+ | `fix [symptom]` | Find and fix a bug with structured investigation |
187
+ | `research [topic]` | Deep research with source tracking and report |
188
+ | `startup [idea]` | Full startup pipeline: brainstorm to investor-ready |
189
+ | `onboard` | Understand a new codebase and set up tooling |
190
+
191
+ ### Core (always installed)
192
+ | Command | What it does |
193
+ |---------|-------------|
194
+ | `spec "feature"` | Write a feature spec — saves to `.planning/specs/` |
195
+ | `plan "feature"` | Write implementation plan from spec — saves to `.planning/plans/` |
196
+ | `gate-review [phase]` | Dual-agent review (Gate 3.5) — builder + reviewer both accept |
197
+ | `daily` | Standup summary from git history |
198
+ | `pr-ready` | Full checklist before creating any PR |
199
+ | `init-project` | Auto-generate CLAUDE.md from codebase scan |
200
+ | `context-save` | Save session state to resume later |
201
+ | `update` | Check for toolkit updates |
202
+ | `careful` | Warn before destructive ops |
203
+ | `freeze <dir>` | Lock edits to one directory |
204
+ | `unfreeze` | Remove directory lock |
205
+ | `guard <dir>` | careful + freeze combined |
206
+
207
+ ### Backend (backend-micronaut pack)
208
+ | Command | What it does |
209
+ |---------|-------------|
210
+ | `kotlin-service "name"` | Scaffold new Micronaut microservice |
211
+ | `review` | PR review with Kotlin/Micronaut conventions |
212
+ | `testcontainer "type"` | Setup Testcontainers integration testing |
213
+ | `migration "desc"` | Create Flyway database migration |
214
+
215
+ ### Frontend (frontend-react pack)
216
+ | Command | What it does |
217
+ |---------|-------------|
218
+ | `design "feature"` | Design workflow with dual-agent review (Design Gate) |
219
+ | `next-app "name"` | Scaffold new Next.js app |
220
+ | `next-feature "name"` | Add feature to existing Next.js app |
221
+ | `fe-review` | PR review with Next.js conventions |
222
+ | `figma-to-code "url"` | Figma design to production React |
223
+ | `e2e "feature"` | Setup Playwright E2E testing |
224
+
225
+ ### Planning (project-mgmt pack)
226
+ | Command | What it does |
227
+ |---------|-------------|
228
+ | `epic "name"` | Break big work into ordered features |
229
+ | `project [action]` | Large project lifecycle (new, status, milestone) |
230
+ | `phase [action]` | Phase lifecycle (discuss, plan, execute, verify) |
231
+ | `workstreams [action]` | Parallel work tracks |
232
+ | `gsd-upgrade` | Upgrade to GSD v5 with memory + waves |
233
+ | `forensics "problem"` | Post-mortem for failed workflows |
234
+ | `brownfield "svc"` | Map unfamiliar codebase before touching it |
235
+ | `map-codebase` | Deep codebase analysis with parallel agents |
236
+
237
+ ### Product (product pack)
238
+ | Command | What it does |
239
+ |---------|-------------|
240
+ | `think` | Guided thinking before coding |
241
+ | `validate` | Score an idea — GO / TEST MORE / KILL |
242
+ | `teardown` | Deep competitor analysis |
243
+ | `interview` | Mom Test interview questions |
244
+ | `lean-canvas` | Fill out a 9-block Lean Canvas |
245
+ | `brainstorm` | Generate and rank ideas |
246
+ | `web-to-prd "URL"` | Scan a live web app with Playwright, extract features, generate PRD with epics/stories, export to Notion |
247
+
248
+ ### Infrastructure (infrastructure pack)
249
+ | Command | What it does |
250
+ |---------|-------------|
251
+ | `tf-scaffold "service"` | Scaffold service-level Terraform (ECS or EKS) |
252
+ | `tf-module "name"` | Create/extend Terraform modules |
253
+ | `tf-review` | PR review for Terraform changes (8-stage checklist) |
254
+ | `tf-plan "env"` | Guided plan workflow with destructive change flagging |
255
+ | `tf-deploy "env"` | Deployment checklist with pre/post verification |
256
+ | `tf-import "resource"` | Import existing AWS resources into state |
257
+ | `tf-drift "env"` | Detect and categorize infrastructure drift |
258
+ | `tf-cost` | Cost estimation and optimization guidance |
259
+ | `tf-security` | Security audit (IAM, network, encryption, secrets) |
260
+
261
+ ### Ship (ops pack)
262
+ | Command | What it does |
263
+ |---------|-------------|
264
+ | `deploy "svc" "target"` | Deploy + verify |
265
+ | `env-setup "svc"` | Audit env vars across environments |
266
+
267
+ ### Research (research pack)
268
+ | Command | What it does |
269
+ |---------|-------------|
270
+ | `startup [idea]` | Full pipeline from brainstorm to outreach |
271
+ | `kickoff [theme]` | Start new idea — brainstorm + validate |
272
+ | `deep-dive [project]` | Market research + competitor teardowns |
273
+ | `fundraise [project]` | Pitch materials + investor outreach |
274
+ | `research [topic]` | Deep research with source checking |
275
+ | `pitch [type]` | Investor-facing materials |
276
+ | `outreach [investor]` | Draft investor emails |
277
+ | `content [source]` | Turn ideas into platform-native content |
278
+ | `write [topic]` | Write blog posts and articles |
279
+
280
+ ---
281
+
282
+ ## Skills
283
+
284
+ Skills give Claude deeper knowledge in specific areas. They're loaded automatically when you use related commands.
285
+
286
+ | Skill | Pack | What it does |
287
+ |-------|------|-------------|
288
+ | `api-endpoint-creator` | backend-micronaut | Generate Controller → Manager → Repository stack |
289
+ | `database-table-creator` | database | SQL migration → Table → Entity → Repository → Tests |
290
+ | `backend-api-design` | backend-micronaut | RPC-style API design patterns |
291
+ | `database-patterns` | database | Schema design, migrations, Exposed ORM |
292
+ | `kotlin-best-practices` | backend-micronaut | Null safety, Either, coroutines |
293
+ | `testing-strategies` | backend-micronaut | Integration test patterns for Micronaut |
294
+ | `security-checklist` | backend-micronaut | Auth, validation, OWASP prevention |
295
+ | `ui-ux-pro-max` | frontend-react | Design intelligence — styles, palettes, font pairings, stacks |
296
+ | `terraform-service-scaffold` | infrastructure | Scaffold service Terraform (ECR, RDS, Redis, S3, ECS/EKS) |
297
+ | `terraform-module-creator` | infrastructure | Create reusable Terraform modules |
298
+ | `terraform-review` | infrastructure | PR review checklist for Terraform |
299
+ | `terraform-security-audit` | infrastructure | 6-area security audit for Terraform |
300
+ | `terraform-best-practices` | infrastructure | Quick reference for Terraform conventions |
301
+ | `brainstorm` | research | Idea generation and ranking |
302
+ | `idea-validation` | research | Score ideas with structured checklist |
303
+ | `market-research` | research | Market sizing, trends, opportunities |
304
+ | `competitive-teardown` | research | Deep competitor analysis |
305
+ | `deep-research` | research | Multi-source research with citations |
306
+ | `investor-materials` | research | Pitch deck, one-pager, financial model |
307
+ | `investor-outreach` | research | Investor targeting and outreach |
308
+ | `article-writing` | research | Long-form content creation |
309
+ | `content-engine` | research | Content strategy and production |
310
+ | `startup-pipeline` | research | Full startup research pipeline |
311
+ | `web-to-prd` | product | Scan web apps, extract features, generate PRD, export to Notion |
312
+
313
+ ---
314
+
315
+ ## Agents
316
+
317
+ | Agent | Pack | What it does |
318
+ |-------|------|-------------|
319
+ | `micronaut-backend-expert` | backend-micronaut | Micronaut framework, database design, API architecture |
320
+ | `solution-architect-cto` | backend-micronaut | System design, scalability, tech decisions |
321
+ | `infrastructure-expert` | infrastructure | AWS + Terraform, c0x12c modules, EKS/ECS, security |
322
+ | `sre-architect` | infrastructure | Multi-account strategy, cost optimization, DR planning |
323
+ | `idea-killer` | research | Stress-test ideas, find weaknesses |
324
+ | `research-planner` | research | Plan and coordinate research workflows |
325
+
326
+ ---
327
+
328
+ ## Rules
329
+
330
+ Rules are enforced automatically every session. No action needed — they're active as long as the pack is installed.
331
+
332
+ | Rule | Pack |
333
+ |------|------|
334
+ | `NAMING_CONVENTIONS` | core |
335
+ | `TIMEZONE` | core |
336
+ | `ARCHITECTURE` | shared-backend |
337
+ | `SCHEMA` | database |
338
+ | `ORM_AND_REPO` | database |
339
+ | `TRANSACTIONS` | database |
340
+ | `KOTLIN` | backend-micronaut |
341
+ | `CONTROLLERS` | backend-micronaut |
342
+ | `SERVICES_AND_BEANS` | backend-micronaut |
343
+ | `API_DESIGN` | backend-micronaut |
344
+ | `RETROFIT_PLACEMENT` | backend-micronaut |
345
+ | `FRONTEND` | frontend-react |
346
+ | `STRUCTURE` | infrastructure |
347
+ | `MODULES` | infrastructure |
348
+ | `STATE_AND_BACKEND` | infrastructure |
349
+ | `NAMING` | infrastructure |
350
+ | `SECURITY` | infrastructure |
351
+ | `VARIABLES` | infrastructure |
352
+ | `PROVIDERS` | infrastructure |
353
+
354
+ ---
355
+
356
+ ## Using with Other AI Tools
357
+
358
+ All content is standard markdown. The npx installer supports multiple agents:
359
+
360
+ ```bash
361
+ # Cursor — installs rules to .cursor/rules/
362
+ npx @c0x12c/ai-toolkit@latest --agent=cursor
363
+
364
+ # Windsurf — installs rules to .windsurf/rules/
365
+ npx @c0x12c/ai-toolkit@latest --agent=windsurf
366
+
367
+ # Codex — installs to .codex/
368
+ npx @c0x12c/ai-toolkit@latest --agent=codex
369
+
370
+ # Copilot — installs to .github/copilot/
371
+ npx @c0x12c/ai-toolkit@latest --agent=copilot
372
+ ```
373
+
374
+ For other tools, copy the rule files from `toolkit/rules/` into your tool's config directory.
375
+
376
+ ---
377
+
378
+ ## Project Config
379
+
380
+ Customize any Spartan command per project. Two config files in `.spartan/`:
381
+
382
+ ### `.spartan/build.yaml` — Build workflow config
383
+
384
+ Controls `/spartan:build` behavior:
385
+
386
+ ```yaml
387
+ branch-prefix: "feature" # branch name: [prefix]/[slug]
388
+ max-review-rounds: 3 # review-fix cycles before asking user
389
+ skip-stages: [] # skip: spec, design, plan, ship (never review)
390
+
391
+ prompts:
392
+ spec: |
393
+ Always include performance requirements.
394
+ plan: |
395
+ Every task must reference a Jira ticket.
396
+ implement: |
397
+ Add structured logging to new service methods.
398
+ review: |
399
+ Check all API responses include request_id.
400
+ ship: |
401
+ PR title: [PROJ-123] Short description.
402
+ ```
403
+
404
+ ### `.spartan/commands.yaml` — Per-command prompt injection
405
+
406
+ Inject custom instructions into ANY Spartan command:
407
+
408
+ ```yaml
409
+ prompts:
410
+ review: |
411
+ Flag any function longer than 50 lines.
412
+ pr-ready: |
413
+ Always add "Reviewers: @backend-team" for backend changes.
414
+ daily: |
415
+ Include blockers section. Tag by project area.
416
+ debug: |
417
+ Always check CloudWatch logs first.
418
+ migration: |
419
+ Migration files must start with ticket number.
420
+ ```
421
+
422
+ Templates for both files are in `toolkit/templates/`.
423
+
424
+ ---
425
+
426
+ ## Target Stack
427
+
428
+ Rules and skills are tuned for this stack, but the command framework works with anything:
429
+
430
+ | Layer | Technology |
431
+ |-------|-----------|
432
+ | Backend | Kotlin + Micronaut |
433
+ | Frontend | React + Next.js + TypeScript |
434
+ | Infrastructure | Terraform + AWS (EKS/ECS, RDS, ElastiCache, S3) |
435
+ | Database | PostgreSQL |
436
+ | CI/CD | GitHub Actions |
437
+
438
+ > **Different stack?** Fork the repo, edit the rules and skills, run the installer. Commands work with any language or framework.
439
+
package/VERSION ADDED
@@ -0,0 +1 @@
1
+ 1.15.0
@@ -0,0 +1,127 @@
1
+ ---
2
+ name: design-critic
3
+ description: |
4
+ Design reviewer that catches AI-generic patterns, checks brand compliance, accessibility, and responsive behavior. Works with the designer in a discussion loop for the Design Gate.
5
+
6
+ <example>
7
+ Context: Designer just created a design doc for a new dashboard screen.
8
+ user: "Review this design for the Design Gate"
9
+ assistant: "I'll use the design-critic agent to evaluate the design for AI-generic patterns and brand compliance."
10
+ </example>
11
+
12
+ <example>
13
+ Context: /spartan:ux prototype command needs a second opinion on the UI.
14
+ user: "Run the design critic on this feature"
15
+ assistant: "I'll spawn the design-critic to review the design doc and give a verdict."
16
+ </example>
17
+ model: sonnet
18
+ ---
19
+
20
+ You are a **senior design critic**. Your job is to evaluate UI designs for quality, catching AI-generic patterns and making sure the design matches the project's brand identity.
21
+
22
+ You're not here to redesign — you're here to catch what the designer missed.
23
+
24
+ ## What You Review
25
+
26
+ ### AI Generic Detection (Check First)
27
+
28
+ This is your #1 job. Does this design look like every other AI-generated page?
29
+
30
+ - [ ] No colors outside the project palette (check design-config if it exists)
31
+ - [ ] No generic gradient blobs or decorative noise
32
+ - [ ] Layout has visual variety (not everything centered and same-sized)
33
+ - [ ] Typography has clear hierarchy (3+ distinct sizes/weights visible)
34
+ - [ ] Copy is specific to the project domain (not generic marketing fluff)
35
+ - [ ] Would you remember this design tomorrow? (If no, it's too generic)
36
+
37
+ ### Design Token Compliance (ZERO tolerance if tokens exist)
38
+
39
+ Check `.planning/design/system/tokens.md` and `.planning/design-config.md`:
40
+
41
+ - [ ] **EVERY** color in the design matches the token list EXACTLY (not "close enough")
42
+ - [ ] **EVERY** font reference matches the project font EXACTLY (not a substitute)
43
+ - [ ] Spacing values align with the token scale (no arbitrary numbers)
44
+ - [ ] Border radius matches token definitions
45
+ - [ ] Shadow levels match token definitions
46
+
47
+ **Hard fail:** If even ONE color or font doesn't match the tokens → NEEDS CHANGES. The whole point of tokens is consistency. No exceptions.
48
+
49
+ ### Brand Compliance (If design-config exists)
50
+
51
+ - [ ] Colors match the design-config palette exactly (not approximations)
52
+ - [ ] Font matches design-config (not Tailwind defaults or random fonts)
53
+ - [ ] Design personality matches design-config description
54
+ - [ ] Anti-references from design-config are respected (things to avoid)
55
+ - [ ] Accent color used sparingly — max 10-15% of screen
56
+
57
+ ### User Flows
58
+
59
+ - [ ] Every user story from spec has a mapped flow
60
+ - [ ] Each flow has clear steps: trigger, actions, end state
61
+ - [ ] Edge case flows listed (empty data, error, loading, timeout)
62
+
63
+ ### Accessibility (WCAG AA)
64
+
65
+ - [ ] Text contrast ratio meets 4.5:1
66
+ - [ ] Interactive elements have focus states
67
+ - [ ] Touch targets at least 44x44px on mobile
68
+ - [ ] No information conveyed by color alone
69
+ - [ ] Animations respect prefers-reduced-motion
70
+
71
+ ### Responsive
72
+
73
+ - [ ] Layout works at mobile (375px), tablet (768px), desktop (1440px)
74
+ - [ ] No horizontal scroll on mobile
75
+ - [ ] Content reflows properly
76
+
77
+ ### Completeness
78
+
79
+ - [ ] All states shown (loading, empty, error, success)
80
+ - [ ] Component specs have: name, props, states
81
+ - [ ] Wireframes exist for key screens
82
+ - [ ] A developer could build from just this doc (no ambiguity)
83
+
84
+ ## How You Work
85
+
86
+ 1. **Read the design doc** line by line.
87
+ 2. **Read design-config** if it exists. Compare every color and font.
88
+ 3. **Read the spec** if provided. Does the design cover all requirements?
89
+ 4. **Check every item** on the lists above.
90
+ 5. **Give your verdict.**
91
+
92
+ ## Your Output
93
+
94
+ ```markdown
95
+ ## Design Gate Review
96
+
97
+ ### Verdict: ACCEPT | NEEDS CHANGES
98
+
99
+ ### AI Generic Score: [1-10]
100
+ (1 = looks like every AI page. 10 = unique and memorable.)
101
+
102
+ [2-3 sentences on why this score]
103
+
104
+ ### Issues Found
105
+ [Only if NEEDS CHANGES]
106
+
107
+ 1. **[severity: HIGH/MEDIUM]** — [what's wrong]
108
+ - Where: [which section/screen]
109
+ - Fix: [what to do]
110
+
111
+ 2. ...
112
+
113
+ ### What's Good
114
+ - [always include positive feedback]
115
+
116
+ ### Notes
117
+ - [anything else]
118
+ ```
119
+
120
+ ## Rules
121
+
122
+ - **AI-generic is the #1 failure mode.** If you can swap the logo and colors and it looks like any other app, it fails.
123
+ - **Be specific.** Don't say "the design is generic" — say which part and why.
124
+ - **HIGH = must fix. MEDIUM = should fix.** Don't block on style preferences.
125
+ - **Praise what works.** Good whitespace, good hierarchy, good color usage — call it out.
126
+ - **One round of discussion.** If the designer disagrees, hear them out. Be flexible on taste, firm on accessibility and brand compliance.
127
+ - **ACCEPT means ACCEPT.** No "accept with concerns." Either it passes or it doesn't.
@@ -0,0 +1,72 @@
1
+ ---
2
+ name: idea-killer
3
+ description: The harshest idea critic. Tries to kill your idea before the market does. Use when you need someone to find every flaw.
4
+ tools: ["Read", "WebSearch", "WebFetch", "Grep", "Glob"]
5
+ model: opus
6
+ ---
7
+
8
+ You are the harshest startup advisor alive. Your job is to find every reason an idea won't work.
9
+
10
+ ## Your Job
11
+
12
+ - Find every flaw in the idea
13
+ - Point out what the founder is ignoring
14
+ - Challenge every assumption
15
+ - Find competitors they missed
16
+ - Predict how this fails
17
+
18
+ ## How You Think
19
+
20
+ You've seen 10,000 startup pitches. 95% failed. You know the patterns.
21
+
22
+ Common reasons ideas die:
23
+ - "Solution looking for a problem"
24
+ - "Already been done better"
25
+ - "Can't get users cheap enough"
26
+ - "Market too small"
27
+ - "No moat, competitors will copy in 2 months"
28
+ - "Founder doesn't know the customer"
29
+ - "Timing is wrong"
30
+ - "Can't charge enough to make money"
31
+
32
+ ## Process
33
+
34
+ 1. **Listen** - Understand the idea fully
35
+ 2. **Attack** - Find every weakness
36
+ 3. **Search** - Look for competitors and data that kills the thesis
37
+ 4. **Verdict** - Give your honest take
38
+
39
+ ## Output Format
40
+
41
+ ### What I Like (be brief)
42
+ - [1-2 things that aren't terrible]
43
+
44
+ ### What Will Kill This
45
+ 1. [Biggest problem] - [Why this is fatal]
46
+ 2. [Second problem] - [Evidence]
47
+ 3. [Third problem] - [Evidence]
48
+
49
+ ### Competitors You're Ignoring
50
+ - [Company] - [What they do] - [Why they're ahead]
51
+
52
+ ### The Hard Questions
53
+ - [Question the founder doesn't want to answer]
54
+ - [Another one]
55
+ - [Another one]
56
+
57
+ ### My Verdict
58
+ [GO / MAYBE / KILL IT]
59
+
60
+ [2-3 sentences on why. No sugarcoating.]
61
+
62
+ ### If You Still Want to Build This
63
+ [The one thing to test first that would prove me wrong]
64
+
65
+ ## Rules
66
+
67
+ - Be harsh but fair
68
+ - Back attacks with data when possible
69
+ - Don't be mean for fun. Be mean because it saves time.
70
+ - If the idea is actually good, say so. But still find the risks.
71
+ - "I don't know" is fine. "This is probably fine" is not.
72
+ - Never say "This is a great idea!" unless you really mean it