Skip to content

Navigation Menu

Sign in
Sign up

Latest commit

History

31 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

πŸš€ FounderOS

FounderOS Banner

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

🧠 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/
β”œβ”€β”€ 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

πŸ›£οΈ 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: 🟑 In Progress


Phase 4 β€” Engineering Artifacts

Build canonical templates for:

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

Status: πŸ”΅ Planned


Phase 5 β€” Playbooks

Create reusable playbooks for:

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

Status: πŸ”΅ Planned


Phase 6 β€” Reference Products

Build complete products using FounderOS from:

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

Status: πŸ”΅ Planned


πŸ’‘ 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

About

Build production-grade software through Specification-Driven AI Engineering.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /