---

name: bootstrap description: Use when starting a new project or setting up documentation structure - bootstraps docs/ folder with lifecycle documents and planning hierarchy

Bootstrap

Overview

Bootstrap project documentation structure with lifecycle phases and planning hierarchy. Performs due diligence first, then creates appropriate documentation based on repo state.

Announce at start: "I'm using the bootstrap skill to set up project documentation."

The Process

Copydigraph bootstrap_flow {
    "Start" [shape=doublecircle];
    "Due Diligence" [shape=box];
    "What found?" [shape=diamond];
    "Empty Repo" [shape=box];
    "Code, No Docs" [shape=box];
    "Docs Exist" [shape=box];
    "Ask project info" [shape=box];
    "Analyze codebase" [shape=box];
    "Ask what to update" [shape=box];
    "Create structure" [shape=box];
    "Generate docs" [shape=box];
    "Summary" [shape=doublecircle];

    "Start" -> "Due Diligence";
    "Due Diligence" -> "What found?";
    "What found?" -> "Empty Repo" [label="nothing"];
    "What found?" -> "Code, No Docs" [label="code only"];
    "What found?" -> "Docs Exist" [label="docs found"];
    "Empty Repo" -> "Ask project info";
    "Code, No Docs" -> "Analyze codebase";
    "Docs Exist" -> "Ask what to update";
    "Ask project info" -> "Create structure";
    "Analyze codebase" -> "Create structure";
    "Ask what to update" -> "Generate docs";
    "Create structure" -> "Generate docs";
    "Generate docs" -> "Summary";
}

Phase 1: Due Diligence

Analyze the repository to understand current state:

1.1 Check for existing docs

Copy# Check if docs/ exists
ls -la docs/ 2>/dev/null

# Check for monorepo indicators
ls -la apps/ packages/ 2>/dev/null
cat pnpm-workspace.yaml turbo.json nx.json 2>/dev/null

1.2 Detect project type

1.3 Analyze codebase (if code exists)

• Read package.json, README.md, existing docs
• Identify tech stack, frameworks, languages
• Extract project name, description, goals
• Note existing patterns and conventions

Phase 2: Determine Action

Empty Repo → New Setup

Ask for project information:

• Project name
• Short description
• Primary goals (3-5 bullet points)
• Target users/audience

No confirmation needed → Proceed to create all phases.

Code Exists, No Docs → Generate from Analysis

Show analysis summary:

• Tech stack detected
• Project structure
• Patterns identified

No confirmation needed → Proceed to create all phases.

Docs Exist → Update Mode

Show current state:

• What documentation exists
• What's missing from standard structure

Confirm with user → Ask which phases to update/regenerate.

Phase 3: Create Structure

Standard Project

Copymkdir -p docs/{inception,vision,architecture,design/references,planning/epics}
touch docs/design/references/.gitkeep

Creates:

Copydocs/
├── inception/
├── vision/
├── architecture/
│   └── adr/
├── design/
│   └── references/
└── planning/
    └── epics/

Monorepo

Copy# Root docs (big picture, diagrams)
mkdir -p docs/{architecture,diagrams,adr}

# Per-app docs
for app in apps/*; do
  mkdir -p "$app/docs/{inception,vision,architecture,design/references,planning/epics}"
  touch "$app/docs/design/references/.gitkeep"
done

Creates:

Copydocs/                          # Root: system-wide
├── SYSTEM_ARCHITECTURE.md
├── diagrams/
└── adr/

apps/
├── web/docs/                  # Per-app: full structure
└── api/docs/

Phase 4: Generate Documents

Invoke specialized skills for each phase:

For New Setup (all phases)

1. REQUIRED SUB-SKILL: Use orbty-eazy:inception
2. REQUIRED SUB-SKILL: Use orbty-eazy:vision
3. REQUIRED SUB-SKILL: Use orbty-eazy:architecture
4. REQUIRED SUB-SKILL: Use orbty-eazy:frontend-design (Docs Mode)
5. REQUIRED SUB-SKILL: Use orbty-eazy:project-planning

For Update Mode

Only invoke skills for phases user selected to update.

Phase 5: Summary

After document generation:

Copy## Bootstrap Complete

### Created Structure
- docs/inception/ (4 documents)
- docs/vision/ (4 documents)
- docs/architecture/ (5 documents)
- docs/design/ (7 documents + references/)
- docs/planning/ (ROADMAP, USER_STORIES, 1 epic, 3 tasks)

### Next Steps
1. Review generated documents and refine as needed
2. Use `orbty-eazy:task-planning` to add more tasks
3. Use `orbty-eazy:writing-plans` to enrich a TASK for implementation
4. Use `orbty-eazy:executing-plans` to implement enriched TASKs

### Commands Available
- `/inception` - Update inception docs
- `/vision` - Update vision docs
- `/architecture` - Update architecture docs
- `/frontend-design` - Update design docs or implement UI tasks
- `/project-planning` - Update planning hierarchy

Monorepo Handling

When monorepo detected:

1. Ask which app(s) to bootstrap: "Found apps: web, api, admin. Bootstrap docs for which?"
2. Create root docs/ for system-wide documentation
3. Create apps/{selected}/docs/ for each selected app
4. Run document generation for each selected app

Root docs/ contains:

• SYSTEM_ARCHITECTURE.md - Cross-app architecture (mermaid diagrams)
• diagrams/ - System-wide diagrams
• adr/ - Cross-cutting architectural decisions

Quick Reference

Common Mistakes