01-bootstrap — Claude Code skill: SaaS architecture and setup
01-bootstrap guides early SaaS architecture decisions and records them in aidd_docs/INSTALL.md. Use it while defining a new project’s stack and design.
MIT ★ 571 updated 2026-10-29
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-context@aidd-frameworkWhat 01-bootstrap does
The skill gathers project requirements through a checklist, suggests a small set of stack candidates, and has parallel agents assess them. Once the user selects an option, it creates a folder tree and Mermaid diagram, then writes aidd_docs/INSTALL.md with the technical direction, decisions, architecture pattern, and setup steps.
This is a planning workflow, not a project generator. It writes no source files, package.json, or empty directories. When every candidate fails the audit, the workflow returns to candidate selection or requirements gathering. Each action has its own file in actions/, which should be read before that action runs; stack suggestions also draw on references/stack-heuristics.md.
What it helps with
- capture requirements for a new SaaS project
- compare candidate technology stacks
- audit stack options against project needs
- document architecture decisions in
aidd_docs/INSTALL.md
Example prompts for the agent
- Help me plan the architecture for a new SaaS idea.
- Gather the project requirements and compare possible stacks.
- Review these stack options and write
aidd_docs/INSTALL.md.
How to install 01-bootstrap
1Plugin marketplace
/plugin marketplace add ai-driven-dev/framework/plugin install aidd-context@aidd-frameworkThis installs the whole aidd-context plugin with all its skills
2Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-bootstrap -a claude-code3Manually: put the files in place
~/.claude/skills/01-bootstrap/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/01-bootstrap/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-bootstrap -a codex2Manually: put the files in place
.agents/skills/01-bootstrap/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-bootstrap -a cursor2Manually: put the files in place
.cursor/skills/01-bootstrap/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-context/skills/01-bootstrap2Manually: put the files in place
.github/skills/01-bootstrap/SKILL.md1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-bootstrap -a gemini-cli2Platform CLI
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-context/skills/01-bootstrapManually: put the files in place
.devin/skills/01-bootstrap/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-bootstrap -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about 01-bootstrap
How do I install 01-bootstrap in Claude Code?
Add the marketplace with /plugin marketplace add ai-driven-dev/framework, then install the plugin with /plugin install aidd-context@aidd-framework.
What does the 01-bootstrap skill do?
It gathers requirements for a new SaaS, compares and audits stack candidates, then documents the selected architecture in aidd_docs/INSTALL.md.
Does 01-bootstrap scaffold application code?
No. It writes architecture documentation to aidd_docs/INSTALL.md and does not create source files, package.json, or project directories.
Source text
SKILL.md · MIT
--- name: 01-bootstrap description: Design and validate a new SaaS's architecture into an INSTALL.md via Q&A and stack comparison. Use when the user starts a project, chooses a stack, or picks an architecture pattern. Not for editing an existing stack or scaffolding code. argument-hint: idea --- # Bootstrap Plays the role of technical architect for a new SaaS project. Walks the user through a 24-item checklist (18 user-input + 6 derived), proposes 2-3 candidate stacks, audits each via parallel agents, then produces `aidd_docs/INSTALL.md` capturing the technical vision, decisions, stack, architecture pattern, folder tree, and install steps. Documentation only: no code, no scaffolding. ## Actions | # | Action | Role | Input | | --- | --------------------- | -------------------------------------------------------------- | ------------------ | | 01 | `gather-needs` | Q&A across the 24-item checklist | user intent | | 02 | `propose-candidates` | Derive 2-3 candidate stacks, render comparison table | filled checklist | | 03 | `audit-candidates` | Spawn parallel agents to validate each candidate, emit verdict | candidates table | | 04 | `pick-and-design` | User picks winner; generate folder tree + Mermaid diagram | audit report | | 05 | `write-install-md` | Produce `aidd_docs/INSTALL.md` | design + decisions | Run `01 → 02 → 03 → 04 → 05`. The audit (03) gates: if every candidate fails, loop back to 02 or 01. Before running an action, read its file in `actions/`, not only the table or assets. ## Transversal rules - **No file scaffolding.** This skill writes only `aidd_docs/INSTALL.md`. It never creates `package.json`, source files, or empty directories. - **Anti-sycophancy.** When the user expresses a stack preference that conflicts with their needs (e.g. wants Mongo for heavily relational data), challenge it before accepting: surface audit concerns and ask whether the user has a mitigation plan. - **Recommend opinionated, not encyclopedic.** Each action proposes 2-3 options max, never a long catalog. The user should leave with a concrete decision, not a research paper. - **Stop on full checklist.** Action 01 keeps asking until the 18 user-input items (blocks 1-3) are filled; the 6 derived items (block 4) are filled across actions 02 and 04. - **Apply heuristics from `references/stack-heuristics.md`** when proposing candidates. ## References - `references/stack-heuristics.md` - input → recommended-stack-family heuristics ## Assets - `assets/checklist.md` - the 24-item checklist (4 blocks) - `assets/install-template.md` - the `INSTALL.md` skeleton
© AI-Driven Dev · MIT · ai-driven-dev/framework