MDX Limo
The Optimus Operating System — Goal-Driven Agent Teams

The Optimus Operating System — Goal-Driven Agent Teams

Date: 2026-08-05 · Status: Research complete, design proposal Companion docs: agent-architecture-research.md (runtime & control plane) · primedocs-agent-architecture.md (first team) Inputs: research into how elite startup teams operate (OKRs, Amazon WBR/Working Backwards, Lean Startup, high-tempo testing, Shape Up, EOS, The Cadence, Rumelt) + goal/experiment/learning primitives across the reference repos (mastra, yalc, eve, gtm synthesis) + evidence from AI-agents-running-businesses (Anthropic Project Vend, TheAgentCompany benchmark).


Table of contents

  1. The thesis
  2. How elite startup teams actually operate
  3. What the reference repos validate (and what nobody has built)
  4. The Optimus data model: eight objects
  5. The operating cadence
  6. The bootstrap: goal + URL → a working company
  7. Honest measurement: keeping a self-improving system truthful
  8. The interface: a startup cockpit, not an agent dashboard
  9. How this layers onto the existing architecture
  10. What transfers from human teams — and what deliberately doesn't
  11. Build implications & sequencing
  12. Source index

1. The thesis

Every agent product on the market models work (tasks, sessions, runs). Optimus models purpose — the reason work exists:

1Typical agent app: Task → Run → Output → done 2Optimus: Goal → Strategy → Hypothesis → Experiment → Result → Learning 3 ↑_____________________________________________________| 4 the loop that compounds

This mirrors the actual mechanism behind elite startups. The research is unambiguous: what separates the best teams is not talent but iteration velocity against an explicit goal tree with honest measurement — YC measures startups by weekly growth rate (Startup = Growth); David Sacks argues the operating cadence itself is the moat ("you will ship four great quarters per year" — The Cadence); Amazon runs the whole company as a weekly input-metrics review (WBR).

Agents change the economics of this loop in two ways:

  1. Iteration is nearly free — an agent team can run the weekly startup cadence at 5–10× compression (daily experiment cycles, weekly human review).
  2. Memory is perfect — a learn library that humans maintain badly is an append-only table agents maintain flawlessly. Anthropic's Project Vend found exactly this: structured business scaffolding (CRM, cost-visible inventory, enforced verification steps) was the single biggest performance unlock, taking the shop from comic failure to 208% of revenue target (Project Vend 2).

So Optimus's differentiator is not "manage agents" — it's "run the elite-startup operating system, staffed by agents, supervised by you." The interface is a founder's cockpit: goal tree, metrics deck, experiment board, decision log — with the team view and inbox we already designed underneath it.

One design tension governs everything below: the "surprise me" requirement (goal + URL in → working system out) pulls against the "manager control" requirement. The resolution: the system always plans in the open. It drafts strategy, goals, metrics, team, and first bets as reviewable artifacts; you edit and approve; it then runs autonomously within the approved frame; every structural change flows back through the same propose → review loop. The magic moment is not the system acting mysteriously — it's watching it produce a plan good enough that you barely edit it.


2. How elite startup teams actually operate

The frameworks converge far more than their branding suggests. The operationalizable mechanics:

2.1 Goals: OKR mechanics + the driver tree

  • OKRs as practiced: 3–5 qualitative Objectives per level, each with 3–5 quantitative Key Results tagged committed (expect 1.0) vs aspirational (expect ~0.7); scored 0–1 at cycle end; weekly check-ins flag green/yellow/red. Failure modes to design against: business-as-usual OKRs, KRs that don't actually add up to the objective, set-and-forget (WhatMatters: grading, common mistakes).
  • North Star framework: one metric expressing realized customer value, decomposed into 3–5 controllable input metrics (breadth/depth/frequency/efficiency) — a driver tree where every experiment links to the input it should move (Amplitude, playbook).
  • Amazon's input/output distinction is the same idea sharpened: output metrics (revenue) can only be influenced; controllable input metrics ("add 500 products", "publish 3 guides") can be moved. Teams work on inputs, review outputs (Commoncog WBR).
  • Above goals sits strategy — Rumelt's kernel: diagnosis → guiding policy → coherent actions. Goals without a diagnosis is his #1 bad-strategy anti-pattern (Good Strategy Bad Strategy notes). This matters for Optimus: "hit $10k MRR" alone is not enough for the system to plan against; it needs the diagnosis ("distribution is the bottleneck; the catalog converts fine") to generate coherent bets.

