🚀 FounderOS

Ideas Become Products.

The AI Engineering Operating System

Stop prompting AI. Start engineering with AI.

Build production-grade software through Specification-Driven AI Engineering (SDAE).

---

✨ Why FounderOS?

AI coding tools have dramatically reduced the cost of writing code.

But software development is more than writing code.

The difficult questions still remain:

• What should we build?
• Why should we build it?
• What should we not build?
• What architecture should we choose?
• How should the business domain be modeled?
• How should APIs evolve?
• How do we build securely?
• How do we break work into small, reviewable changes?
• How do we validate AI-generated software?

FounderOS addresses the engineering process around AI — not just code generation.

Traditional AI-assisted development

Human
  │
  ▼
Prompt
  │
  ▼
AI
  │
  ▼
Code

FounderOS

Product Intent
      │
      ▼
Product Discovery
      │
      ▼
Specification
      │
      ▼
Architecture
      │
      ▼
Implementation Plan
      │
      ▼
AI Engineering Agents
      │
      ▼
Incremental Implementation
      │
      ▼
Validation
      │
      ▼
Production Software

---

🎯 Vision

FounderOS enables founders and small engineering teams to build software with the discipline of a world-class engineering organization.

Instead of treating AI as a code generator, FounderOS treats AI as a team of specialized engineering roles working through structured workflows and reusable engineering artifacts.

FounderOS provides:

• 🤖 AI Engineering Agents
• 📄 Engineering Artifacts
• 📐 Architecture Standards
• 📋 Implementation Planning
• ✅ Quality Gates
• 🔄 Explicit Handoffs
• 📚 Reusable Templates and Playbooks

---

👥 Who It's For and How to Use It

FounderOS is for founders and small engineering teams who want to use AI while keeping product decisions, specifications, and quality gates explicit.

Use it as a working method for a project:

1. Start with the Quick Start and copy the relevant templates into your project workspace.
2. Follow the workflow from discovery and requirements through architecture, planning, implementation, testing, and release.
3. Use the Agent Catalog to choose an agent guide for each handoff, and the playbooks for repeatable procedures.
4. Review and approve product, security, and release decisions as a person on the team; keep assumptions and open questions visible.

FounderOS currently provides documentation, templates, agent instructions, and playbooks. The long-term vision includes possible CLI tooling, but no CLI or npm package is available today. See the completion roadmap for current progress.

---

🧠 The Core Idea

Great software is the result of great engineering systems — not better prompts.

AI makes software development faster.

FounderOS provides the engineering system that tells AI how to work.

Think
  ↓
Discover
  ↓
Specify
  ↓
Design
  ↓
Plan
  ↓
Build
  ↓
Validate
  ↓
Ship
  ↓
Learn

---

🏗️ AI Engineering Organization

FounderOS organizes AI capabilities around engineering roles, not AI vendors.

The framework is intentionally tool-agnostic and can work alongside Kiro, Cursor, Claude Code, ChatGPT, Gemini, or future AI development tools.

Product

Engineering Role	Agent	Status
👨‍💼 Senior Product Manager	Product Discovery Agent	✅
📋 Product Manager	PRD Agent	✅

Architecture

Engineering Role	Agent	Status
🏛 Staff Engineer	Solution Architecture Agent	✅
🗄 Database Architect	Database Design Agent	✅
🧩 Domain Architect	Domain Modeling Agent	✅
🔌 API Architect	API Specification Agent	✅
🔐 Principal Security Engineer	Security Architecture Agent	✅

Engineering

Engineering Role	Agent	Status
📋 Staff Engineer / Engineering Manager	Implementation Planning Agent	✅
💻 Senior Backend Engineer	Backend Module Implementation Agent	✅
🎨 Senior Frontend Engineer	Frontend Module Implementation Agent	✅
🤖 AI Platform Engineer	AI Module Implementation Agent	✅
🧪 QA Lead	Testing Agent	✅
🔍 Principal Engineer	Code Review Agent	✅
🚀 DevOps Engineer	Release Agent	✅

---

📦 Engineering Artifacts

FounderOS agents collaborate through structured engineering artifacts.

Agent
  │
  ▼
Engineering Artifact
  │
  ▼
Next Agent

Examples:

Agent	Artifact
Product Discovery	Product Discovery Document
PRD	Product Requirements Document
Solution Architecture	Architecture Document
Database Design	Database Design Document
Domain Modeling	Domain Model
API Specification	API / OpenAPI Specification
Security Architecture	Security Architecture
Implementation Planning	Implementation Plan
Backend Implementation	Backend Module
Frontend Implementation	Frontend Module

This creates a traceable engineering workflow instead of a collection of disconnected prompts.

---

🔄 FounderOS Engineering Loop

                    💡
                  IDEA
                    │
                    ▼
              🔍 DISCOVER
                    │
                    ▼
              📄 SPECIFY
                    │
                    ▼
              🏛 DESIGN
                    │
                    ▼
              📋 PLAN
                    │
                    ▼
               🤖 BUILD
                    │
                    ▼
              🧪 VALIDATE
                    │
                    ▼
               🚀 SHIP
                    │
                    ▼
               📈 LEARN
                    │
                    └──────────────► Improve

