# eyeszik/agent-mission-control-os architecture

> Architecture diagram of the GitHub repository eyeszik/agent-mission-control-os, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eyeszik/agent-mission-control-os
- Repository: https://github.com/eyeszik/agent-mission-control-os
- Video tour (about a minute): https://gitdiagram.com/eyeszik/agent-mission-control-os/video

## Overview

Agent Mission Control OS is a governed autonomous-agency platform: users submit work into project-scoped missions, which are planned and executed through agency capabilities, checked, and held for human approval before release. Its major branches include creative and visual production, project artifacts, operational assurance, and a local video-generation service. The graph follows the README’s documented workflow and capability relationships; source excerpts confirm selected execution, storage, council, and service behavior, but many listed subsystems were not sampled.

Main entry points: [`services/langgraph/agency/project_os`](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/project_os) (Project OS), [`services/langgraph/agency`](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency) (Human approvals), [`services/langgraph/agency/execution_fabric`](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/execution_fabric) (Execution fabric), [`services/langgraph/agency/intake`](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/intake) (Governed intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_web["Mission Control UI"]
  node_api["FastAPI application<br/>[main.py]"]
end

subgraph group_workflow["Mission workflow"]
  node_intake["Governed intake"]
  node_planning["Method planning"]
  node_execution["Execution fabric"]
  node_project[("Project OS")]
  node_council["Mission council"]
end

subgraph group_production["Creative production"]
  node_creative["Creative runtime"]
  node_foundry["Creative Foundry"]
  node_visual["Local visual engine<br/>[engine.py]"]
  node_cinematic["Cinematic pipeline<br/>[pipeline.py]"]
  node_design["Design compiler"]
  node_prompts["Prompt families"]
  node_video["FreeVideoForge<br/>[pipeline.py]"]
end

subgraph group_governance["Governance and runtime"]
  node_approvals["Human approvals"]
  node_durable[("Durable runtime")]
  node_framework["Operating framework<br/>[engine.py]"]
end

node_user(("Agency user"))
node_external["Local media tools"]

node_user -.->|"submits work"| node_web
node_web -.->|"sends requests"| node_api
node_api -.->|"routes missions"| node_intake
node_intake -->|"compiles intent"| node_planning
node_intake -->|"resolves project"| node_project
node_intake -->|"executes work"| node_execution
node_execution -->|"writes artifacts"| node_project
node_execution -->|"requests approval"| node_approvals
node_approvals -->|"gates release"| node_project
node_api -.->|"dispatches missions"| node_council
node_council -->|"pauses for approval"| node_approvals
node_creative -->|"requests HITL"| node_approvals
node_visual -->|"persists media"| node_project
node_visual -->|"requests release"| node_approvals
node_foundry -.->|"produces artifacts"| node_project
node_cinematic -.->|"produces prompts"| node_project
node_design -.->|"provides design specs"| node_execution
node_prompts -.->|"compiles prompts"| node_creative
node_framework -.->|"evaluates gates"| node_approvals
node_durable -.->|"persists run state"| node_project
node_execution -->|"verifies video"| node_video
node_video -.->|"renders locally"| node_external

click node_web "https://github.com/eyeszik/agent-mission-control-os/tree/master/apps/web/components/mission-control"
click node_api "https://github.com/eyeszik/agent-mission-control-os/blob/master/services/langgraph/app/main.py"
click node_intake "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/intake"
click node_planning "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/compiled"
click node_execution "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/execution_fabric"
click node_project "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/project_os"
click node_approvals "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency"
click node_durable "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/durable"
click node_council "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/council"
click node_creative "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/creative"
click node_foundry "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/foundry"
click node_visual "https://github.com/eyeszik/agent-mission-control-os/blob/master/services/langgraph/agency/visual/engine.py"
click node_cinematic "https://github.com/eyeszik/agent-mission-control-os/blob/master/services/langgraph/agency/cinematic/pipeline.py"
click node_design "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/design"
click node_prompts "https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/prompt_families"
click node_framework "https://github.com/eyeszik/agent-mission-control-os/blob/master/services/langgraph/agency/operating_framework/engine.py"
click node_video "https://github.com/eyeszik/agent-mission-control-os/blob/master/services/freevideoforge/freevideoforge/pipeline.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_api,node_user toneBlue
class node_intake,node_planning,node_execution,node_project,node_council toneAmber
class node_creative,node_foundry,node_visual,node_cinematic,node_design,node_prompts,node_video toneMint
class node_approvals,node_durable,node_framework toneRose
class node_external toneIndigo
```

## Components

### User experience

- [Mission Control UI](https://github.com/eyeszik/agent-mission-control-os/tree/master/apps/web/components/mission-control): `apps/web/components/mission-control`
- [FastAPI application](https://github.com/eyeszik/agent-mission-control-os/blob/master/services/langgraph/app/main.py): `services/langgraph/app/main.py`

### Mission workflow

- [Governed intake](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/intake): `services/langgraph/agency/intake`
- [Method planning](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/compiled): `services/langgraph/agency/compiled`
- [Execution fabric](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/execution_fabric): `services/langgraph/agency/execution_fabric`
- [Project OS](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/project_os): `services/langgraph/agency/project_os`
- [Mission council](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/council): `services/langgraph/agency/council`

### Creative production

- [Creative runtime](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/creative): `services/langgraph/agency/creative`
- [Creative Foundry](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/foundry): `services/langgraph/agency/foundry`
- [Local visual engine](https://github.com/eyeszik/agent-mission-control-os/blob/master/services/langgraph/agency/visual/engine.py): `services/langgraph/agency/visual/engine.py`
- [Cinematic pipeline](https://github.com/eyeszik/agent-mission-control-os/blob/master/services/langgraph/agency/cinematic/pipeline.py): `services/langgraph/agency/cinematic/pipeline.py`
- [Design compiler](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/design): `services/langgraph/agency/design`
- [Prompt families](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/prompt_families): `services/langgraph/agency/prompt_families`
- [FreeVideoForge](https://github.com/eyeszik/agent-mission-control-os/blob/master/services/freevideoforge/freevideoforge/pipeline.py): `services/freevideoforge/freevideoforge/pipeline.py`

### Governance and runtime

- [Human approvals](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency): `services/langgraph/agency`
- [Durable runtime](https://github.com/eyeszik/agent-mission-control-os/tree/master/services/langgraph/agency/durable): `services/langgraph/agency/durable`
- [Operating framework](https://github.com/eyeszik/agent-mission-control-os/blob/master/services/langgraph/agency/operating_framework/engine.py): `services/langgraph/agency/operating_framework/engine.py`

### Other components

- **Agency user**
- **Local media tools**

## Connections

- Agency user → Mission Control UI: submits work
- Mission Control UI → FastAPI application: sends requests
- FastAPI application → Governed intake: routes missions
- Governed intake → Method planning: compiles intent
- Governed intake → Project OS: resolves project
- Governed intake → Execution fabric: executes work
- Execution fabric → Project OS: writes artifacts
- Execution fabric → Human approvals: requests approval
- Human approvals → Project OS: gates release (evidence: `services/langgraph/agency/visual/engine.py`)
- FastAPI application → Mission council: dispatches missions (evidence: `services/langgraph/app/main.py`)
- Mission council → Human approvals: pauses for approval (evidence: `services/langgraph/agency/council/engines/base.py`)
- Creative runtime → Human approvals: requests HITL
- Local visual engine → Project OS: persists media (evidence: `services/langgraph/agency/visual/engine.py`)
- Local visual engine → Human approvals: requests release (evidence: `services/langgraph/agency/visual/engine.py`)
- Creative Foundry → Project OS: produces artifacts
- Cinematic pipeline → Project OS: produces prompts
- Design compiler → Execution fabric: provides design specs
- Prompt families → Creative runtime: compiles prompts
- Operating framework → Human approvals: evaluates gates (evidence: `services/langgraph/agency/operating_framework/engine.py`)
- Durable runtime → Project OS: persists run state
- Execution fabric → FreeVideoForge: verifies video
- FreeVideoForge → Local media tools: renders locally