0% read on this device
Browse the curriculum

Start Here

Vision

First Principles

Operating Model

Domain Model

Agent Factory

Runtime Architecture

AI Engineering

Autonomous Workflows

Verification & Delivery

Factory Platform

Quality Engineering

Security & Governance

Case Studies

Labs

Interview Practice

Research Journal

Reference

Curriculum/Case Studies/A focused view of boundaries, contracts, state, authority, failure paths, and tradeoffs drawn from this chapter.
Case Studies13 min readcase study

Mission Control Capability, Workflow, and Admission Map

Evidence boundary: this assessment uses the tracked Mission Control files at checked out commit d902fae . The checkout was detached from a branch, and its local origin/main ref pointed to 4700573 . Untracked review artifacts were excluded.

Status: Current assessmentRisk: highLifecycle: execute · verifyContent reviewed 2026-08-28Maturity guide →
Claim boundaryThis case study carries scoped implementation evidence. Follow its pinned sources, dates, and stated gaps.
architecture mode

A focused view of boundaries, contracts, state, authority, failure paths, and tradeoffs drawn from this chapter.

Whiteboard exercise

Reconstruct and defend this chapter’s architecture.

Reconstruct the architecture, name each boundary, and defend the tradeoffs.

control planeevidence13 min chapter
Open the source exercise

Draw the five planes and the full delivery spine. Add the production admission chain as a precondition to Attempt claim. For every transition, name the actor, authoritative record, digest or version, hard policy check, emitted evidence, failure state, recovery path, and human-only authority. Circle every place where telemetry could be mistaken for evidence or registration for promotion.

4. Tradeoffs and alternatives

Exact versioning and digest binding make runs reproducible and auditable, but increase configuration work and make drift fail closed. A lighter system could move faster for low-risk experiments, but it should label that lower assurance instead of implying equivalent production readiness.

Atomic tools improve composability and emergent problem solving. Domain tools reduce calls and variance for repeated workflows. Keep policy enforcement, credential boundaries, exact schemas, and irreversible actions deterministic; let the agent apply judgment within those boundaries.

A single authoritative control plane improves consistency but may add latency and create a critical dependency. Durable local checkpoints and reconciliation help execution survive temporary control-plane or provider ambiguity without allowing a worker to invent authoritative state.

Action parity increases product usefulness and test surface. Some actions must remain human-only, including identity bootstrap, approval of consequential authority, risk acceptance, merge, and other irreversible decisions. Marking an action human-only is clearer than leaving an accidental capability gap.

5. Current Mission Control implementation

Repository and authority model

At the studied commit, Mission Control is a TypeScript and pnpm monorepo. The React/Vite application provides operator surfaces, Convex owns authoritative durable state and server-side transitions, and the Hono orchestration service hosts execution adapters and provider boundaries. Current product doctrine prioritizes an exception-first operator experience over agent activity feeds.

The repository's Software Factory documentation defines an authority order: product doctrine, accepted decisions, normative contracts, current implementation guides, plans, validation evidence, and historical material. This case study follows that order and uses code and retained evidence to bound present-tense claims.

Lifecycle map

Factory stageMission Control realization at d902faeAssessment
IntentProject Constitution, immutable Mission Spec revisions, Missions, stable requirements, acceptance expectations, and source referencesImplemented mechanisms; spec-driven intake is feature-gated and default off
PlanVersioned Mission Plans, human approval, WorkOrder blueprints, validation assertions, and a Quality Contract projectionImplemented and system-qualified for the bounded V1 path
Define AgentAgent templates/versions plus Attempt-bound hashes for the agent genome, prompt bundle, tool manifest, provider, and modelMaterial binding exists; not yet one universal Agent Definition record
Execute through HarnessProvider-neutral harness lifecycle, codex/v1, exact capability manifest, persistent-worker or remote-sandbox backend, lease, budgets, and structured resultGeneric harness is production architecture; current production execution remains unconfigured
Apply SkillsSkill discovery, import, frontmatter validation, linting, context evaluation, and configuration scanningRegistry and quality mechanisms exist; exact skill-version binding in the execution manifest was not found
EvaluatePolicy V2 Verification Subjects and Plans, separate verifier Attempts, evidence and receipts, exact-currentness checks, and Quality Gate DecisionsImplemented and system-qualified; the executing harness cannot certify the candidate
ImproveDeterministic learning signals, clusters, improvement candidates, datasets, experiments, and submitted Mission PlansImplemented as advisory proposal flow; no automatic promotion
Deliver SoftwareGitHub App publication boundary, PR currentness, human WorkOrder acceptance, release-gate records, deployments, activation, and production evidenceMechanisms exist at different maturity levels; production admission packet remained blocked

Capability map

