🏢 founder-os

Run your B2B SaaS startup like code. An agentic operating system you run inside Claude Code.

Gestisci la tua startup B2B SaaS come se fosse codice. Un sistema operativo agentico che vive dentro Claude Code.

🇬🇧 English

founder-os turns your repository into the single source of truth for your company. Instead of scattered docs, you get a team of AI agents — CEO, Product, CTO, Marketing, Sales, CFO, HR, Legal, Chief of Staff — that read shared company context, execute structured commands, write traceable outputs, and commit them to git.

Everything is plain Markdown. Every action produces a file. Every file is versioned.

Quick Start

1. Clone this repo and open it in Claude Code (CLI, desktop, or IDE extension).
2. Run the setup wizard:

   /setup
   

   It asks ~10 questions and fills in your company identity, team, vision, segments, roadmap, KPIs, and routine cadence — one step at a time.
3. Start working:

   /routine start        # your guided daily/weekly session
   /pm write-spec        # invoke the Product Manager
   /sales pipeline-review # invoke Sales
   

Not sure what good looks like? See examples/acme-demo/ — a fully filled-in fictional company you can read or copy from.

Demo

you ▸ /setup

🚀 Onboarding Agent
   Welcome to founder-os! I'll ask ~10 questions (5 min) to configure the system.
   Detected machine: MacBook Pro M3 — registered.
   First: what's your name?

you ▸ Mario Rossi

   Step 1 — Company identity. What's your company called?
you ▸ Acme
   One-liner — what do you do, in one sentence?
you ▸ The onboarding-automation platform for B2B SaaS companies.
   ... (8 more steps: team, vision, segments, roadmap, KPIs, cadence, integrations)

✅ Setup complete. Try:  /routine start  ·  /pm write-spec  ·  /sales pipeline-review

you ▸ /pm write-spec

🎯 Product Manager
   Reading COMPANY.md, vision, roadmap... drafting a PRD for "bulk import".
   → wrote company/product/specs/bulk-import.md
   → committed:  [pm] spec: PRD for bulk import

Every command reads your shared context, writes to the right folder, and commits — so your company's history lives in git.

What's inside

How it works

You: "/pm write-spec"
  → Claude reads .agents/product-manager/AGENT.md and becomes the PM
  → loads shared context (.agents/_shared/) + relevant company/ data
  → executes the command, writes output to the right folder
  → commits:  [pm] spec: <description>

The rules that govern all of this live in CLAUDE.md.

License & support

MIT — see LICENSE. Use it, fork it, make it yours. Provided as-is: no guaranteed support, no promised updates. Open an issue if something's broken, but treat this as a starting point you own, not a maintained product.

Where this comes from

I run my own company on a version of this system, and write about it (the design choices, what works, what rots) in my newsletter. If you want the story behind the structure, start with the build-it-from-scratch guide.

🇮🇹 Italiano

founder-os trasforma il tuo repository nel single source of truth dell'azienda. Al posto di documenti sparsi, hai un team di agenti AI — CEO, Product, CTO, Marketing, Sales, CFO, HR, Legal, Chief of Staff — che leggono il contesto condiviso, eseguono comandi strutturati, producono output tracciabili e li committano su git.

Tutto è Markdown. Ogni azione genera un file. Ogni file è versionato.

Avvio rapido

1. Clona questo repo e aprilo in Claude Code.
2. Lancia il wizard di setup:

   /setup
   

   Ti fa ~10 domande e compila identità azienda, team, vision, segmenti, roadmap, KPI e cadenza — un passo alla volta.
3. Inizia a lavorare:

   /routine start         # la tua sessione guidata
   /pm write-spec         # invoca il Product Manager
   /sales pipeline-review # invoca Sales
   

Vuoi vedere un esempio già compilato? Guarda examples/acme-demo/.

Primi file (se preferisci compilare a mano invece di /setup)

1. ⭐ .agents/_shared/COMPANY.md — Chi sei
2. ⭐ company/strategy/vision.md — Dove vai
3. .agents/_shared/TEAM.md — Il team
4. company/customers/segments.md — Per chi lavori
5. company/metrics/kpis.md — Come stai andando

Licenza e supporto

MIT — vedi LICENSE. Te lo do com'è: nessun supporto garantito, nessun aggiornamento promesso. Apri pure una issue se qualcosa è rotto, ma trattalo come un punto di partenza che possiedi, non come un prodotto mantenuto.

Da dove arriva

Mando avanti la mia azienda su una versione di questo sistema, e ne scrivo (le scelte di design, cosa funziona, cosa marcisce) nella mia newsletter. Se vuoi la storia dietro la struttura, parti dalla guida che spiega come costruirlo da zero.

_{Built with Claude Code. Originally extracted and fully anonymized from a real seed-stage B2B SaaS operating system.}