@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.
- package/.claude-plugin/marketplace.json +16 -0
- package/.claude-plugin/plugin.json +12 -0
- package/README.md +439 -0
- package/VERSION +1 -0
- package/agents/design-critic.md +127 -0
- package/agents/idea-killer.md +72 -0
- package/agents/infrastructure-expert.md +49 -0
- package/agents/micronaut-backend-expert.md +45 -0
- package/agents/phase-reviewer.md +150 -0
- package/agents/research-planner.md +70 -0
- package/agents/solution-architect-cto.md +49 -0
- package/agents/sre-architect.md +49 -0
- package/agents/team-coordinator.md +111 -0
- package/bin/cli.js +780 -0
- package/claude-md/00-header.md +39 -0
- package/claude-md/01-core.md +105 -0
- package/claude-md/05-database.md +20 -0
- package/claude-md/11-backend-micronaut.md +19 -0
- package/claude-md/20-frontend-react.md +44 -0
- package/claude-md/25-ux-design.md +56 -0
- package/claude-md/30-infrastructure.md +24 -0
- package/claude-md/30-project-mgmt.md +119 -0
- package/claude-md/40-product.md +39 -0
- package/claude-md/50-ops.md +34 -0
- package/claude-md/60-research.md +27 -0
- package/claude-md/90-footer.md +21 -0
- package/commands/spartan/brainstorm.md +134 -0
- package/commands/spartan/brownfield.md +157 -0
- package/commands/spartan/build.md +435 -0
- package/commands/spartan/careful.md +94 -0
- package/commands/spartan/commit-message.md +112 -0
- package/commands/spartan/content.md +17 -0
- package/commands/spartan/context-save.md +161 -0
- package/commands/spartan/contribute.md +140 -0
- package/commands/spartan/daily.md +42 -0
- package/commands/spartan/debug.md +308 -0
- package/commands/spartan/deep-dive.md +55 -0
- package/commands/spartan/deploy.md +207 -0
- package/commands/spartan/e2e.md +264 -0
- package/commands/spartan/env-setup.md +166 -0
- package/commands/spartan/epic.md +199 -0
- package/commands/spartan/fe-review.md +181 -0
- package/commands/spartan/figma-to-code.md +260 -0
- package/commands/spartan/forensics.md +46 -0
- package/commands/spartan/freeze.md +84 -0
- package/commands/spartan/fundraise.md +53 -0
- package/commands/spartan/gate-review.md +229 -0
- package/commands/spartan/gsd-upgrade.md +376 -0
- package/commands/spartan/guard.md +42 -0
- package/commands/spartan/init-project.md +178 -0
- package/commands/spartan/init-rules.md +298 -0
- package/commands/spartan/interview.md +154 -0
- package/commands/spartan/kickoff.md +73 -0
- package/commands/spartan/kotlin-service.md +109 -0
- package/commands/spartan/lean-canvas.md +222 -0
- package/commands/spartan/lint-rules.md +122 -0
- package/commands/spartan/map-codebase.md +124 -0
- package/commands/spartan/migration.md +82 -0
- package/commands/spartan/next-app.md +317 -0
- package/commands/spartan/next-feature.md +212 -0
- package/commands/spartan/onboard.md +326 -0
- package/commands/spartan/outreach.md +16 -0
- package/commands/spartan/phase.md +142 -0
- package/commands/spartan/pitch.md +18 -0
- package/commands/spartan/plan.md +210 -0
- package/commands/spartan/pr-ready.md +202 -0
- package/commands/spartan/project.md +106 -0
- package/commands/spartan/qa.md +222 -0
- package/commands/spartan/research.md +254 -0
- package/commands/spartan/review.md +132 -0
- package/commands/spartan/scan-rules.md +173 -0
- package/commands/spartan/sessions.md +143 -0
- package/commands/spartan/spec.md +131 -0
- package/commands/spartan/startup.md +257 -0
- package/commands/spartan/team.md +570 -0
- package/commands/spartan/teardown.md +161 -0
- package/commands/spartan/testcontainer.md +97 -0
- package/commands/spartan/tf-cost.md +123 -0
- package/commands/spartan/tf-deploy.md +116 -0
- package/commands/spartan/tf-drift.md +100 -0
- package/commands/spartan/tf-import.md +107 -0
- package/commands/spartan/tf-module.md +121 -0
- package/commands/spartan/tf-plan.md +100 -0
- package/commands/spartan/tf-review.md +106 -0
- package/commands/spartan/tf-scaffold.md +109 -0
- package/commands/spartan/tf-security.md +147 -0
- package/commands/spartan/think.md +221 -0
- package/commands/spartan/unfreeze.md +13 -0
- package/commands/spartan/update.md +134 -0
- package/commands/spartan/ux.md +1233 -0
- package/commands/spartan/validate.md +193 -0
- package/commands/spartan/web-to-prd.md +706 -0
- package/commands/spartan/workstreams.md +109 -0
- package/commands/spartan/write.md +16 -0
- package/commands/spartan.md +386 -0
- package/frameworks/00-framework-comparison-guide.md +317 -0
- package/frameworks/01-lean-canvas.md +196 -0
- package/frameworks/02-design-sprint.md +304 -0
- package/frameworks/03-foundation-sprint.md +337 -0
- package/frameworks/04-business-model-canvas.md +391 -0
- package/frameworks/05-customer-development.md +426 -0
- package/frameworks/06-jobs-to-be-done.md +358 -0
- package/frameworks/07-mom-test.md +392 -0
- package/frameworks/08-value-proposition-canvas.md +488 -0
- package/frameworks/09-javelin-board.md +428 -0
- package/frameworks/10-build-measure-learn.md +467 -0
- package/frameworks/11-mvp-approaches.md +533 -0
- package/frameworks/think-before-build.md +593 -0
- package/lib/assembler.js +197 -0
- package/lib/assembler.test.js +159 -0
- package/lib/detector.js +166 -0
- package/lib/detector.test.js +221 -0
- package/lib/packs.js +16 -0
- package/lib/resolver.js +272 -0
- package/lib/resolver.test.js +298 -0
- package/lib/worktree.sh +104 -0
- package/package.json +50 -0
- package/packs/backend-micronaut.yaml +35 -0
- package/packs/backend-nodejs.yaml +15 -0
- package/packs/backend-python.yaml +15 -0
- package/packs/core.yaml +37 -0
- package/packs/database.yaml +21 -0
- package/packs/frontend-react.yaml +24 -0
- package/packs/infrastructure.yaml +40 -0
- package/packs/ops.yaml +16 -0
- package/packs/packs.compiled.json +371 -0
- package/packs/product.yaml +22 -0
- package/packs/project-mgmt.yaml +24 -0
- package/packs/research.yaml +39 -0
- package/packs/shared-backend.yaml +14 -0
- package/packs/ux-design.yaml +21 -0
- package/rules/backend-micronaut/API_DESIGN.md +313 -0
- package/rules/backend-micronaut/BATCH_PROCESSING.md +92 -0
- package/rules/backend-micronaut/CONTROLLERS.md +388 -0
- package/rules/backend-micronaut/KOTLIN.md +414 -0
- package/rules/backend-micronaut/RETROFIT_PLACEMENT.md +290 -0
- package/rules/backend-micronaut/SERVICES_AND_BEANS.md +325 -0
- package/rules/core/NAMING_CONVENTIONS.md +208 -0
- package/rules/core/SKILL_AUTHORING.md +174 -0
- package/rules/core/TIMEZONE.md +316 -0
- package/rules/database/ORM_AND_REPO.md +289 -0
- package/rules/database/SCHEMA.md +146 -0
- package/rules/database/TRANSACTIONS.md +311 -0
- package/rules/frontend-react/FRONTEND.md +344 -0
- package/rules/infrastructure/MODULES.md +260 -0
- package/rules/infrastructure/NAMING.md +196 -0
- package/rules/infrastructure/PROVIDERS.md +309 -0
- package/rules/infrastructure/SECURITY.md +310 -0
- package/rules/infrastructure/STATE_AND_BACKEND.md +237 -0
- package/rules/infrastructure/STRUCTURE.md +234 -0
- package/rules/infrastructure/VARIABLES.md +285 -0
- package/rules/shared-backend/ARCHITECTURE.md +46 -0
- package/rules/ux-design/DESIGN_PROCESS.md +176 -0
- package/skills/api-endpoint-creator/SKILL.md +455 -0
- package/skills/api-endpoint-creator/error-handling-guide.md +244 -0
- package/skills/api-endpoint-creator/examples.md +522 -0
- package/skills/api-endpoint-creator/testing-patterns.md +302 -0
- package/skills/article-writing/SKILL.md +109 -0
- package/skills/article-writing/examples.md +59 -0
- package/skills/backend-api-design/SKILL.md +84 -0
- package/skills/backend-api-design/code-patterns.md +138 -0
- package/skills/brainstorm/SKILL.md +95 -0
- package/skills/browser-qa/SKILL.md +87 -0
- package/skills/browser-qa/playwright-snippets.md +110 -0
- package/skills/ci-cd-patterns/SKILL.md +108 -0
- package/skills/ci-cd-patterns/workflows.md +149 -0
- package/skills/competitive-teardown/SKILL.md +93 -0
- package/skills/competitive-teardown/example-analysis.md +50 -0
- package/skills/content-engine/SKILL.md +131 -0
- package/skills/content-engine/examples.md +72 -0
- package/skills/database-patterns/SKILL.md +72 -0
- package/skills/database-patterns/code-templates.md +114 -0
- package/skills/database-table-creator/SKILL.md +141 -0
- package/skills/database-table-creator/examples.md +552 -0
- package/skills/database-table-creator/kotlin-templates.md +400 -0
- package/skills/database-table-creator/migration-template.sql +68 -0
- package/skills/database-table-creator/validation-checklist.md +337 -0
- package/skills/deep-research/SKILL.md +80 -0
- package/skills/design-intelligence/SKILL.md +268 -0
- package/skills/design-workflow/SKILL.md +127 -0
- package/skills/design-workflow/checklists.md +45 -0
- package/skills/idea-validation/SKILL.md +129 -0
- package/skills/idea-validation/example-report.md +50 -0
- package/skills/investor-materials/SKILL.md +122 -0
- package/skills/investor-materials/example-outline.md +70 -0
- package/skills/investor-outreach/SKILL.md +112 -0
- package/skills/investor-outreach/examples.md +76 -0
- package/skills/kotlin-best-practices/SKILL.md +58 -0
- package/skills/kotlin-best-practices/code-patterns.md +132 -0
- package/skills/market-research/SKILL.md +99 -0
- package/skills/security-checklist/SKILL.md +65 -0
- package/skills/security-checklist/audit-reference.md +95 -0
- package/skills/service-debugging/SKILL.md +116 -0
- package/skills/service-debugging/common-issues.md +65 -0
- package/skills/startup-pipeline/SKILL.md +152 -0
- package/skills/terraform-best-practices/SKILL.md +244 -0
- package/skills/terraform-module-creator/SKILL.md +284 -0
- package/skills/terraform-review/SKILL.md +222 -0
- package/skills/terraform-security-audit/SKILL.md +280 -0
- package/skills/terraform-service-scaffold/SKILL.md +574 -0
- package/skills/testing-strategies/SKILL.md +116 -0
- package/skills/testing-strategies/examples.md +103 -0
- package/skills/testing-strategies/integration-test-setup.md +71 -0
- package/skills/ui-ux-pro-max/SKILL.md +238 -0
- package/skills/ui-ux-pro-max/data/charts.csv +26 -0
- package/skills/ui-ux-pro-max/data/colors.csv +97 -0
- package/skills/ui-ux-pro-max/data/icons.csv +101 -0
- package/skills/ui-ux-pro-max/data/landing.csv +31 -0
- package/skills/ui-ux-pro-max/data/products.csv +97 -0
- package/skills/ui-ux-pro-max/data/react-performance.csv +45 -0
- package/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -0
- package/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
- package/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
- package/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
- package/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
- package/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
- package/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
- package/skills/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
- package/skills/ui-ux-pro-max/data/stacks/react.csv +54 -0
- package/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
- package/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
- package/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
- package/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -0
- package/skills/ui-ux-pro-max/data/styles.csv +68 -0
- package/skills/ui-ux-pro-max/data/typography.csv +58 -0
- package/skills/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
- package/skills/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
- package/skills/ui-ux-pro-max/data/web-interface.csv +31 -0
- package/skills/ui-ux-pro-max/python-setup.md +146 -0
- package/skills/ui-ux-pro-max/scripts/core.py +253 -0
- package/skills/ui-ux-pro-max/scripts/design_system.py +1067 -0
- package/skills/ui-ux-pro-max/scripts/search.py +114 -0
- package/skills/web-to-prd/SKILL.md +478 -0
- package/templates/build-config.yaml +44 -0
- package/templates/commands-config.yaml +55 -0
- package/templates/competitor-analysis.md +60 -0
- package/templates/content/AGENT_TEMPLATE.md +47 -0
- package/templates/content/COMMAND_TEMPLATE.md +27 -0
- package/templates/content/RULE_TEMPLATE.md +40 -0
- package/templates/content/SKILL_TEMPLATE.md +41 -0
- package/templates/design-config.md +105 -0
- package/templates/design-doc.md +207 -0
- package/templates/epic.md +100 -0
- package/templates/feature-spec.md +181 -0
- package/templates/idea-canvas.md +47 -0
- package/templates/implementation-plan.md +159 -0
- package/templates/prd-template.md +86 -0
- package/templates/preamble.md +89 -0
- package/templates/project-readme.md +35 -0
- package/templates/quality-gates.md +230 -0
- package/templates/spartan-config.yaml +164 -0
- package/templates/user-interview.md +69 -0
- package/templates/validation-checklist.md +108 -0
- package/templates/workflow-backend-micronaut.md +409 -0
- 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
|
+

|
|
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
|