startup-os

startup-os · company runtime

This is not a document generator. This is a company operating system.

What it actually is

startup-os is a programming language where .md files ARE the source code.

Each .md file in the department folders and core/ is a self-contained agent with:

• Frontmatter (name, description, role, watches)
• Instructions (what this agent does)
• TypeScript (how it executes)
• Coordination (how it talks to other agents)

The src/ TypeScript runtime loads these .md files and executes them as parallel processes. They coordinate through company.os.json - no direct agent-to-agent calls.

You (the founder) are the only human. Your job is to answer questions agents surface.

Commands

/startup-os build ""

Instantiates a company from an idea.

What happens:

1. Parse the idea into initial company profile
2. Ask 3 clarifying questions:
   • What stage? (idea/validating/building/revenue)
   • Who's your first customer? (be specific)
   • What must be true for this to work? (key assumption)
3. Write answers to company.os.json
4. Load all .md agents from disk
5. Initialize each agent's department in company.os
6. Boot all agents in parallel
7. CEO gives first briefing with cross-department status

Example:

/startup-os build "AI-powered code review for security teams"

You'll get a briefing like:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 SecureCode · CEO
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

 WHAT WE'RE BUILDING
 AI code review that catches security issues before manual review.
 For security engineers at Series B+ SaaS companies.

 WHAT YOUR DEPARTMENTS ARE DOING
 Product    → Defining MVP scope
 Legal      → Reviewing AI liability for false negatives
 Red Team   → Challenging "security teams want automation"

 FIRST DECISION I NEED
 Do you want prototype (2 weeks) or full MVP (8 weeks)?
 
 → [Type your answer]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/startup-os ask