# verdenef/genos architecture

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

- Interactive diagram: https://gitdiagram.com/verdenef/genos
- Repository: https://github.com/verdenef/genos

## Overview

genOS is a prompt-driven development framework centered on a persistent Project Brain, not a conventional application runtime. A developer starts with kickoff, which uses project memory and optional specialist/topology guidance to shape a plan and execution handoff; shutdown verifies and records progress. Separate commands support batch work, status, diagnosis, and upgrades. The sampled installer fetches approved Agency Agent personas and writes IDE skill/rule files. Most command implementations were not sampled, so workflow links below are supported by README statements rather than inspected command code.

Main entry points: [`.agents/skills/genos-kickoff/SKILL.md`](https://github.com/verdenef/genos/blob/main/.agents/skills/genos-kickoff/SKILL.md) (Kickoff), [`brain`](https://github.com/verdenef/genos/tree/main/brain) (Project Brain), [`guides/scripts/install_agent.py`](https://github.com/verdenef/genos/blob/main/guides/scripts/install_agent.py) (Agent Installer), [`.agents/skills/genos-doctor/SKILL.md`](https://github.com/verdenef/genos/blob/main/.agents/skills/genos-doctor/SKILL.md) (Doctor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Developer Workflow"]
  node_kickoff["Kickoff<br/>[SKILL.md]"]
  node_batch["Batch<br/>[SKILL.md]"]
  node_shutdown["Shutdown<br/>[SKILL.md]"]
  node_status["Status<br/>[SKILL.md]"]
end

subgraph group_brain["Project Brain"]
  node_projectbrain[("Project Brain")]
  node_templates["Brain Templates"]
end

subgraph group_extensions["Specialist Extensions"]
  node_specialists["Agency Agents<br/>[agency_agents.md]"]
  node_installer["Agent Installer<br/>[install_agent.py]"]
  node_idefiles["IDE Skills and Rules<br/>[skills]"]
  node_graphify["Graphify Topology<br/>[mcp-graphify.json]"]
  node_ponytail["Ponytail Restraint<br/>[SKILL.md]"]
  node_profiles["Stack Profiles"]
end

subgraph group_maintenance["Maintenance"]
  node_doctor["Doctor<br/>[SKILL.md]"]
  node_update["Update<br/>[SKILL.md]"]
end

node_developer(("Developer"))

node_developer -->|"starts session"| node_kickoff
node_kickoff -->|"boots from"| node_projectbrain
node_kickoff -->|"verifies rules"| node_specialists
node_kickoff -.->|"checks optionally"| node_graphify
node_kickoff -->|"applies filter"| node_ponytail
node_kickoff -->|"proposes handoff"| node_developer
node_developer -->|"starts execution"| node_batch
node_batch -->|"coordinates work"| node_projectbrain
node_developer -->|"closes session"| node_shutdown
node_shutdown -->|"persists progress"| node_projectbrain
node_templates -->|"initializes"| node_projectbrain
node_developer -->|"requests install"| node_installer
node_installer -->|"fetches personas"| node_specialists
node_installer -->|"writes skill files"| node_idefiles
node_developer -->|"requests summary"| node_status
node_status -->|"reads progress"| node_projectbrain
node_developer -->|"requests diagnosis"| node_doctor
node_doctor -->|"repairs integrity"| node_projectbrain
node_developer -->|"requests upgrade"| node_update
node_update -->|"runs afterward"| node_doctor
node_kickoff -.->|"uses guidance"| node_profiles

click node_kickoff "https://github.com/verdenef/genos/blob/main/.agents/skills/genos-kickoff/SKILL.md"
click node_batch "https://github.com/verdenef/genos/blob/main/.agents/skills/genos-kickoff/SKILL.md"
click node_shutdown "https://github.com/verdenef/genos/blob/main/.agents/skills/genos-shutdown/SKILL.md"
click node_projectbrain "https://github.com/verdenef/genos/tree/main/brain"
click node_templates "https://github.com/verdenef/genos/tree/main/templates/brain"
click node_specialists "https://github.com/verdenef/genos/blob/main/integrations/agency_agents.md"
click node_installer "https://github.com/verdenef/genos/blob/main/guides/scripts/install_agent.py"
click node_idefiles "https://github.com/verdenef/genos/tree/main/.agents/skills"
click node_graphify "https://github.com/verdenef/genos/blob/main/profiles/templates/mcp-graphify.json"
click node_ponytail "https://github.com/verdenef/genos/blob/main/.agents/skills/ponytail/SKILL.md"
click node_profiles "https://github.com/verdenef/genos/tree/main/profiles"
click node_status "https://github.com/verdenef/genos/blob/main/.agents/skills/genos-doctor/SKILL.md"
click node_doctor "https://github.com/verdenef/genos/blob/main/.agents/skills/genos-doctor/SKILL.md"
click node_update "https://github.com/verdenef/genos/blob/main/.agents/skills/genos-update/SKILL.md"

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_kickoff,node_batch,node_shutdown,node_status toneBlue
class node_projectbrain,node_templates toneAmber
class node_specialists,node_installer,node_idefiles,node_graphify,node_ponytail,node_profiles toneMint
class node_doctor,node_update toneRose
class node_developer toneIndigo
```

## Components

### Developer Workflow

- [Kickoff](https://github.com/verdenef/genos/blob/main/.agents/skills/genos-kickoff/SKILL.md): `.agents/skills/genos-kickoff/SKILL.md`
- [Batch](https://github.com/verdenef/genos/blob/main/.agents/skills/genos-kickoff/SKILL.md): `.agents/skills/genos-kickoff/SKILL.md`
- [Shutdown](https://github.com/verdenef/genos/blob/main/.agents/skills/genos-shutdown/SKILL.md): `.agents/skills/genos-shutdown/SKILL.md`
- [Status](https://github.com/verdenef/genos/blob/main/.agents/skills/genos-doctor/SKILL.md): `.agents/skills/genos-doctor/SKILL.md`

### Project Brain

- [Project Brain](https://github.com/verdenef/genos/tree/main/brain): `brain`
- [Brain Templates](https://github.com/verdenef/genos/tree/main/templates/brain): `templates/brain`

### Specialist Extensions

- [Agency Agents](https://github.com/verdenef/genos/blob/main/integrations/agency_agents.md): `integrations/agency_agents.md`
- [Agent Installer](https://github.com/verdenef/genos/blob/main/guides/scripts/install_agent.py): `guides/scripts/install_agent.py`
- [IDE Skills and Rules](https://github.com/verdenef/genos/tree/main/.agents/skills): `.agents/skills`
- [Graphify Topology](https://github.com/verdenef/genos/blob/main/profiles/templates/mcp-graphify.json): `profiles/templates/mcp-graphify.json`
- [Ponytail Restraint](https://github.com/verdenef/genos/blob/main/.agents/skills/ponytail/SKILL.md): `.agents/skills/ponytail/SKILL.md`
- [Stack Profiles](https://github.com/verdenef/genos/tree/main/profiles): `profiles`

### Maintenance

- [Doctor](https://github.com/verdenef/genos/blob/main/.agents/skills/genos-doctor/SKILL.md): `.agents/skills/genos-doctor/SKILL.md`
- [Update](https://github.com/verdenef/genos/blob/main/.agents/skills/genos-update/SKILL.md): `.agents/skills/genos-update/SKILL.md`

### Other components

- **Developer**

## Connections

- Developer → Kickoff: starts session (evidence: `README.md`)
- Kickoff → Project Brain: boots from (evidence: `README.md`)
- Kickoff → Agency Agents: verifies rules (evidence: `README.md`)
- Kickoff → Graphify Topology: checks optionally (evidence: `README.md`)
- Kickoff → Ponytail Restraint: applies filter (evidence: `README.md`)
- Kickoff → Developer: proposes handoff (evidence: `README.md`)
- Developer → Batch: starts execution (evidence: `README.md`)
- Batch → Project Brain: coordinates work (evidence: `README.md`)
- Developer → Shutdown: closes session (evidence: `README.md`)
- Shutdown → Project Brain: persists progress (evidence: `README.md`)
- Brain Templates → Project Brain: initializes (evidence: `README.md`)
- Developer → Agent Installer: requests install (evidence: `README.md`)
- Agent Installer → Agency Agents: fetches personas (evidence: `guides/scripts/install_agent.py`)
- Agent Installer → IDE Skills and Rules: writes skill files (evidence: `guides/scripts/install_agent.py`)
- Developer → Status: requests summary (evidence: `README.md`)
- Status → Project Brain: reads progress (evidence: `README.md`)
- Developer → Doctor: requests diagnosis (evidence: `README.md`)
- Doctor → Project Brain: repairs integrity (evidence: `README.md`)
- Developer → Update: requests upgrade (evidence: `README.md`)
- Update → Doctor: runs afterward (evidence: `README.md`)
- Kickoff → Stack Profiles: uses guidance