# choaterboater/skyn3t-2-0 architecture

> Architecture diagram of the GitHub repository choaterboater/skyn3t-2-0, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/choaterboater/skyn3t-2-0
- Repository: https://github.com/choaterboater/skyn3t-2-0

## Overview

SkyN3t is an autonomous app factory: a user submits a plain-English brief, the factory selects a stack, plans and generates an app, verifies it through stack-specific proof gates, and can then deploy or share it. Its dashboard exposes build status and controls; internal model routing and event coordination support the workflow. The README documents the product stages and gates, while several implementation modules were not sampled, so some subsystem links are shown as unverified rather than asserted as direct calls.

Main entry points: [`skyn3t/studio/runner.py`](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/runner.py) (Build runner), [`skyn3t/studio/proof_run.py`](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/proof_run.py) (Proof ladder), [`skyn3t/web/ui/src/App.jsx`](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/web/ui/src/App.jsx) (Dashboard UI), [`skyn3t/agents`](https://github.com/choaterboater/skyn3t-2-0/tree/main/skyn3t/agents) (Specialist agents)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_cli["CLI<br/>[main.py]"]
  node_dashboard["Dashboard UI<br/>[App.jsx]"]
  node_api["Control API<br/>[routes.py]"]
end

subgraph group_factory["Build factory"]
  node_selector["Stack selector<br/>[stack_selector.py]"]
  node_planner["Build planner<br/>[planner.py]"]
  node_runner["Build runner<br/>[runner.py]"]
  node_improve["Improve workflow<br/>[improve.py]"]
end

subgraph group_runtime["Agent runtime"]
  node_agents["Specialist agents"]
  node_orchestrator["Agent orchestrator<br/>[orchestrator.py]"]
  node_events["Event bus<br/>[events.py]"]
  node_modelrouter["Model router<br/>[model_router.py]"]
  node_llm["LLM adapter<br/>[llm.py]"]
end

subgraph group_proof["Verification and delivery"]
  node_proof["Proof ladder<br/>[proof_run.py]"]
  node_preview["Preview supervisor"]
  node_deploy["Deploy planning<br/>[deploy.py]"]
end

subgraph group_learning["Learning and context"]
  node_rag["RAG engine<br/>[rag_engine.py]"]
  node_skills[("Skill library<br/>[skill_library.py]")]
  node_candidates["Cortex candidates"]
end

node_user(("Builder"))

node_user -->|"submits brief"| node_cli
node_user -->|"submits brief"| node_dashboard
node_dashboard -->|"calls API"| node_api
node_api -->|"starts build"| node_runner
node_cli -.->|"runs build"| node_runner
node_runner -.->|"selects stack"| node_selector
node_runner -.->|"plans build"| node_planner
node_runner -->|"generates app"| node_agents
node_orchestrator -->|"dispatches agents"| node_agents
node_agents -.->|"requests generation"| node_llm
node_llm -->|"resolves model"| node_modelrouter
node_runner -->|"runs gates"| node_proof
node_proof -.->|"proves preview"| node_preview
node_proof -->|"enables shipping"| node_deploy
node_runner -->|"supports iteration"| node_improve
node_events -.->|"streams activity"| node_dashboard
node_rag -.->|"supports learning"| node_skills
node_candidates -.->|"proposes lessons"| node_skills

click node_cli "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/cli/main.py"
click node_dashboard "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/web/ui/src/App.jsx"
click node_api "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/web/routes.py"
click node_selector "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/stack_selector.py"
click node_planner "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/planner.py"
click node_runner "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/runner.py"
click node_improve "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/improve.py"
click node_agents "https://github.com/choaterboater/skyn3t-2-0/tree/main/skyn3t/agents"
click node_orchestrator "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/core/orchestrator.py"
click node_events "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/core/events.py"
click node_modelrouter "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/core/model_router.py"
click node_llm "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/adapters/llm.py"
click node_proof "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/proof_run.py"
click node_preview "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/preview_supervisor.py"
click node_deploy "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/deploy.py"
click node_rag "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/rag/rag_engine.py"
click node_skills "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/intelligence/skill_library.py"
click node_candidates "https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/cortex/candidate_engine.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_cli,node_dashboard,node_api toneBlue
class node_selector,node_planner,node_runner,node_improve toneAmber
class node_agents,node_orchestrator,node_events,node_modelrouter,node_llm toneMint
class node_proof,node_preview,node_deploy toneRose
class node_rag,node_skills,node_candidates,node_user toneIndigo
```

## Components

### User interfaces

- [CLI](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/cli/main.py): `skyn3t/cli/main.py`
- [Dashboard UI](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/web/ui/src/App.jsx): `skyn3t/web/ui/src/App.jsx`
- [Control API](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/web/routes.py): `skyn3t/web/routes.py`

### Build factory

- [Stack selector](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/stack_selector.py): `skyn3t/studio/stack_selector.py`
- [Build planner](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/planner.py): `skyn3t/studio/planner.py`
- [Build runner](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/runner.py): `skyn3t/studio/runner.py`
- [Improve workflow](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/improve.py): `skyn3t/studio/improve.py`

### Agent runtime

- [Specialist agents](https://github.com/choaterboater/skyn3t-2-0/tree/main/skyn3t/agents): `skyn3t/agents`
- [Agent orchestrator](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/core/orchestrator.py): `skyn3t/core/orchestrator.py`
- [Event bus](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/core/events.py): `skyn3t/core/events.py`
- [Model router](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/core/model_router.py): `skyn3t/core/model_router.py`
- [LLM adapter](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/adapters/llm.py): `skyn3t/adapters/llm.py`

### Verification and delivery

- [Proof ladder](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/proof_run.py): `skyn3t/studio/proof_run.py`
- [Preview supervisor](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/preview_supervisor.py): `skyn3t/studio/preview_supervisor.py`
- [Deploy planning](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/studio/deploy.py): `skyn3t/studio/deploy.py`

### Learning and context

- [RAG engine](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/rag/rag_engine.py): `skyn3t/rag/rag_engine.py`
- [Skill library](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/intelligence/skill_library.py): `skyn3t/intelligence/skill_library.py`
- [Cortex candidates](https://github.com/choaterboater/skyn3t-2-0/blob/main/skyn3t/cortex/candidate_engine.py): `skyn3t/cortex/candidate_engine.py`

### Other components

- **Builder**

## Connections

- Builder → CLI: submits brief (evidence: `README.md`)
- Builder → Dashboard UI: submits brief (evidence: `README.md`)
- Dashboard UI → Control API: calls API (evidence: `skyn3t/web/ui/src/App.jsx`)
- Control API → Build runner: starts build (evidence: `skyn3t/web/routes.py`)
- CLI → Build runner: runs build (evidence: `skyn3t/cli/main.py`)
- Build runner → Stack selector: selects stack
- Build runner → Build planner: plans build
- Build runner → Specialist agents: generates app (evidence: `README.md`)
- Agent orchestrator → Specialist agents: dispatches agents (evidence: `skyn3t/core/orchestrator.py`)
- Specialist agents → LLM adapter: requests generation (evidence: `skyn3t/adapters/llm.py`)
- LLM adapter → Model router: resolves model (evidence: `skyn3t/adapters/llm.py`)
- Build runner → Proof ladder: runs gates (evidence: `README.md`)
- Proof ladder → Preview supervisor: proves preview
- Proof ladder → Deploy planning: enables shipping (evidence: `README.md`)
- Build runner → Improve workflow: supports iteration (evidence: `README.md`)
- Event bus → Dashboard UI: streams activity
- RAG engine → Skill library: supports learning
- Cortex candidates → Skill library: proposes lessons