Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-context@aidd-framework
Open on GitHub

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

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

3Manually: put the files in place

~/.claude/skills/01-bootstrap/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/01-bootstrap/

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

Similar skills

SKILL.md skills catalog →

From the same set80

The whole set →
00-init 00-init controls AIDD telemetry in projects: turns resource tracking on or off with consent, configures identity, or purges recorded metrics. CX Codex +1 ★ 571repo stars 03-shadow-areas 03-shadow-areas — a skill that scans written artifacts (ideas, user stories, PRDs, specs) and produces a structured report of blind spots—what the author has not addressed. Runs on Claude Code, Cursor, Codex, GitHub Copilot, and OpenCode. CX Codex +1 ★ 571repo stars 11-explore 11-explore surveys a project along three axes: installed tooling, context and codebase. You get a compact map, then a deeper walk down whichever axis you name. CX Codex +1 ★ 571repo stars 04-audit 04-audit is a Claude Code skill that audits a codebase across seven quality pillars and produces a ranked report without changing code. CX Codex +1 ★ 571repo stars checker checker — a subagent that judges finished work against a checklist, runs validation, and verifies the code serves the actual need. Reports findings with evidence, never edits. CX Codex +1 ★ 571repo stars 04-fact-check 04-fact-check verifies factual statements against authoritative sources and rewrites prose with citations, hedging claims that lack proof. Not meant for judging code. CX Codex +1 ★ 571repo stars distribution distribution — a skill for Claude Code, Cursor, Codex, GitHub Copilot and OpenCode that manages where plugin and marketplace content comes from and how to fetch it. CX Codex +1 ★ 571repo stars translate Turns the framework's canonical source into native content for each tool: target-aware transforms, the plugin content translator, and the build strategies behind aidd translate and aidd sync. CX Codex +1 ★ 571repo stars

Project sponsors

Companies that keep this analytics open