# ahhakopian/speckit-solo-orchestrator architecture

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

- Interactive diagram: https://gitdiagram.com/ahhakopian/speckit-solo-orchestrator
- Repository: https://github.com/ahhakopian/speckit-solo-orchestrator

## Overview

SpecKit Solo Orchestrator is a native SpecKit extension and prepend preset for routing governed foundation and Feature work. A user invokes the generated route command; the repository’s Python script reads current project context and approvals, then selects the next native interface or stops for human authority. The README documents the delegated Feature lifecycle, readiness checks, and approval boundaries. Source excerpts show registry and installed-governance interactions; details of command and preset wiring are limited to the README and file tree.

Main entry points: [`extension/scripts/solo.py`](https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/scripts/solo.py) (Route engine), [`extension/commands/speckit.solo-orchestrator.route.md`](https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/commands/speckit.solo-orchestrator.route.md) (Route command), [`extension/commands/speckit.solo-orchestrator.readiness.md`](https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/commands/speckit.solo-orchestrator.readiness.md) (Readiness command), [`preset/commands/speckit.implement.md`](https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/preset/commands/speckit.implement.md) (Implement preset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Routing and commands"]
  node_route["Route command"]
  node_engine["Route engine<br/>[solo.py]"]
  node_readiness["Readiness command"]
  node_extension["Extension manifest<br/>[extension.yml]"]
end

subgraph group_authority["Approvals and state"]
  node_registry[("HITL registry")]
  node_project["Project artifacts"]
  node_facts["Governance facts"]
end

subgraph group_native["Native interfaces"]
  node_preset["Implement preset"]
  node_preset_manifest["Preset manifest<br/>[preset.yml]"]
  node_lifecycle["Roadmap lifecycle"]
  node_specify["SpecKit interfaces"]
  node_guards["Feature and MVP guards"]
end

node_user(("Engineer"))

node_user -->|"invokes"| node_route
node_route -.->|"routes through"| node_engine
node_engine -->|"reads context"| node_project
node_engine -->|"loads and saves"| node_registry
node_engine -->|"validates approvals"| node_facts
node_engine -->|"uses task checks"| node_lifecycle
node_engine -->|"selects interfaces"| node_specify
node_engine -->|"requires fresh checks"| node_guards
node_user -->|"invokes"| node_readiness
node_readiness -.->|"checks readiness"| node_engine
node_extension -->|"generates command"| node_route
node_preset_manifest -->|"prepends command"| node_preset
node_preset -.->|"uses native execution"| node_specify
node_specify -->|"delegates stage work"| node_project
node_user -->|"declares approvals"| node_registry

click node_route "https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/commands/speckit.solo-orchestrator.route.md"
click node_engine "https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/scripts/solo.py"
click node_readiness "https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/commands/speckit.solo-orchestrator.readiness.md"
click node_extension "https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/extension.yml"
click node_preset "https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/preset/commands/speckit.implement.md"
click node_preset_manifest "https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/preset/preset.yml"

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_route,node_engine,node_readiness,node_extension toneBlue
class node_registry,node_project,node_facts toneAmber
class node_preset,node_preset_manifest,node_lifecycle,node_specify,node_guards toneMint
class node_user toneIndigo
```

## Components

### Routing and commands

- [Route command](https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/commands/speckit.solo-orchestrator.route.md): `extension/commands/speckit.solo-orchestrator.route.md`
- [Route engine](https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/scripts/solo.py): `extension/scripts/solo.py`
- [Readiness command](https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/commands/speckit.solo-orchestrator.readiness.md): `extension/commands/speckit.solo-orchestrator.readiness.md`
- [Extension manifest](https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/extension/extension.yml): `extension/extension.yml`

### Approvals and state

- **HITL registry**
- **Project artifacts**
- **Governance facts**

### Native interfaces

- [Implement preset](https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/preset/commands/speckit.implement.md): `preset/commands/speckit.implement.md`
- [Preset manifest](https://github.com/ahhakopian/speckit-solo-orchestrator/blob/main/preset/preset.yml): `preset/preset.yml`
- **Roadmap lifecycle**
- **SpecKit interfaces**
- **Feature and MVP guards**

### Other components

- **Engineer**

## Connections

- Engineer → Route command: invokes (evidence: `README.md`)
- Route command → Route engine: routes through
- Route engine → Project artifacts: reads context (evidence: `extension/scripts/solo.py`)
- Route engine → HITL registry: loads and saves (evidence: `extension/scripts/solo.py`)
- Route engine → Governance facts: validates approvals (evidence: `extension/scripts/solo.py`)
- Route engine → Roadmap lifecycle: uses task checks (evidence: `extension/scripts/solo.py`)
- Route engine → SpecKit interfaces: selects interfaces (evidence: `README.md`)
- Route engine → Feature and MVP guards: requires fresh checks (evidence: `README.md`)
- Engineer → Readiness command: invokes (evidence: `README.md`)
- Readiness command → Route engine: checks readiness
- Extension manifest → Route command: generates command (evidence: `README.md`)
- Preset manifest → Implement preset: prepends command (evidence: `README.md`)
- Implement preset → SpecKit interfaces: uses native execution
- SpecKit interfaces → Project artifacts: delegates stage work (evidence: `README.md`)
- Engineer → HITL registry: declares approvals (evidence: `README.md`)
