aibuilder-create-saas

name	aibuilder-create-saas
description	Complete SaaS ideation to implementation workflow - from idea discovery to task breakdown
argument-hint	[project-name]
disable-model-invocation	true
allow_implicit_invocation	false

Guide users through the complete SaaS creation journey: from discovering the right idea, through validation and PRD creation, to technical architecture and actionable tasks.

This workflow responds in the user's language while prompts are in English. It's designed for solo developers learning Next.js with Prisma and Better-Auth who want to build a monetizable SaaS in less than 2 weeks.

<quick_start> Start a new SaaS project (interactive discovery):

/create-saas

With custom project name:

/create-saas my-awesome-saas

Continue existing project:

/create-saas -c my-awesome-saas

What it does:

1. Discovery: Ask questions to understand your background
2. Brainstorm: Generate 3-6 validated SaaS ideas
3. Validate: Challenge and refine your chosen idea
4. PRD: Create Product Requirements Document
5. Architecture: Design technical stack (Next.js + Prisma + Better-Auth)
6. Tasks: Break down into actionable implementation tasks

Outputs saved to ~/.claude/output/saas/{project-id}/ </quick_start>

**Arguments:** - `[project-name]` - Optional project name (auto-generated if not provided)

Flags:

• -a / -A - Auto mode: skip confirmations (default: false)
• -s / -S - Save mode: save outputs to files (default: true)
• -c <project-id> - Continue mode: reload existing project and resume where you left off

<state_variables> Core Variables (persist throughout all steps):

Variable	Type	Description
{project_name}	string	SaaS project name
{project_id}	string	Kebab-case identifier for folders
{auto_mode}	boolean	Skip confirmations
{save_mode}	boolean	Save outputs to files
{output_dir}	string	Path to output folder
{user_language}	string	User's preferred language

Accumulated State (grows across steps):

Variable	Set In	Description
{discovery_answers}	Step 1	User's answers to discovery questions
{has_previous_project}	Step 1	Whether user built a project before
{ideas}	Step 2	List of 3-6 brainstormed ideas
{selected_idea}	Step 2	User's chosen idea
{validated_idea}	Step 3	Fully developed and validated idea
{prd_content}	Step 4	Product Requirements Document
{architecture}	Step 5	Technical architecture decisions
{tasks}	Step 6	List of implementation tasks

</state_variables>

<entry_point> Load steps/step-00-init.md </entry_point>

<step_files>

Step	File	Description
0	steps/step-00-init.md	Initialize: parse flags, create output folder
1	steps/step-01-discovery.md	Discovery: ask questions to find the right idea
2	steps/step-02-brainstorm.md	Brainstorm: generate 3-6 ideas, user chooses one
3	steps/step-03-validate.md	Validate: research, challenge, develop the idea
4	steps/step-04-prd.md	PRD: create Product Requirements Document
5	steps/step-05-architecture.md	Architecture: design technical stack
6	steps/step-06-tasks.md	Tasks: split into actionable implementation tasks
</step_files>

<workflow_diagram>

┌──────────────┐     ┌───────────────┐     ┌───────────────┐
│  Step 0      │────►│   Step 1      │────►│   Step 2      │
│  Initialize  │     │  Discovery    │     │  Brainstorm   │
└──────────────┘     └───────────────┘     └───────┬───────┘
                                                    │
                           ┌────────────────────────┘
                           │         ▲
                           ▼         │ (if not validated)
                     ┌───────────────┴─┐
                     │    Step 3       │
                     │   Validate      │
                     └────────┬────────┘
                              │ (if validated)
                              ▼
                     ┌───────────────┐     ┌───────────────┐
                     │   Step 4      │────►│   Step 5      │
                     │    PRD        │     │ Architecture  │
                     └───────────────┘     └───────┬───────┘
                                                    │
                                                    ▼
                                           ┌───────────────┐
                                           │   Step 6      │
                                           │    Tasks      │
                                           └───────────────┘

</workflow_diagram>

<output_structure> When {save_mode} = true, creates:

~/.claude/output/saas/{project_id}/
├── discovery.md     # Discovery answers and insights
├── idea.md          # Validated idea with all details
├── prd.md           # Product Requirements Document
├── archi.md         # Technical Architecture
├── marketing.md     # Marketing strategy notes
└── tasks/           # Implementation tasks
    ├── 01-setup.md
    ├── 02-auth.md
    ├── ...

</output_structure>

<success_criteria>

• Discovery questions answered and insights captured
• 3-6 validated SaaS ideas generated
• One idea selected and validated against market
• PRD created with clear problem, solution, and user stories
• Technical architecture defined (Next.js + Prisma + Better-Auth)
• Implementation tasks broken down and prioritized
• All outputs saved to ~/.claude/output/saas/{project-id}/
• Project ready to start implementation </success_criteria>

**Local References (in `references/` folder):** - `discovery-framework.md` - Mom Test + JTBD for idea discovery - `challenge-framework.md` - Smart validation for indie hackers - `prd-template.md` - Amazon + Lenny PRD frameworks - `architecture-template.md` - Architecture patterns - `tools.md` - Recommended tech stack - `task-template.md` - Task file structure

Scripts:

• scripts/setup.sh <project_id> - Creates output folder structure
• scripts/rename-project.sh <old> <new> - Renames project and updates all project_id references

Base Project:

• NOW.TS boilerplate - User provides path during step-07 setup