CapabilityCurrent evidenceBoundary or missing proof
Builder surfacesNorth Star and V1 strategy define Mission intake, plan review, exception queues, run inspection, review packages, and release decisionsNo current repository-wide action-parity manifest or browser proof for every surface
Intent recognitionMission Spec quality evaluation, clarification, decisions, and requirement identities existDefault-off feature and bounded V1 journey; not general natural-language intent autonomy
Planning and decompositionPlans release governed WorkOrder blueprints; graph workflows support explicit dependenciesPlan approval does not dispatch, and graph execution does not grant new scope
Agent definitionsVersioned agent records and exact agent hashes are frozen into executionExact skills, credentials, and all policy fields are not consolidated into one definition
Model gateway and routingModel catalog, exact route identity, evidence qualification, advisory routing, guarded-auto gates, and immutable decision snapshots existProduction catalog had zero qualified routes; Guarded Auto remained disabled
Context and memoryProvenance-backed retrieval, graph relationships, planning, Attempt-bound Context Packages, context evals, and configuration drift scans existFactory Memory is advisory and gated by phase; it cannot satisfy acceptance
Tools and MCPHarness manifests freeze native tool support and permitted capabilitiesThe studied Codex and DeepSeek manifests declare MCP unsupported; no first-class production MCP gateway was verified
SkillsSKILL.md parsing, linting, registry import, eval scenarios, and local repository scanning existNo exact skill digest/version was observed in factory-execution-manifest/v1
Harness and sandboxGeneric lifecycle, normalized results, capability manifests, Sandbox Profiles, credential and teardown contracts, and local/remote backends existHardened remote production use requires operator promotion and live canary proof
State and recoveryTasks, immutable Attempts, leases, heartbeats, retry budgets, events, artifacts, pause/drain/kill controls, and compatibility projections existAmbiguous external effects still require reconciliation; old runs remain historical, not current evidence
EvaluationIndependent Verification Factory, criterion-linked evidence, receipts, exact-currentness, and fail-closed gates existA complete production outcome proof remains outside the retained admission packet
Feedback and learningSignals, clusters, candidates, experiments, baseline/candidate comparison, and promotion history existPromotion stops at a submitted Plan and requires a different human approval
Policy and approvalsServer-side permissions, risk classes, policy envelopes, approval records, separation of duties, and publication permits existProduction identities and configuration must be established legitimately; no service identity may simulate human promotion
ObservabilityRun events, traces, observations, model/token/cost fields, inspector views, and eval records existDiagnostic observations are not acceptance evidence; unavailable telemetry remains unknown rather than zero
Deployment and releaseSeparate PR, acceptance, release, deployment, activation, rollback, and production-evidence records existCurrent V1 proof is stronger before merge than after production outcome validation
Multi-tenancyCompany/workspace/repository boundaries, membership authorization, scoped records, and cross-scope tests existFleet-scale and cross-organization production load are not established by repository tests
Adoption and versioningBasic/intermediate/advanced presentation, feature flags, immutable versions, migration guidance, and docs existPresentation modes do not alter authority; broad company adoption remains a future operating proof

Workflow 1: governed intent to review-ready change

The important property is negative authority: Plan approval does not dispatch; the harness does not verify; verification does not publish; publication does not merge; and merge does not prove the production outcome.

Workflow 2: production execution admission

The admission packet records the following operator sequence:

Canonical GitHub App installation
  → current structured workflow registration
  → exact model-route registration
  → human evidence-based route promotion
  → immutable hardened Sandbox Profile creation
  → human profile promotion
  → code scopes + agents + policy + verifiers
  → exact Factory Version creation
  → exact worker/Factory Version attestation
  → readiness assessment and activation
  → human-selected local then remote canary
  → independent verification
  → controlled publication canary

Registration never counts as qualification. Promotion grants execution-only eligibility, not routing, verification, publication, acceptance, merge, or deployment authority. Worker admission compares exact repository, Factory Version, configuration digest, harness manifest, effective configuration, model route, backend, and Sandbox Profile identity.

The local implementation qualification passed 17 composed gates. The retained production observation still found zero GitHub App installations, exact routes, promoted Sandbox Profiles, current production workflows, Factory Versions, workers, and Attempts. No production mutation or canary was fabricated. This is a strong example of honest blocking: qualified code is not the same as an operationally configured factory.

Workflow 3: failure, recovery, and reconciliation

Detect failure
  → classify policy / capability / environment / provider / execution / result
  → contain authority and preserve events
  → retry only a permitted failure class within Attempt and wall-clock budgets
  → create attributable new Attempt or reconcile ambiguous external effects
  → quarantine, drain, kill, or escalate when safe continuation is unavailable
  → independently re-evaluate the new exact candidate

The workflow contract rejects heuristic STATUS: done completion and requires structured status for non-gate steps. Historical runs are projected read-only as current, legacy-but-valid, malformed, incomplete, stale-schema, or genuinely invalid. Compatibility logic does not rewrite history or invent a terminal outcome.

Workflow 4: governed learning

Attempt, verification, review, and production observations
  → deterministic Learning Signals
  → bounded failure or opportunity clusters
  → human-reviewable Improvement Candidate
  → frozen baseline/candidate experiment
  → reviewed result
  → submitted Mission Plan
  → separate human Plan approval
  → ordinary WorkOrder and execution lifecycle

This is the practical meaning of: Learning can be autonomous. Promotion should be governed. The learning subsystem is prohibited from accepting, publishing, merging, changing an active Factory Version, or granting itself new authority.

Workflow 5: authorized action parity

Mission Control contains slice-level capability maps, including Graph Engineering mappings between UI actions, Convex capabilities, and shared state. The reusable factory workflow is:

  1. inventory each meaningful builder action and the state it changes;
  2. map it to an authenticated API or tool outcome, or mark it human-only;
  3. require UI and agent paths to use the same authoritative transition;
  4. apply the same policy, scope, idempotency, and audit rules;
  5. surface the result and receipt immediately to the operator; and
  6. test the resulting state, not merely the selected tool call.

A repository-wide parity map and drift check would make this discipline continuous rather than case-study-specific.

Evidence boundary

Curriculum maturity is not implementation proof.

This case study records scoped implementation claims. Inspect the exact evidence, commit references, gaps, and verification boundaries in the source below.

CurriculumCurrent assessmentImplementation evidenceScoped in chapterInspect evidence map →
External review

Review this chapter.

Challenge a claim, boundary, missing failure mode, unclear term, or unsupported evidence statement.

  • Claim
  • Boundary
  • Failure
  • Evidence