Welcome to Startup OS 🚀¶

A Git-powered command center that tracks everything from vision to code.

Why (Start Here)

Understand our purpose, vision, and principles before anything else.
Strategy

Our diagnosis, guiding policy, and coherent actions.
Discovery

Customer research, problems, and opportunities we're exploring.
Product

Product vision, PR/FAQ, roadmap, and specifications.
Validation

Current stage, metrics, and progress tracking.
Business

Business model, monetization, and go-to-market.
Design

Design system, principles, and brand guidelines.
Engineering

Architecture, tech stack, and technical decisions.
Growth

Marketing, positioning, and growth channels.
Operations

Team structure, rituals, and processes.
Finance

Budget, projections, and unit economics.
Journal

Decisions, learnings, and weekly updates.

🏗️ How This System Works¶

graph TD
    subgraph "🧠 The Brain - Strategy & Discovery"
        WHY[00_why<br/>Start with Why] --> STRATEGY[01_strategy<br/>Good Strategy]
        STRATEGY --> DISCOVERY[02_discovery<br/>Continuous Discovery]
        DISCOVERY --> PRODUCT[03_product<br/>Working Backwards]
        PRODUCT --> VALIDATION[04_validation<br/>Customer Development]
    end

    subgraph "💼 The Business"
        VALIDATION --> BUSINESS[05_business<br/>Business Model]
        BUSINESS --> GROWTH[08_growth<br/>Go-to-Market]
        GROWTH --> FINANCE[10_finance<br/>Unit Economics]
    end

    subgraph "⚙️ The Engine - Build"
        PRODUCT --> DESIGN[06_design<br/>Design System]
        DESIGN --> ENGINEERING[07_engineering<br/>Architecture]
        ENGINEERING --> CODE[src/<br/>Code]
    end

    subgraph "🔄 Operations"
        OPS[09_operations<br/>Team & Process]
        JOURNAL[journal/<br/>Learnings]
    end

    CODE --> VALIDATION
    FINANCE --> JOURNAL
    OPS --> JOURNAL

📖 Key Documents¶

Document	Description
Why We Exist	Our core purpose (Golden Circle)
PR/FAQ	Product vision (Working Backwards)
Current Stage	Where we are in Customer Development
Opportunity Tree	What we're exploring
Architecture	Technical architecture

🚀 Getting Started¶

For New Team Members¶

Start with Why → Read 00_why/ to understand our mission
Understand Strategy → Review 01_strategy/ for context
Check Progress → See Current Stage
Learn How We Work → Look at Rituals

Quick Links¶

📊 Current Stage - Where are we?
🎯 North Star Metric - What matters most?
👥 Personas - Who are we building for?
🗺️ Roadmap - What's next?

📚 Frameworks Used¶

This Startup OS is built on proven frameworks:

Framework	Applied In
Start with Why	`00_why/`
Good Strategy Bad Strategy	`01_strategy/`
The Mom Test	`02_discovery/`
Continuous Discovery Habits	`02_discovery/`
Working Backwards (PR/FAQ)	`03_product/`
Hooked	`03_product/hook_model.md`
The Startup Owner's Manual	`04_validation/`
Business Model Canvas	`05_business/`

Tip for AI Assistants

If you're an AI assistant (Cursor, Claude, etc.), start with 00_why/ to understand our purpose, then check 01_strategy/ for context before making suggestions.