The goal isn't to eliminate engineering judgment.

The goal is to make good engineering judgment repeatable.

---

🚫 What FounderOS Is Not

FounderOS is not:

• ❌ Another AI coding assistant
• ❌ Another collection of random prompts
• ❌ A replacement for Kiro, Cursor, Claude Code, or ChatGPT
• ❌ A framework locked to a specific AI vendor
• ❌ A "generate my entire application" workflow

FounderOS sits above these tools.

It defines how AI participates in software engineering.

---

📁 Repository Structure

FounderOS/
│
├── README.md
│
├── docs/
│   ├── vision.md
│   ├── workflow.md
│   └── principles.md
│
├── agents/
│   ├── product/
│   │   ├── product-discovery-agent.md
│   │   └── prd-agent.md
│   │
│   ├── architecture/
│   │   ├── solution-architecture-agent.md
│   │   ├── database-design-agent.md
│   │   ├── domain-modeling-agent.md
│   │   ├── api-specification-agent.md
│   │   └── security-architecture-agent.md
│   │
│   ├── engineering/
│   │   ├── implementation-planning-agent.md
│   │   ├── backend-module-implementation-agent.md
│   │   └── frontend-module-implementation-agent.md
│   │
│   ├── frontend/
│   ├── ai/
│   └── shared/
│
├── templates/
│   ├── product-discovery-document.md
│   ├── prd.md
│   └── ...
├── playbooks/                 # Operational playbooks
├── examples/
└── assets/

---

🚦 Current Status

FounderOS is currently in early development.

Foundation

• ✅ Vision
• ✅ Engineering Workflow
• ✅ Engineering Principles

Product Agents

• ✅ Product Discovery Agent
• ✅ PRD Agent

Architecture Agents

• ✅ Solution Architecture Agent
• ✅ Database Design Agent
• ✅ Domain Modeling Agent
• ✅ API Specification Agent
• ✅ Security Architecture Agent

Engineering Agents

• ✅ Implementation Planning Agent
• ✅ Backend Module Implementation Agent
• ✅ Frontend Module Implementation Agent
• ✅ AI Module Implementation Agent
• ✅ Testing Agent
• ✅ Code Review Agent
• ✅ Release Agent

The role documents exist. Canonical workflow templates and initial operating playbooks are available; the reference project is a draft design walkthrough. See the FounderOS Completion Roadmap.

Start a project with the Quick Start, or review the Agent Catalog to see current workflow ownership and gaps.

---

🛣️ Roadmap

Phase 1 — Foundation

• Vision
• Workflow
• Engineering Principles
• Agent framework

Status: 🟢 Complete

---

Phase 2 — Product & Architecture

• Product Discovery
• PRD
• Solution Architecture
• Database Design
• Domain Modeling
• API Specification
• Security Architecture

Status: 🟢 Complete

---

Phase 3 — Engineering

• Implementation Planning
• Backend Module Implementation
• Frontend Module Implementation
• AI Module Implementation
• Testing
• Code Review
• Release

Status: 🟢 Complete

---

Phase 4 — Engineering Artifacts

Build canonical templates for:

• Product Discovery
• PRD
• Architecture
• Database
• Domain Model
• API
• Security
• Implementation Plan
• Testing
• ADRs

Status: 🟢 Complete

---

Phase 5 — Playbooks

Create reusable playbooks for:

• Engineering
• Security
• Deployment
• Operations
• Incident Response
• AI-assisted development

Status: 🟡 In Progress

---

Phase 6 — Reference Products

Build complete products using FounderOS from:

Idea
  ↓
Discovery
  ↓
Specification
  ↓
Architecture
  ↓
Planning
  ↓
Implementation
  ↓
Testing
  ↓
Release

Status: 🟡 In Progress

---

💡 Engineering Principles

FounderOS follows a few fundamental principles:

• Specification before implementation
• AI is part of the engineering team
• Product-first thinking
• Simplicity over unnecessary complexity
• Small, reviewable changes
• Security by design
• Documentation as a first-class artifact
• Explicit engineering decisions
• AI-assisted, human-approved
• Tools may change; engineering principles remain

See docs/principles.md.

---

🌟 Long-Term Vision

FounderOS is not intended to remain a prompt library.

The long-term vision is an AI Engineering Operating System where specialized AI engineering agents collaborate through structured artifacts, quality gates, and explicit handoffs.

Eventually, the workflow could look like:

founderos init
founderos discover
founderos specify
founderos architect
founderos plan
founderos implement
founderos test
founderos review
founderos release

The CLI is a future direction. The current focus is building the methodology and proving it with real projects.

---

🤝 Building in Public

FounderOS is an early-stage experiment.

The goal is to explore a simple question:

What happens when we give AI not just coding capabilities, but the engineering process of a high-performing software organization?

The framework is evolving through real projects, experiments, and feedback.

Ideas, criticism, contributions, and experiments are welcome.

---

⭐ The FounderOS Thesis

Don't give AI a prompt. Give AI an engineering system.

AI can generate code.

FounderOS provides the context, process, constraints, architecture, artifacts, and quality gates around that code.

---

Ideas Become Products.

Think • Specify • Build • Validate • Scale

FounderOS — The AI Engineering Operating System