# AIOS Cockpit Architecture

## Role

AIOS Cockpit is the homogeneous surface over the existing agentic system. It is
not a new planning brain and not a new execution engine.

## Sources

- Focus and operating constraints: `samuel-os-v2`
- Routing: `KomandoZentral`
- Harness profiles and run records: `Zentrale`
- Prompt memory: `PromptGarage`
- Evaluation evidence: harness experiment databases and `HarnessEcosystem`
- Safety/coaching: `Sidecar-V8` and its plan repo

## MVP Flow

1. Read today's focus and active priorities.
2. Show integration-source projects separately from active/parked projects.
3. Route a concrete task through `KomandoZentral`.
4. Generate a canonical handoff for Codex/OpenCode/Claude.
5. Show latest run/eval/prompt signals as evidence.

## V2 additions

- Project detail pages expose README/PLAN context without editing source repos.
- Run detail pages expose Zentrale run artifacts.
- Handoffs are saved under `handoffs/` with frontmatter metadata.
- `CodexMaxHarnessHowTo` is mounted as a first-class local runbook.

## V3 workbench

The primary UI is `/workbench`, a three-column agent terminal:

- Left rail: project selector, task queue, source-of-truth shortcuts.
- Center: active task, routing, handoff, run preview actions.
- Right pane: today's focus, project context, runbook, latest runs.

V3 writes only cockpit-owned artifacts:

- `workspace/tasks/*.json`
- `workspace/runs/*.json`
- `workspace/runs/*-instructions.md`
- `handoffs/*.md`

The run preview uses Zentrale's existing `opencode-prompt --dry-run` path. It
does not execute a source-mutating agent command in V3.

## Non-goals

- No database in v0.1.
- No autonomous execution from the UI.
- No migration of all old projects.
- No second routing engine.