# solomonikvik/svaib architecture

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

- Interactive diagram: https://gitdiagram.com/solomonikvik/svaib
- Repository: https://github.com/solomonikvik/svaib

## Overview

Svaib is a product and methodology repository for Second Value AI Brain: an AI partner that helps leaders manage business cycles using their business context, memory, and assistants. The intended workflow is that a leader works through a chosen AI interface; the plugin supplies management methods and automation over client-owned workspace data, supporting onboarding, workspace structure, and task-specific skills such as meeting analysis and metric review. The graph reflects documented product capabilities and sampled hook relationships; most skill-level wiring was not sampled, so those connections are not asserted.

Main entry points: [`product/plugin/README.md`](https://github.com/solomonikvik/svaib/blob/main/product/plugin/README.md) (Svaib plugin), [`product/methodology/space/00_basics.md`](https://github.com/solomonikvik/svaib/blob/main/product/methodology/space/00_basics.md) (Business context), [`product/plugin/hooks/usage_log.py`](https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/usage_log.py) (Skill usage logger), [`product/plugin/hooks/inject_space_map.py`](https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/inject_space_map.py) (Map context hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["AI interface"]
  node_ai["Chosen AI interface"]
end

subgraph group_workspace["Client workspace"]
  node_onboard["Workspace onboarding<br/>[SKILL.md]"]
  node_scaffold["Workspace scaffold<br/>[SKILL.md]"]
  node_align["Workspace alignment<br/>[SKILL.md]"]
  node_workspace_data["Business context<br/>[00_basics.md]"]
  node_memory["Context memory<br/>[README.md]"]
end

subgraph group_management["Management workflows"]
  node_ontology["Management ontology<br/>[README.md]"]
  node_meeting_agenda["Meeting agenda<br/>[SKILL.md]"]
  node_meeting_debrief["Meeting debrief<br/>[SKILL.md]"]
  node_meeting_analysis["Meeting analysis"]
  node_metric_values["Metric values<br/>[README.md]"]
  node_metric_reader["Metric workbook reader<br/>[read_metrics.py]"]
  node_role_skills["Management roles<br/>[SKILL.md]"]
  node_telegram["Telegram delivery skill<br/>[SKILL.md]"]
end

subgraph group_plugin["Plugin automation"]
  node_plugin["Svaib plugin<br/>[README.md]"]
  node_space_map["Space map generator<br/>[space_map.py]"]
  node_map_injector["Map context hook"]
  node_file_spec["File-spec hook"]
  node_root_resolver["Workspace resolver<br/>[hook_space.py]"]
  node_usage_log["Skill usage logger<br/>[usage_log.py]"]
  node_claude_usage["Claude usage adapter<br/>[usage_claude.py]"]
  node_codex_usage["Codex usage adapter<br/>[usage_codex.py]"]
  node_deferred_check["Deferred-action check"]
end

node_leader(("Business leader"))

node_leader -->|"requests help"| node_ai
node_ai -->|"uses plugin"| node_plugin
node_plugin -->|"uses client context"| node_workspace_data
node_onboard -.->|"sets up"| node_workspace_data
node_scaffold -.->|"structures"| node_workspace_data
node_align -.->|"aligns files"| node_workspace_data
node_workspace_data -.->|"provides context"| node_memory
node_ontology -.->|"guides"| node_meeting_agenda
node_ontology -.->|"guides"| node_meeting_debrief
node_meeting_debrief -.->|"supports"| node_meeting_analysis
node_metric_values -->|"reads workbook"| node_metric_reader
node_plugin -.->|"provides skills"| node_role_skills
node_plugin -.->|"provides skills"| node_meeting_agenda
node_plugin -.->|"provides skills"| node_meeting_debrief
node_plugin -.->|"provides skills"| node_metric_values
node_plugin -.->|"provides tool"| node_telegram
node_map_injector -->|"loads generator"| node_space_map
node_map_injector -->|"resolves workspace"| node_root_resolver
node_file_spec -->|"imports navigation"| node_map_injector
node_usage_log -->|"resolves usage root"| node_root_resolver
node_usage_log -->|"reads transcript"| node_claude_usage
node_usage_log -->|"reads rollout"| node_codex_usage
node_usage_log -->|"uses map helpers"| node_space_map
node_ai -.->|"checks stop"| node_deferred_check

click node_plugin "https://github.com/solomonikvik/svaib/blob/main/product/plugin/README.md"
click node_onboard "https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/space/onboarding/SKILL.md"
click node_scaffold "https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/space/scaffold/SKILL.md"
click node_align "https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/space/align/SKILL.md"
click node_workspace_data "https://github.com/solomonikvik/svaib/blob/main/product/methodology/space/00_basics.md"
click node_memory "https://github.com/solomonikvik/svaib/blob/main/product/methodology/memory/README.md"
click node_ontology "https://github.com/solomonikvik/svaib/blob/main/product/methodology/ontology/README.md"
click node_meeting_agenda "https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/rhythm/meeting-agenda/SKILL.md"
click node_meeting_debrief "https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/rhythm/meeting-debrief/SKILL.md"
click node_meeting_analysis "https://github.com/solomonikvik/svaib/blob/main/product/evals/meeting-analysis.md"
click node_metric_values "https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/metrics/values/README.md"
click node_metric_reader "https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/metrics/values/scripts/read_metrics.py"
click node_role_skills "https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/roles/strategy/SKILL.md"
click node_space_map "https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/space_map.py"
click node_map_injector "https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/inject_space_map.py"
click node_file_spec "https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/inject_file_spec.py"
click node_root_resolver "https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/hook_space.py"
click node_usage_log "https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/usage_log.py"
click node_claude_usage "https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/usage_claude.py"
click node_codex_usage "https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/usage_codex.py"
click node_deferred_check "https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/check_deferred_actions.py"
click node_telegram "https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/tools/send-telegram/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_ai toneBlue
class node_onboard,node_scaffold,node_align,node_workspace_data,node_memory toneAmber
class node_ontology,node_meeting_agenda,node_meeting_debrief,node_meeting_analysis,node_metric_values,node_metric_reader,node_role_skills,node_telegram toneMint
class node_plugin,node_space_map,node_map_injector,node_file_spec,node_root_resolver,node_usage_log,node_claude_usage,node_codex_usage,node_deferred_check toneRose
class node_leader toneIndigo
```

## Components

### AI interface

- **Chosen AI interface**

### Client workspace

- [Workspace onboarding](https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/space/onboarding/SKILL.md): `product/plugin/skills/space/onboarding/SKILL.md`
- [Workspace scaffold](https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/space/scaffold/SKILL.md): `product/plugin/skills/space/scaffold/SKILL.md`
- [Workspace alignment](https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/space/align/SKILL.md): `product/plugin/skills/space/align/SKILL.md`
- [Business context](https://github.com/solomonikvik/svaib/blob/main/product/methodology/space/00_basics.md): `product/methodology/space/00_basics.md`
- [Context memory](https://github.com/solomonikvik/svaib/blob/main/product/methodology/memory/README.md): `product/methodology/memory/README.md`

### Management workflows

- [Management ontology](https://github.com/solomonikvik/svaib/blob/main/product/methodology/ontology/README.md): `product/methodology/ontology/README.md`
- [Meeting agenda](https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/rhythm/meeting-agenda/SKILL.md): `product/plugin/skills/rhythm/meeting-agenda/SKILL.md`
- [Meeting debrief](https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/rhythm/meeting-debrief/SKILL.md): `product/plugin/skills/rhythm/meeting-debrief/SKILL.md`
- [Meeting analysis](https://github.com/solomonikvik/svaib/blob/main/product/evals/meeting-analysis.md): `product/evals/meeting-analysis.md`
- [Metric values](https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/metrics/values/README.md): `product/plugin/skills/metrics/values/README.md`
- [Metric workbook reader](https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/metrics/values/scripts/read_metrics.py): `product/plugin/skills/metrics/values/scripts/read_metrics.py`
- [Management roles](https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/roles/strategy/SKILL.md): `product/plugin/skills/roles/strategy/SKILL.md`
- [Telegram delivery skill](https://github.com/solomonikvik/svaib/blob/main/product/plugin/skills/tools/send-telegram/SKILL.md): `product/plugin/skills/tools/send-telegram/SKILL.md`

### Plugin automation

- [Svaib plugin](https://github.com/solomonikvik/svaib/blob/main/product/plugin/README.md): `product/plugin/README.md`
- [Space map generator](https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/space_map.py): `product/plugin/hooks/space_map.py`
- [Map context hook](https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/inject_space_map.py): `product/plugin/hooks/inject_space_map.py`
- [File-spec hook](https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/inject_file_spec.py): `product/plugin/hooks/inject_file_spec.py`
- [Workspace resolver](https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/hook_space.py): `product/plugin/hooks/hook_space.py`
- [Skill usage logger](https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/usage_log.py): `product/plugin/hooks/usage_log.py`
- [Claude usage adapter](https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/usage_claude.py): `product/plugin/hooks/usage_claude.py`
- [Codex usage adapter](https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/usage_codex.py): `product/plugin/hooks/usage_codex.py`
- [Deferred-action check](https://github.com/solomonikvik/svaib/blob/main/product/plugin/hooks/check_deferred_actions.py): `product/plugin/hooks/check_deferred_actions.py`

### Other components

- **Business leader**

## Connections

- Business leader → Chosen AI interface: requests help (evidence: `README.md`)
- Chosen AI interface → Svaib plugin: uses plugin (evidence: `README.md`)
- Svaib plugin → Business context: uses client context (evidence: `README.md`)
- Workspace onboarding → Business context: sets up
- Workspace scaffold → Business context: structures
- Workspace alignment → Business context: aligns files
- Business context → Context memory: provides context
- Management ontology → Meeting agenda: guides
- Management ontology → Meeting debrief: guides
- Meeting debrief → Meeting analysis: supports
- Metric values → Metric workbook reader: reads workbook (evidence: `product/plugin/skills/metrics/values/scripts/read_metrics.py`)
- Svaib plugin → Management roles: provides skills
- Svaib plugin → Meeting agenda: provides skills
- Svaib plugin → Meeting debrief: provides skills
- Svaib plugin → Metric values: provides skills
- Svaib plugin → Telegram delivery skill: provides tool
- Map context hook → Space map generator: loads generator (evidence: `product/plugin/hooks/inject_space_map.py`)
- Map context hook → Workspace resolver: resolves workspace (evidence: `product/plugin/hooks/inject_space_map.py`)
- File-spec hook → Map context hook: imports navigation (evidence: `product/plugin/hooks/inject_file_spec.py`)
- Skill usage logger → Workspace resolver: resolves usage root (evidence: `product/plugin/hooks/usage_log.py`)
- Skill usage logger → Claude usage adapter: reads transcript (evidence: `product/plugin/hooks/usage_log.py`)
- Skill usage logger → Codex usage adapter: reads rollout (evidence: `product/plugin/hooks/usage_log.py`)
- Skill usage logger → Space map generator: uses map helpers (evidence: `product/plugin/hooks/usage_log.py`)
- Chosen AI interface → Deferred-action check: checks stop