2.2 The experiment loop: hypothesis → test → learning

  • Lean Startup's innovation accounting: establish a baseline → every initiative must move a driver from that baseline → periodic pivot-or-persevere decision. Unit of progress = validated learning, vanity metrics banned (leanstartup principles).
  • High-tempo testing (Sean Ellis): a shared ideas backlog anyone can submit to → ICE scoring (Impact/Confidence/Ease) → weekly growth meeting picks tests → every result lands in a learn library. Test tempo is itself a tracked meta-metric (high-tempo testing, ICE).
  • The canonical hypothesis card (First Round growth sprints):

    "We believe [assumption, backed by evidence]. To test this we will [action]. We predict [metric] moves by [amount]. If right we will [double down]; if wrong we will [alternative]." plus a falsifier, minimum sample / stop rule, and a link to the driver-tree node it serves.

  • Experiment-platform hygiene (GrowthBook): primary metric (the decision criterion) vs secondary metrics (learning) vs guardrail metrics (protect from harm); minimum runtime + minimum sample to prevent peeking; stop early only if a guardrail goes statistically negative; every finish records a decision + observations.
  • Growth loops, not funnels (Reforge): model the business as closed loops (content → traffic → buyers → reviews/data → better content) and aim experiments at the loop's rate-limiting step.

2.3 Cadence: the heartbeat

  • Amazon WBR: metrics auto-generate Sunday night → owners annotate anomalies → Wednesday review that is exception-driven (seconds on green, all time on variance); charts show 6-week and 12-month trails side-by-side with target lines (Commoncog).
  • EOS Level 10 meeting — the small-company version, 90 minutes, fixed agenda: scorecard (on/off-track only) → quarterly rocks (on/off-track only) → to-dos (~90% weekly completion expected) → IDS: rank issues, root-cause the top one, solve = a to-do with an owner (EOS).
  • Shape Up: appetite (how much time a problem is worth — fixed time, variable scope), the betting table (unchosen pitches expire — no standing backlog rot), and the circuit breaker (work that doesn't ship in its cycle doesn't auto-renew; it must re-earn its bet) (Shape Up).
  • YC discipline: one primary metric, tracked weekly, never switched when it looks bad; the growth rate is the number (PG). Lean Analytics adds: the One Metric That Matters changes by stage — draw a line in the sand, move on when the stage changes (OMTM).

