# picmakpro/vibeflow-os architecture

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

- Interactive diagram: https://gitdiagram.com/picmakpro/vibeflow-os
- Repository: https://github.com/picmakpro/vibeflow-os

## Overview

VibeFlow OS is a governed agent-orchestration product: a user request is routed into a spec-driven development cycle that produces scoped plans, execution artifacts, and machine-verifiable proof. The README also describes long-running team missions, domain labs, persistent memory, installation, and optional non-Claude runtimes. The sampled skill-creator scripts substantiate its evaluation/improvement loop and validation/package behavior. Most module internals were not sampled, so those branches and their documented relationships are represented at directory level and cited to the README.

Main entry points: [`plugin/installer`](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/installer) (Module installer), [`plugin/dev-orchestrator`](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator) (Intent router), [`plugin/skill-creator/skills/skill-creator/scripts/run_loop.py`](https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/run_loop.py) (Skill eval loop), [`plugin/planning-core`](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/planning-core) (Planning pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Development workflow"]
  node_head["Intent router"]
  node_scope["Scoping"]
  node_planning["Planning pipeline"]
  node_execution["Execution team"]
  node_mission["Mission manager"]
  node_workers["Parallel workers"]
end

subgraph group_governance["Governance and state"]
  node_gates["Machine gates"]
  node_judges["Read-only judges"]
  node_artifacts["Disk artifacts<br/>[.planning]"]
  node_memory[("Agent memory<br/>[agent-memory]")]
end

subgraph group_domains["Domain labs"]
  node_devlab["Dev lab"]
  node_design["Design lab"]
  node_mobile["Mobile testing"]
  node_business["Business bundle"]
  node_content["Content bundle"]
  node_growth["Growth bundle"]
end

subgraph group_capabilities["Supporting capabilities"]
  node_installer["Module installer"]
  node_skill_loop["Skill eval loop<br/>[run_loop.py]"]
  node_eval["Trigger evaluation<br/>[run_eval.py]"]
  node_improve["Description improvement"]
  node_report["Eval reporting<br/>[generate_report.py]"]
  node_review["Review viewer<br/>[generate_review.py]"]
  node_validate["Skill validation<br/>[quick_validate.py]"]
  node_package["Skill packaging<br/>[package_skill.py]"]
end

node_user(("User"))
node_codex(("Codex runtime"))

node_user -->|"states intent"| node_head
node_head -->|"dispatches"| node_scope
node_head -->|"starts pipeline"| node_planning
node_planning -->|"records plans"| node_artifacts
node_planning -->|"plans execution"| node_execution
node_execution -->|"records results"| node_artifacts
node_execution -->|"requests proof"| node_judges
node_judges -->|"verifies"| node_gates
node_mission -->|"dispatches"| node_workers
node_mission -->|"uses gates"| node_gates
node_installer -->|"installs modules"| node_devlab
node_installer -->|"installs modules"| node_design
node_installer -->|"installs modules"| node_mobile
node_installer -->|"installs modules"| node_business
node_installer -->|"installs modules"| node_content
node_installer -->|"installs modules"| node_growth
node_head -.->|"loads indexed memory"| node_memory
node_skill_loop -->|"runs evaluations"| node_eval
node_skill_loop -->|"improves description"| node_improve
node_skill_loop -->|"generates report"| node_report
node_review -->|"reads run outputs"| node_artifacts
node_package -->|"validates skill"| node_validate
node_codex -.->|"runs plugin"| node_head

click node_head "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator"
click node_scope "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator"
click node_planning "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/planning-core"
click node_execution "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator"
click node_mission "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/conductor"
click node_workers "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/conductor"
click node_gates "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/conductor"
click node_judges "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator"
click node_artifacts "https://github.com/picmakpro/vibeflow-os/tree/main/.planning"
click node_memory "https://github.com/picmakpro/vibeflow-os/tree/main/.claude/agent-memory"
click node_installer "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/installer"
click node_devlab "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator"
click node_design "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/design-orchestrator"
click node_mobile "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/mobile-test"
click node_business "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/business-pilot-bundle"
click node_content "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/content-bundle"
click node_growth "https://github.com/picmakpro/vibeflow-os/tree/main/plugin/growth-bundle"
click node_skill_loop "https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/run_loop.py"
click node_eval "https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/run_eval.py"
click node_improve "https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/improve_description.py"
click node_report "https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/generate_report.py"
click node_review "https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/eval-viewer/generate_review.py"
click node_validate "https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/quick_validate.py"
click node_package "https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/package_skill.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_head,node_scope,node_planning,node_execution,node_mission,node_workers,node_user toneBlue
class node_gates,node_judges,node_artifacts,node_memory toneAmber
class node_devlab,node_design,node_mobile,node_business,node_content,node_growth toneMint
class node_installer,node_skill_loop,node_eval,node_improve,node_report,node_review,node_validate,node_package toneRose
class node_codex toneIndigo
```

## Components

### Development workflow

- [Intent router](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator): `plugin/dev-orchestrator`
- [Scoping](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator): `plugin/dev-orchestrator`
- [Planning pipeline](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/planning-core): `plugin/planning-core`
- [Execution team](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator): `plugin/dev-orchestrator`
- [Mission manager](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/conductor): `plugin/conductor`
- [Parallel workers](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/conductor): `plugin/conductor`

### Governance and state

- [Machine gates](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/conductor): `plugin/conductor`
- [Read-only judges](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator): `plugin/dev-orchestrator`
- [Disk artifacts](https://github.com/picmakpro/vibeflow-os/tree/main/.planning): `.planning`
- [Agent memory](https://github.com/picmakpro/vibeflow-os/tree/main/.claude/agent-memory): `.claude/agent-memory`

### Domain labs

- [Dev lab](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/dev-orchestrator): `plugin/dev-orchestrator`
- [Design lab](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/design-orchestrator): `plugin/design-orchestrator`
- [Mobile testing](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/mobile-test): `plugin/mobile-test`
- [Business bundle](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/business-pilot-bundle): `plugin/business-pilot-bundle`
- [Content bundle](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/content-bundle): `plugin/content-bundle`
- [Growth bundle](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/growth-bundle): `plugin/growth-bundle`

### Supporting capabilities

- [Module installer](https://github.com/picmakpro/vibeflow-os/tree/main/plugin/installer): `plugin/installer`
- [Skill eval loop](https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/run_loop.py): `plugin/skill-creator/skills/skill-creator/scripts/run_loop.py`
- [Trigger evaluation](https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/run_eval.py): `plugin/skill-creator/skills/skill-creator/scripts/run_eval.py`
- [Description improvement](https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/improve_description.py): `plugin/skill-creator/skills/skill-creator/scripts/improve_description.py`
- [Eval reporting](https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/generate_report.py): `plugin/skill-creator/skills/skill-creator/scripts/generate_report.py`
- [Review viewer](https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/eval-viewer/generate_review.py): `plugin/skill-creator/skills/skill-creator/eval-viewer/generate_review.py`
- [Skill validation](https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/quick_validate.py): `plugin/skill-creator/skills/skill-creator/scripts/quick_validate.py`
- [Skill packaging](https://github.com/picmakpro/vibeflow-os/blob/main/plugin/skill-creator/skills/skill-creator/scripts/package_skill.py): `plugin/skill-creator/skills/skill-creator/scripts/package_skill.py`

### Other components

- **User**
- **Codex runtime**

## Connections

- User → Intent router: states intent (evidence: `README.md`)
- Intent router → Scoping: dispatches (evidence: `README.md`)
- Intent router → Planning pipeline: starts pipeline (evidence: `README.md`)
- Planning pipeline → Disk artifacts: records plans (evidence: `README.md`)
- Planning pipeline → Execution team: plans execution (evidence: `README.md`)
- Execution team → Disk artifacts: records results (evidence: `README.md`)
- Execution team → Read-only judges: requests proof (evidence: `README.md`)
- Read-only judges → Machine gates: verifies (evidence: `README.md`)
- Mission manager → Parallel workers: dispatches (evidence: `README.md`)
- Mission manager → Machine gates: uses gates (evidence: `README.md`)
- Module installer → Dev lab: installs modules (evidence: `README.md`)
- Module installer → Design lab: installs modules (evidence: `README.md`)
- Module installer → Mobile testing: installs modules (evidence: `README.md`)
- Module installer → Business bundle: installs modules (evidence: `README.md`)
- Module installer → Content bundle: installs modules (evidence: `README.md`)
- Module installer → Growth bundle: installs modules (evidence: `README.md`)
- Intent router → Agent memory: loads indexed memory
- Skill eval loop → Trigger evaluation: runs evaluations (evidence: `plugin/skill-creator/skills/skill-creator/scripts/run_loop.py`)
- Skill eval loop → Description improvement: improves description (evidence: `plugin/skill-creator/skills/skill-creator/scripts/run_loop.py`)
- Skill eval loop → Eval reporting: generates report (evidence: `plugin/skill-creator/skills/skill-creator/scripts/run_loop.py`)
- Review viewer → Disk artifacts: reads run outputs (evidence: `plugin/skill-creator/skills/skill-creator/eval-viewer/generate_review.py`)
- Skill packaging → Skill validation: validates skill (evidence: `plugin/skill-creator/skills/skill-creator/scripts/package_skill.py`)
- Codex runtime → Intent router: runs plugin
