AI Startup Studio Brain

Documentation-first control plane for evaluating and managing solo micro-SaaS opportunities.

Eval engine v3-lite — see ADR. Studio venture path frozen: legacy-studio.md.

Philosophy

• Documentation first
• Business before code
• Evidence before opinions
• Portfolio management over emotional attachment
• Small experiments, fast validation, fast termination of weak ideas

Read docs/philosophy.md.

Decision Path (v3-lite)

Discovery → Validation → Fit and Decide → portfolio/micro-saas.md

Automation: Intake (PR open) → 1× cp:eval (full-run) → merge. docs/automations.md.

Stage	Prompt
Discovery	prompts/discovery.md
Validation	prompts/validation.md
Fit and Decide	prompts/fit-and-decide.md

Decision Thresholds

Decision	Criteria	Registry
BUILD_MICRO	Hard gates PASS + MSFI-lite ≥ 70 + live validation	portfolio/micro-saas.md Active
MONITOR_MICRO	Gates PASS + MSFI 50–69 or capacity_blocked	Monitoring
KILL_MICRO	Gate FAIL or MSFI < 50	Archived

Hard gates and MSFI-lite: playbooks/micro-saas-portfolio.md. CI: scripts/msfi_calculator.py.

Quick Start

1. Copy templates/opportunity-template.md → opportunities/OPP-YYYYMMDD-{slug}.md.
2. Run prompts in order (or use opp/pipeline automations).
3. Update portfolio/micro-saas.md.
4. Refresh metrics/portfolio.md.

Example: opportunities/_example-opportunity.md.

Repository Structure

Folder	Description
prompts/	Versioned AI prompts
opportunities/	One markdown file per opportunity
portfolio/micro-saas.md	Canonical registry
playbooks/	Evaluation and portfolio rules
metrics/	Lightweight KPIs
docs/decisions/	Architecture decision records

Standards

• AGENTS.md
• CONVENTIONS.md
• CONTRIBUTING.md

Production bootstrap: docs/prod-cutover.md.

Roadmap: docs/roadmap.md · BUILD handoff: playbooks/build-handoff.md

Control plane vs product repos

This repo decides only (BUILD_MICRO / MONITOR_MICRO / KILL_MICRO). Each BUILD_MICRO gets its own product repository for vision, docs, and code. ADR: docs/decisions/2026-07-control-plane-vs-product-repo.md.