2.4 Decisions & accountability

  • DRI / single-threaded owner: exactly one named owner per goal, metric, project (Apple's DRI, Amazon STL).
  • One-way vs two-way doors + 70% rule: reversible decisions get made fast by individuals at ~70% of desired information; irreversible ones get deliberation. Disagree-and-commit with recorded dissent (Bezos 2016 letter).
  • Written narratives for big bets: Amazon PR/FAQ — write the press release before building; five gate questions; "most PR/FAQs don't get approved is a feature, not a bug" (Commoncog PR/FAQ). Pre-mortems improve risk identification ~30% for 20 minutes of work (HBR).
  • Opportunity Solution Trees (Teresa Torres): outcome → evidence-backed opportunities → always ≥3 candidate solutions → assumption tests. Her #1 failure mode: inventing opportunities without evidence — a known LLM weakness, so Optimus must require evidence links on every opportunity (Product Talk).

2.5 The agent-specific evidence

  • Project Vend (Claude running a real business): structured records + procedurally enforced verification transformed performance; role specialization beat a unified agent; a "CEO agent" on the same model shared the same deficiencies (hierarchy doesn't fix model weaknesses); persistent failure modes were sycophancy, discount manipulation, contract naivete → human oversight of one-way doors remains essential (Project Vend 2).
  • TheAgentCompany benchmark: best agents complete only ~30% of long-horizon company tasks; they abandon tedious multi-step chains → decompose work into short, verifiable, checkpointed units (arXiv 2412.14161). This independently confirms Shape Up's circuit-breaker logic for agents.

3. What the reference repos validate (and what nobody has built)

The corpus contains every piece of the goal-driven loop, shipped and tested — but scattered across different repos, never unified.

Validated, with working reference implementations

ConceptProofWhere
Durable goal judged in-loop with a budgetMastra's goal subsystem: {objective, status: active|paused|done, runsUsed, maxRuns}; tri-state judge decision done/continue/waiting where the judge's reason is sent back as the agent's next instruction; judge failure → paused, never crash-loop; budget exhaustion → parkedmastra/packages/core/src/agent/goal/objective.ts, scorer.ts; storage shape at storage/domains/thread-state/base.ts:31-54
Campaign-as-hypothesisyalc's Campaign: hypothesis + SuccessMetric {metric, target, baseline, actual} + HypothesisVerdict {confirmed|disproven|inconclusive, evidence} — "turns an automation from a procedure into an experiment"yalc/src/lib/campaign/types.ts
Statistically gated kill/promoteyalc: chi-squared significance with minimum-sample gate on top of the p-value (p<0.05 && n≥30), minSampleNeeded tells you how much longer to run, auto-retire loser / declare winneryalc/src/lib/campaign/significance.ts, tracker.ts:693-720
Learning with a confidence lifecycleyalc's Intelligence: evidence[], confidence as lifecycle (hypothesis → validated → proven), biasCheck, supersedes (versioned replacement, not mutation), expiresAt; prompt injection reads proven+validated only, never hypothesesyalc/src/lib/intelligence/types.ts, confidence.ts, store.ts:133
Proposal object with executable actionyalc's Nudge: insight → recommendation → evidence[] (real numbers required) → projected impact → executable action (endpoint+body) → show-me-the-data linkyalc/src/lib/campaign/optimizer.ts
Quality ≠ completion, scored on 4 horizonsGTM synthesis Scorecard: structural / judgment / operational / business horizons; delayed sensors append scores to the original run lineageagentic-gtm-reference/analysis/gtm/synthesis/PRIMITIVES.md:148-159
Three-valued outcomes, never booleansIndependently converged: confirmed/disproven/inconclusive (yalc), done/continue/waiting (mastra), passed/scored/failed (eve evals), completed/failed/uncertain (gtm synthesis)throughout
Severity on the assertioneve evals: .gate() hard-fails, .soft() tracks, .atLeast(n) soft-with-a-bar — the model for experiment acceptance criteriaeve/docs/evals/assertions.mdx
Immutable-once-approved plan with stop conditionsGTM synthesis Plan: assumptions, cost envelope, pilot, stop conditions, frozen at approvalPRIMITIVES.md:186

Explicitly missing everywhere (Optimus's invention list)

  1. Goal hierarchy. Mastra's objective is flat and single. No parent/child, no milestone rollup, no "sub-goal done ⇒ advance parent" — anywhere.
  2. Hypothesis as a first-class entity with a lifecycle. yalc's hypothesis is a text column. proposed → evaluated → approved → running → won/lost/killed exists nowhere; the pieces (Nudge = proposal, Plan = frozen approval, Verdict = terminal state) live in three different repos.
  3. Delayed-outcome attribution. The gtm synthesis lists it under "required before production" — future tense. The known open question: which outcome joins belong in operational events vs an analytics ledger.
  4. Learning → versioned behavior change. Universally prescribed (invariant #10: "Learning proposes a new version; it does not silently mutate live prompts, guards, or provider order"), universally unimplemented. Nobody evaluates a proposed change against historical runs before promoting it.
  5. Goal-level scoring across horizons — rolling run-level scorecards up to the goal that motivated them.

Two warnings the corpus repeats: every metric needs a named consumer at design time (yalc collected provider-quality scores nothing ever read), and never overwrite history (gtm-pipeline overwrites stage state and therefore can't attribute anything — append-only from day one).


4. The Optimus data model: eight objects

The startup frameworks and the repo primitives converge on the same canonical objects. These become new storage domains in the control plane (see architecture doc §4), and — like agents and skills — their definitions live as reviewable files in the project directory, with SQLite owning execution state.

4.1 Strategy (per project; singleton; revised rarely)

Rumelt's kernel + Working Backwards, as a living document the whole team reads:

1strategy: 2 diagnosis: # what's really going on; the critical constraint 3 guiding_policy: # the approach; what we will and won't do (values/guardrails) 4 action_themes: # 2-4 coherent thrusts (e.g., "own Pinterest distribution") 5 moat: # the chosen defensibility (PrimeDocs doc §8.3 already demands this) 6 version, approved_by, approved_at # immutable once approved; changes = new version

Every goal must trace to the strategy; every hypothesis must name the action theme it serves. This is what makes the system's behavior legible — the "perfect clarity on why it's doing what it's doing" you asked for starts here, not in run logs.

4.2 Goal (tree)

OKR-shaped, hierarchy added (the thing no reference implements):

1goal: 2 id, parent_id # tree: company goal → sub-goals → milestones 3 objective # qualitative ("Reach $10k MRR by Dec 31") 4 key_results[] # {metric_id, baseline, target, current, deadline, 5 # type: committed|aspirational} 6 owner_agent # DRI — exactly one (can be YOU for reserved goals) 7 status: draft → active → achieved | missed | abandoned 8 score # 0–1 at cycle end (KR average), for calibration 9 cycle # quarter/6-week window it belongs to 10 budget # spend + run allowance for work under this goal 11 source: human | agent # who proposed it (agents propose; approval makes it real)

Mechanics from the references: judged like Mastra goals (an independent judge evaluates progress in-loop, with maxRuns-style budgets so pursuit can't spin forever); scored like OKRs (expect ~0.7 on aspirational; consistent 1.0 = the system is sandbagging its own targets — recalibrate).

4.3 Metric (the driver tree — the spine of the whole system)

Amazon's taxonomy + Amplitude's tree + EOS's scorecard row, one object:

1metric: 2 id, name # "revenue", "non-brand organic sessions", "products live" 3 type: north_star | output | input | guardrail | health 4 parent_id # driver tree: input rolls up to output rolls up to NSM 5 owner_agent # who is accountable for moving it 6 source # HOW it's measured: connector (Stripe MCP, PostHog, 7 # Supabase query) + refresh schedule — never self-reported 8 target # current line-in-the-sand + deadline 9 series # append-only weekly/daily observations 10 status: on_track | off_track | no_data # exception-driven review needs only this

PrimeDocs example tree: revenue/1k sessions (north star) ← sessions × conversion × AOV (outputs) ← products live, guides published, pins scheduled, email list size, bundle attach rate (controllable inputs, each owned by the agent who moves it). Rule: agents work on inputs; outputs are reviewed, not assigned — this single distinction prevents most goal-gaming.

4.4 Hypothesis (the idea card — the unit of team intelligence)

The First Round card + yalc's Nudge + ICE + Shape Up appetite, unified with a real lifecycle:

1hypothesis: 2 id, goal_id, metric_id # must name the driver-tree node it moves 3 belief # "We believe X" — with evidence[] links (REQUIRED; 4 # Torres's rule: no evidence, no opportunity) 5 proposal # "We will do Y" — concrete enough to execute 6 prediction # "Metric Z moves by W within T" 7 falsifier # the result that disproves it 8 stop_rule # min sample / max duration / max spend 9 ice: {impact, confidence, ease} # scored for backlog ranking 10 appetite # what this idea is WORTH (time/spend), not what it costs 11 door: one_way | two_way # reversibility class → approval routing 12 proposed_by # agent or you 13 status: proposed → scored → approved | declined | expired 14 → running → confirmed | disproven | inconclusive → archived 15 narrative # for big bets only: PR/FAQ-style memo + pre-mortem

Lifecycle rules from the research: the backlog is ICE-ranked and expiring (Shape Up: unchosen pitches die — no backlog rot; declined ideas archive with a reason, teaching proposers); big bets require a written narrative and pre-mortem before approval — cheap for an LLM, and "most PR/FAQs die" is precisely the filter needed against agent idea-spam; two-way-door hypotheses within appetite can auto-approve at higher autonomy tiers, one-way doors always queue for you.

4.5 Experiment (execution record of an approved hypothesis)

GrowthBook-shaped, run by the existing run machinery:

1experiment: 2 id, hypothesis_id 3 design # variants/allocation, or pre-post with baseline 4 primary_metric # THE decision criterion (one) 5 guardrail_metrics[] # stop early only if one goes statistically negative 6 min_sample, min_duration # anti-peeking gates 7 runs[] # links into the run graph (the attribution spine) 8 result # observed deltas, sample sizes, significance 9 verdict: confirmed | disproven | inconclusive # never a boolean 10 decision: double_down | iterate | kill # pivot-or-persevere, recorded

Kill/promote follows yalc's discipline: significance requires p < 0.05 and minimum sample; below sample, the honest state is "keep running — need N more," never a verdict. The Analyst-role agent, not the proposer, computes results (see §7).

4.6 Learning (append-only learn library — the compounding asset)

yalc's Intelligence shape, with its known epistemic bugs fixed:

1learning: 2 id, insight # one claim, specifically stated with numbers 3 category # icp | channel | content | pricing | timing | ops | ... 4 evidence[] # {experiment_id/run_id, metric, value, sample_size, at} 5 confidence: hypothesis → validated → proven # lifecycle, not a float 6 scope # segment/channel it applies to (learnings are local!) 7 supersedes # versioned replacement, never mutation 8 expires_at # truths about 2026 Pinterest ≠ truths about 2027 9 consumed_by # which prompts/policies READ this (metrics need consumers)

Promotion rules (fixing yalc's shortcuts, per its own postmortem): promotion requires independent evidence with adequate samples — never "2 entries ⇒ validated," and never access-frequency-as-truth. Only validated+proven learnings are injected into agent context (via the scoped memory system already designed), tagged with the standing trust boundary: facts, never instructions.

4.7 Decision (the decision log)

1decision: 2 question, context_links 3 door: one_way | two_way 4 options_considered[] # ≥3 for one-way doors (Torres's compare-alternatives rule) 5 dissent[] # recorded disagree-and-commit — agent dissent is audit gold 6 decided_by # you, or an agent within its tier 7 memo # narrative for one-way doors 8 outcome_review_at # scheduled retrospective ("was this right?")

This is what gives you "perfect clarity why the system did what it did" months later — and it's training data for improving the team's judgment.

4.8 Owner (DRI binding)

Not a new table — a constraint: every goal, metric, hypothesis, and experiment carries exactly one owner_agent. Project Vend's evidence says specialization beats generalists; the DRI rule is how specialization stays crisp. Some ownership is reserved to you (strategy approval, one-way doors, brand) — same as PrimeDocs Tier 3.

How the objects wire together

1STRATEGY (diagnosis → policy → themes) [you approve] 2 │ traces to 3 GOAL TREE (objectives + KRs on metrics) [you approve top; agents propose subs] 4 │ targets 5 METRIC DRIVER TREE (NSM ← outputs ← inputs) [connectors measure; never self-report] 6 ▲ moves │ informs 7 EXPERIMENTS ◄── approved ── HYPOTHESIS BACKLOG (ICE-ranked, expiring) 8 │ produce ▲ proposes 9 LEARNINGS (append-only, confidence lifecycle) ──┘ (feeds better hypotheses) 10 │ propose versioned changes to 11 SKILLS / POLICIES / STRATEGY (never silent mutation → new version → review)

5. The operating cadence

The heartbeat that makes the objects live. Human frameworks compress well because agent iteration is cheap — but the human ritual stays weekly (your attention is the scarce resource, and most business metrics need days of data anyway).

Daily (automated — the system's pulse)

  • Metrics refresh from connectors; owners annotate variances (Amazon's "owners investigate before the review").
  • Experiment monitors check stop rules and guardrails; anything tripping a guardrail pauses and files to your inbox.
  • Agents work their approved experiments and standing duties (support, QA, publishing) through the normal run/trigger machinery.

Weekly (the review — your one ritual, ≤30 minutes)

This is Amazon's WBR + EOS L10 + the growth meeting fused into one generated document + one approval session — it replaces the generic "digest" from the UX design with something far stronger:

  1. Scorecard pass — driver tree with on/off-track flags only; exceptions get one-line owner annotations. (Seconds on green. All attention on variance.)
  2. Goal pass — each active goal: on/off-track, KR progress bars.
  3. Experiment results — every finished experiment: verdict + proposed decision (double-down / iterate / kill) + the learning it minted.
  4. Betting table — the top of the ICE-ranked hypothesis backlog sized against available capacity/budget; you approve/decline/edit next week's bets. Unchosen ideas age toward expiry.
  5. Issues (IDS) — the top off-track items root-caused, each resolving to an owned action.
  6. Decisions needed — the one-way doors, with memos.

Most of this document is pre-decided — you're reviewing exceptions and placing bets, not reading logs. Target: the whole weekly review is 15–30 minutes of your time, exactly like the PrimeDocs "Operator brief" but rigorously structured.

Cycle (6 weeks, aligned to Shape Up rather than quarters — agent-speed)

  • Grade goal KRs 0–1; calibrate (consistent 1.0 = targets too soft).
  • Pivot-or-persevere per goal: the innovation-accounting question — are experiments moving the drivers from baseline? If not, the strategy diagnosis is wrong, and that's a strategy-revision proposal, not another experiment.
  • Circuit breaker: workstreams that didn't ship don't auto-renew; they re-earn a bet.
  • Set next cycle's goals (agents draft from learnings + backlog; you approve).

The stage-awareness rule

Lean Analytics: the One Metric That Matters changes by stage. Pre-launch PrimeDocs's NSM is not revenue — it's "QA-passed products live" (supply). Post-launch it becomes revenue/1k sessions. Optimus should model stage explicitly on the project and let the system propose the NSM transition — a strategy-level, you-approve decision.


6. The bootstrap: goal + URL → a working company

The "surprise me" flow, structured as Working Backwards so it's magical and controllable. Input: a goal, plus a URL / repo / description. Output: a fully drafted operating system, presented for review before anything runs.

Phase 1 — Diagnose (system works, you wait ~minutes). Deep analysis of the asset: crawl the site, read the repo, pull whatever connectors exist (Stripe, analytics, Supabase). Competitive scan. Output: a Diagnosis memo — where the business is, what the constraint is, what the data says. (This is Rumelt's kernel step one, and it's exactly what Claude with web + MCP access is spectacular at.)

Phase 2 — Propose (the reveal moment). The system presents, as one reviewable package:

  • Strategy kernel (diagnosis → guiding policy → action themes → recommended moat)
  • Goal tree with KRs ("$10k MRR by Dec" decomposed into staged sub-goals)
  • Metric driver tree, with which connectors it will measure each node from
  • The team: agent roster with charters, mapped to metric ownership (this is where the PrimeDocs 11-agent architecture gets generated rather than hand-designed)
  • The first betting table: 5–10 ICE-scored hypotheses with appetites
  • The autonomy proposal: which action types start at which tier

Phase 3 — Review & edit (you, ~20 minutes). Everything editable — rename agents, delete goals, tighten budgets, veto bets. Approval freezes v1 of strategy/goals/team (immutable-once-approved; changes are new versions).

Phase 4 — Run. Team instantiates (project directory, agents, triggers, memory), first experiments launch, the weekly cadence begins.

Two rules keep the surprise honest: every claim in the diagnosis carries evidence links (Torres's rule, enforced structurally — no invented opportunities), and the system proposes less autonomy than it could (progressive delegation: tiers loosen with your approval history, per PrimeDocs §5 and the UX research on trust adoption).


7. Honest measurement: keeping a self-improving system truthful

The failure mode that kills this product is not agents doing too little — it's the system manufacturing false progress. An agent that grades its own experiments will produce a beautiful dashboard of fictional wins. Structural defenses, all validated by the research:

  1. Metrics come from connectors, never from agent self-report. Revenue from Stripe MCP, traffic from analytics, catalog counts from Supabase queries. Amazon's equivalent: finance independently audits WBR metrics. An agent may annotate a metric; it may never write one.
  2. Proposer ≠ judge, structurally. The agent that proposed a hypothesis never computes its result; the Analyst role owns verdicts (same separation as Maker/Auditor). Mastra's goal judge runs as its own forked context with its own tools — copy that shape.
  3. Statistical gates are code, not prompts. yalc's p<0.05 && n≥30 + minSampleNeeded; below sample, the only legal verdict is inconclusive — keep running. PrimeDocs already demands this ("no directional claims below 100 conversions/arm"); it lives in the experiment engine, not in the Analyst's charter.
  4. Guardrail metrics on every experiment — the agent optimizing pin volume must be stopped by the refund-rate guardrail, automatically.
  5. Learnings expire and are scoped. Confidence is a lifecycle earned through independent evidence; stale truths age out (yalc's expiresAt), and a learning about wedding templates doesn't leak into the resume category (scope field).
  6. Learning proposes versioned change, never silent mutation — invariant #10, the corpus's most-repeated rule. When a learning implies "change the pricing skill," that's a diff on a file in the project repo, reviewed like any PR. Version history + regression against historical runs = the path to safe self-improvement, and it's ahead of every reference repo.
  7. Anti-sycophancy in the weekly review. Project Vend's core failure was the agent telling people what they wanted to hear. The agent equivalent of gaming the scorecard is flattering the founder. Defenses: the review template requires a "what's off-track / what I'd kill" section; output metrics are computed, not narrated; and the review generator's charter explicitly rewards surfacing bad news early (with your consistent behavior backing it — don't shoot messengers).

8. The interface: a startup cockpit, not an agent dashboard

This extends the decided IA (inbox-first home, professional-team metaphor, agent-centric objects — see memory/UX decisions). The goal layer adds the missing "why" above the team layer. Revised screen map:

1┌───────────┬──────────────────────────────────────────────────────┐ 2│ OPTIMUS │ MISSION (per project) — the new center of gravity │ 3│ │ ┌──────────────────────────────────────────────────┐ │ 4│ Inbox ③ │ │ GOAL: $10k MRR by Dec 31 ▓▓▓▓▓░░░░░ 42% │ │ 5│ Mission │ │ on track · 17 wks left · burn: 61% of weekly quota│ │ 6│ Team │ ├───────────────┬──────────────────────────────────┤ │ 7│ Experiments│ │ DRIVER TREE │ revenue/1k sess ▁▂▂▃▃▅ ↗ on │ │ 8│ Activity │ │ (metric │ sessions ▂▂▃▃▂▅ ↗ on │ │ 9│ │ │ sparklines, │ conversion ▃▃▃▂▂▂ → watch │ │ 10│ PROJECTS │ │ on/off │ products live ▅▅▆▆▇▇ ↗ on │ │ 11│ primedocs│ │ flags) │ email list ▁▁▂▂▂▂ ✕ OFF │ │ 12│ │ ├───────────────┴──────────────────────────────────┤ │ 13│ │ │ RUNNING BETS (4) │ BACKLOG (top of 23) │ │ 14│ │ │ ⚗ $49 price tier │ ◆ 8.1 Pinterest fresh │ │ 15│ │ │ n=61/100 · d3/14 │ pins daily (2-way) │ │ 16│ │ │ ⚗ bundle discount 25% │ ◆ 7.4 free→paid email │ │ 17│ │ │ guardrail: refunds✓ │ revamp (2-way) │ │ 18│ │ └───────────────────────┴──────────────────────────┘ │ 19└───────────┴──────────────────────────────────────────────────────┘

Mission (new home for an active project) — goal progress, driver tree with sparklines and on/off-track flags (the WBR deck rendered live), running experiments with sample/duration progress, top of the betting backlog. This answers "how's the business?" in five seconds — the founder-cockpit view. The timeline lives here too: cycles, milestones, experiments, and decisions on one horizontal track (the PM-style view you described).

Experiments — the board: backlog (ICE-ranked, expiring) → running (with stop-rule progress) → verdicts → learn library. Each card is the full hypothesis card; each verdict links its learning; the learn library is browsable/searchable (your compounding asset made visible).

Inbox — unchanged grammar (notify/question/review), but the weekly review becomes its anchor artifact: one generated document, sections pre-structured (scorecard exceptions → experiment verdicts → betting table → one-way doors), each item actionable inline. Daily inbox handles the trickle; the weekly review handles the batch.

Team — as designed, with one addition per agent card: what it owns (metrics + goals), because ownership is now the organizing principle.

Why this wins: management interfaces for agents all answer "what is the system doing?" Optimus answers "is the business working, why, and what are we betting on next?" — with the agent machinery one drill-down below. That's the difference between a thousand agent dashboards and a company cockpit.


9. How this layers onto the existing architecture

No revisions to the runtime/control-plane decisions — this is a layer above it:

  • New storage domains: strategy, goals, metrics (+series), hypotheses, experiments, learnings, decisions — same domain-decomposed SQLite pattern.
  • Definitions as files, state in SQLite (same rule as agents/skills): strategy kernel, goal definitions, hypothesis narratives live in the project repo (reviewable, diffable, versioned — which is what makes "learning proposes versioned change" natural); series data, run links, verdicts live in the DB.
  • The Optimus MCP server grows goal-layer tools: propose_hypothesis, record_evidence, get_driver_tree, get_learnings(scope), log_decision, request_metric_annotation. Agents interact with the operating system the same way they interact with memory — through control-plane tools with policy gates.
  • Metric connectors are scheduled runs against MCP servers (Stripe, Supabase, analytics) writing to the append-only series — built on the existing trigger/run machinery, no new execution paths.
  • The experiment engine is code, not an agent: stop rules, significance, guardrail checks run in the control plane (the "daemon owns transitions" rule from the architecture doc, applied to science).
  • Autonomy tiers gain the door dimension: two-way-door actions within an approved experiment's appetite auto-execute at Tier 1+; one-way doors are Tier 2+ regardless of agent. This refines PrimeDocs §5 rather than replacing it.
  • The weekly review generator is itself an agent (Operator/Analyst role) — but it can only assemble and annotate computed facts, never originate numbers.

Revised build note: the original Phase 4 ("first real team") now becomes Phase 4: goal layer MVP — goals + metrics + hypothesis backlog + weekly review — because the PrimeDocs team should be born from the bootstrap flow, not hand-assembled. A pragmatic MVP slice: one goal, a 5-node driver tree with 2 connectors (Stripe + analytics), the hypothesis board, and the generated weekly review. That alone is differentiated.


10. What transfers from human teams — and what deliberately doesn't

Transfers directly (they're basically software specs): the WBR metrics engine (input/output taxonomy, dual-window charts, exception-driven review); ICE-scored expiring backlogs; the hypothesis card with falsifier + stop rule; guardrail metrics; the learn library; DRI ownership; one-way/two-way doors + decide-at-70%; appetite + circuit breaker (the direct countermeasure to agents abandoning long-horizon work); PR/FAQ + pre-mortem for big bets; one primary metric never switched when it looks bad.

Deliberately does not transfer: motivation psychology (stretch-goal 0.7 scoring rationale, compensation decoupling — keep the scoring math only, for calibration); meeting theater (silent reading, segues, meeting ratings — keep the artifacts the rituals produce: the memo, the log, the review doc); trusting self-report as accountability (humans feel accountable; agents need independent verification — §7); emotional delegation dynamics ("give away your legos" — Optimus's version is the autonomy-tier promotion rule, which is mechanical).

Transfers with modification: continuous discovery — weekly customer-evidence collection (reviews, support tickets, refund reasons, analytics anomalies) still gates the opportunity space, but every opportunity node requires evidence links because inventing customer needs is both Torres's #1 human failure mode and a known LLM weakness. Concierge and Analyst (support + data roles) are the natural evidence collectors.


11. Build implications & sequencing

Updated phase plan (extends architecture doc §11):

  • Phases 0–3 unchanged (runtime, control plane, projects/agents, safety) — the goal layer depends on runs, triggers, approvals, and memory existing.
  • Phase 4 — Goal layer MVP: goal + metric domains, 2 connectors, driver tree UI, hypothesis board with ICE + lifecycle, experiment engine (stop rules + significance in code), learn library, generated weekly review. Exit test: a full loop closes — a hypothesis proposed by an agent is approved by you, runs as an experiment, produces a statistically honest verdict and a learning, and that learning appears as evidence in a new proposal.
  • Phase 5 — Bootstrap flow: diagnose → propose → review → instantiate. Exit test: point Optimus at primedocs.co + "$10k MRR by Dec"; it drafts strategy, goals, driver tree, team, and first bets; you edit approve; the team starts running. (PrimeDocs becomes the first customer of the bootstrap rather than a hand-built config.)
  • Phase 6 — Compounding: delayed-outcome attribution (append business outcomes to run lineage — the unbuilt frontier from the gtm synthesis), learning-proposed versioned changes to skills/policies with regression review, stage-transition proposals, cycle grading & calibration.

Open design questions to settle before Phase 4 (worth a conversation each):

  1. Cycle length — 6-week Shape Up cycles, calendar months, or goal-defined milestones? (Recommendation: 6-week cycles with weekly reviews; agents get daily micro-cycles inside experiments.)
  2. How prescriptive is the weekly review ritual? A generated doc you read anytime, or a scheduled "session" the app structures (L10-style, timeboxed sections)? (Recommendation: generated doc, always current, with a "review mode" that walks the sections and collects your decisions — ritual as affordance, not obligation.)
  3. Can agents propose goals, or only hypotheses, at v1? (Recommendation: v1 agents propose sub-goals only under your goals; company-level goals stay yours. Loosen later like any tier.)
  4. Where does the timeline visualization sit on the build priority list? It's the most PM-feeling surface but the least mechanically necessary — cockpit + board may be enough for v1.

12. Source index

Startup operating systems (primary frameworks)

FrameworkKey source
OKRs as practiced (grading, sandbagging, failure modes)https://www.whatmatters.com/faqs/how-to-grade-okrs · https://www.whatmatters.com/faqs/common-okr-mistakes
North Star framework / driver treeshttps://amplitude.com/blog/product-north-star-metric · https://amplitude.com/books/north-star/about-the-north-star-framework
Amazon Weekly Business Review (input/output metrics, the deck, exception review)https://commoncog.com/the-amazon-weekly-business-review/
Amazon PR/FAQ (Working Backwards)https://commoncog.com/putting-amazons-pr-faq-to-practice/
Bezos: one-way/two-way doors, 70% rule, disagree-and-commithttps://www.aboutamazon.com/news/company-news/2016-letter-to-shareholders
Lean Startup (validated learning, innovation accounting, pivot-or-persevere)https://theleanstartup.com/principles
High-tempo testing / growth process (Sean Ellis)https://futurestartup.com/2023/07/17/high-tempo-testing-a-powerful-framework-for-growing-your-business/
ICE scoringhttps://growthmethod.com/ice-framework/
Hypothesis card format / growth sprintshttps://review.firstround.com/the-secret-to-running-effective-growth-sprints-follow-this-process-to-learn-faster/
Experiment hygiene (guardrails, min sample, peeking)https://docs.growthbook.io/using/experimenting
Growth loops vs funnelshttps://www.reforge.com/blog/growth-loops
Shape Up (appetite, betting table, circuit breaker)https://basecamp.com/shapeup/0.3-chapter-01
The Cadence (Sacks)https://medium.com/craft-ventures/the-cadence-how-to-operate-a-saas-startup-436aa8099e8
EOS / Level 10 meeting / scorecards / rocks / IDShttps://www.eosworldwide.com/blog/the-level-10-meeting
YC: growth as the metrichttps://www.ycombinator.com/library/8s-startup-growth
Lean Analytics OMTM (stage-dependent metric)https://leananalyticsbook.com/one-metric-that-matters/
RICE (Intercom)https://www.intercom.com/blog/rice-simple-prioritization-for-product-managers/
Opportunity Solution Trees (Torres)https://www.producttalk.org/opportunity-solution-tree/
DRI (Apple) / single-threaded owner (Amazon)https://blog.matt-rickard.com/p/directly-responsible-individuals · https://pedrodelgallego.github.io/blog/amazon/single-threaded-model/
6-page narrativeshttps://www.cnbc.com/2018/04/23/what-jeff-bezos-learned-from-requiring-6-page-memos-at-amazon.html
Pre-mortem (Klein)https://hbr.org/2007/09/performing-a-project-premortem
Rumelt strategy kernelhttps://jlzych.com/2018/06/27/notes-from-good-strategy-bad-strategy/
Give Away Your Legos (scaling/delegation)https://review.firstround.com/give-away-your-legos-and-other-commandments-for-scaling-startups/
V2MOM (Salesforce)https://www.salesforce.com/blog/how-to-create-alignment-within-your-company/

AI agents running businesses

SourceURL
Anthropic Project Vend phase 2 (scaffolding, specialization, oversight)https://www.anthropic.com/research/project-vend-2
TheAgentCompany benchmark (~30% long-horizon completion)https://arxiv.org/abs/2412.14161

Reference repo primitives (local paths)

PrimitivePath
Mastra durable goals (record, judge, budget, state processor)sources/harness/mastra/packages/core/src/agent/goal/ · storage/domains/thread-state/base.ts:31-54 · loop/workflows/agentic-execution/goal-step.ts
yalc campaign-as-hypothesis (SuccessMetric, Verdict)sources/gtm/yalc/src/lib/campaign/types.ts
yalc significance + auto kill/promotesources/gtm/yalc/src/lib/campaign/significance.ts · tracker.ts:693-720
yalc Intelligence (learnings: confidence lifecycle, supersedes, expiry)sources/gtm/yalc/src/lib/intelligence/types.ts · confidence.ts · store.ts:133
yalc Nudge (proposal object with executable action)sources/gtm/yalc/src/lib/campaign/optimizer.ts
Scorecard 4 horizons + Plan-with-stop-conditions + Run lineageagentic-gtm-reference/analysis/gtm/synthesis/PRIMITIVES.md:148-186 · ARCHITECTURE.md:71-129
Delayed-outcome pattern (invariants, open questions)agentic-gtm-reference/knowledge/gtm/patterns/delayed-outcome-scorecards.json · knowledge/bridges/mappings/delayed-outcomes-enabled-by-event-history.json
eve eval severity (gate/soft/atLeast)sources/harness/eve/docs/evals/assertions.mdx
Calibration/drift disciplineagentic-gtm-reference/analysis/gtm/recursive/headless-gtm-primitives.md:340-464

(All local paths relative to /Users/stansedberry/Documents/Agent Reference/agentic-gtm-reference/.)