# bocal-pol/bocal-kit architecture

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

- Interactive diagram: https://gitdiagram.com/bocal-pol/bocal-kit
- Repository: https://github.com/bocal-pol/bocal-kit

## Overview

This repository is a reusable Claude Code configuration: users invoke team-dev (or standalone entry points), which routes work to specialist agents and skills that produce development, security, infrastructure, design, and management outcomes. Its main internal layer is the agent/skill routing hierarchy. The graph also preserves two substantial skill-specific runtimes identified in the source index: goodnight’s quota-aware work supervision and hairline-create’s SVG figure build/review tools. Routing links are documented in the README; runtime links use the shown source excerpts.

Main entry points: [`skills/team-dev`](https://github.com/bocal-pol/bocal-kit/tree/main/skills/team-dev) (Team Dev Router), [`skills/hairline-create/look.mjs`](https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/look.mjs) (Figure Review), [`skills/goodnight/scripts/goodnight.mjs`](https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/goodnight.mjs) (Goodnight CLI), [`skills/goodnight/scripts/lib.mjs`](https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/lib.mjs) (Quota State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Orchestration"]
  node_teamdev["Team Dev Router"]
  node_teamselector["Team Selector"]
end

subgraph group_specialists["Specialist Capabilities"]
  node_productagent["Product Agent<br/>[product-agent.md]"]
  node_techlead["Tech Lead"]
  node_specialistagents["Specialist Agents"]
  node_skillcatalog["Specialist Skills"]
  node_ict["ICT Director"]
  node_procurement["Procurement Agent"]
end

subgraph group_standalone["Standalone Workflows"]
  node_goodnightcli["Goodnight CLI<br/>[goodnight.mjs]"]
  node_quota[("Quota State<br/>[lib.mjs]")]
  node_supervisor["Claude Supervisor<br/>[supervise.mjs]"]
  node_handoff["Codex Handoff<br/>[handoff.mjs]"]
  node_guard["Quota Guard<br/>[guard.mjs]"]
  node_statusline["Quota Statusline<br/>[statusline.mjs]"]
end

subgraph group_runtime["Skill Runtimes"]
  node_hairlinebuild["Figure Builder<br/>[build.mjs]"]
  node_hairlinekernel["Figure Kernel<br/>[kernel.js]"]
  node_hairlinelook["Figure Review<br/>[look.mjs]"]
  node_hairlineread["SVG Reader<br/>[read.mjs]"]
  node_hairlinevalidate["Figure Validator<br/>[validate.mjs]"]
end

node_user(("Claude Code User"))

node_user -->|"invokes"| node_teamdev
node_teamdev -->|"routes requests"| node_teamselector
node_teamdev -->|"delegates product"| node_productagent
node_teamdev -->|"delegates technical"| node_techlead
node_teamdev -->|"routes modes"| node_specialistagents
node_specialistagents -->|"hands off implementation"| node_skillcatalog
node_user -->|"invokes directly"| node_skillcatalog
node_user -->|"invokes directly"| node_ict
node_user -->|"invokes directly"| node_procurement
node_goodnightcli -->|"reads and writes"| node_quota
node_goodnightcli -->|"starts supervision"| node_supervisor
node_goodnightcli -->|"starts handoff"| node_handoff
node_guard -->|"checks state"| node_quota
node_statusline -->|"writes state"| node_quota
node_hairlinebuild -->|"embeds kernel"| node_hairlinekernel
node_hairlinelook -->|"builds page"| node_hairlinebuild
node_hairlinelook -->|"validates page"| node_hairlinevalidate
node_hairlinelook -->|"reads source SVG"| node_hairlineread
node_hairlineread -->|"uses browser helpers"| node_hairlinelook

click node_teamdev "https://github.com/bocal-pol/bocal-kit/tree/main/skills/team-dev"
click node_teamselector "https://github.com/bocal-pol/bocal-kit/tree/main/skills/team-selector"
click node_productagent "https://github.com/bocal-pol/bocal-kit/blob/main/agents/product-agent.md"
click node_techlead "https://github.com/bocal-pol/bocal-kit/tree/main/skills/tech-lead"
click node_specialistagents "https://github.com/bocal-pol/bocal-kit/tree/main/agents"
click node_skillcatalog "https://github.com/bocal-pol/bocal-kit/tree/main/skills"
click node_ict "https://github.com/bocal-pol/bocal-kit/blob/main/agents/ict-director-agent.md"
click node_procurement "https://github.com/bocal-pol/bocal-kit/blob/main/agents/public-procurement-agent.md"
click node_goodnightcli "https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/goodnight.mjs"
click node_quota "https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/lib.mjs"
click node_supervisor "https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/supervise.mjs"
click node_handoff "https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/handoff.mjs"
click node_guard "https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/guard.mjs"
click node_statusline "https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/statusline.mjs"
click node_hairlinebuild "https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/build.mjs"
click node_hairlinekernel "https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/kernel.js"
click node_hairlinelook "https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/look.mjs"
click node_hairlineread "https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/read.mjs"
click node_hairlinevalidate "https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/validate.mjs"

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_teamdev,node_teamselector,node_user toneBlue
class node_productagent,node_techlead,node_specialistagents,node_skillcatalog,node_ict,node_procurement toneAmber
class node_goodnightcli,node_quota,node_supervisor,node_handoff,node_guard,node_statusline toneMint
class node_hairlinebuild,node_hairlinekernel,node_hairlinelook,node_hairlineread,node_hairlinevalidate toneRose
```

## Components

### Orchestration

- [Team Dev Router](https://github.com/bocal-pol/bocal-kit/tree/main/skills/team-dev): `skills/team-dev`
- [Team Selector](https://github.com/bocal-pol/bocal-kit/tree/main/skills/team-selector): `skills/team-selector`

### Specialist Capabilities

- [Product Agent](https://github.com/bocal-pol/bocal-kit/blob/main/agents/product-agent.md): `agents/product-agent.md`
- [Tech Lead](https://github.com/bocal-pol/bocal-kit/tree/main/skills/tech-lead): `skills/tech-lead`
- [Specialist Agents](https://github.com/bocal-pol/bocal-kit/tree/main/agents): `agents`
- [Specialist Skills](https://github.com/bocal-pol/bocal-kit/tree/main/skills): `skills`
- [ICT Director](https://github.com/bocal-pol/bocal-kit/blob/main/agents/ict-director-agent.md): `agents/ict-director-agent.md`
- [Procurement Agent](https://github.com/bocal-pol/bocal-kit/blob/main/agents/public-procurement-agent.md): `agents/public-procurement-agent.md`

### Standalone Workflows

- [Goodnight CLI](https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/goodnight.mjs): `skills/goodnight/scripts/goodnight.mjs`
- [Quota State](https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/lib.mjs): `skills/goodnight/scripts/lib.mjs`
- [Claude Supervisor](https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/supervise.mjs): `skills/goodnight/scripts/supervise.mjs`
- [Codex Handoff](https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/handoff.mjs): `skills/goodnight/scripts/handoff.mjs`
- [Quota Guard](https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/guard.mjs): `skills/goodnight/scripts/guard.mjs`
- [Quota Statusline](https://github.com/bocal-pol/bocal-kit/blob/main/skills/goodnight/scripts/statusline.mjs): `skills/goodnight/scripts/statusline.mjs`

### Skill Runtimes

- [Figure Builder](https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/build.mjs): `skills/hairline-create/build.mjs`
- [Figure Kernel](https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/kernel.js): `skills/hairline-create/kernel.js`
- [Figure Review](https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/look.mjs): `skills/hairline-create/look.mjs`
- [SVG Reader](https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/read.mjs): `skills/hairline-create/read.mjs`
- [Figure Validator](https://github.com/bocal-pol/bocal-kit/blob/main/skills/hairline-create/validate.mjs): `skills/hairline-create/validate.mjs`

### Other components

- **Claude Code User**

## Connections

- Claude Code User → Team Dev Router: invokes (evidence: `README.md`)
- Team Dev Router → Team Selector: routes requests (evidence: `README.md`)
- Team Dev Router → Product Agent: delegates product (evidence: `README.md`)
- Team Dev Router → Tech Lead: delegates technical (evidence: `README.md`)
- Team Dev Router → Specialist Agents: routes modes (evidence: `README.md`)
- Specialist Agents → Specialist Skills: hands off implementation (evidence: `README.md`)
- Claude Code User → Specialist Skills: invokes directly (evidence: `README.md`)
- Claude Code User → ICT Director: invokes directly (evidence: `README.md`)
- Claude Code User → Procurement Agent: invokes directly (evidence: `README.md`)
- Goodnight CLI → Quota State: reads and writes (evidence: `skills/goodnight/scripts/goodnight.mjs`)
- Goodnight CLI → Claude Supervisor: starts supervision (evidence: `skills/goodnight/scripts/goodnight.mjs`)
- Goodnight CLI → Codex Handoff: starts handoff (evidence: `skills/goodnight/scripts/goodnight.mjs`)
- Quota Guard → Quota State: checks state (evidence: `skills/goodnight/scripts/guard.mjs`)
- Quota Statusline → Quota State: writes state (evidence: `skills/goodnight/scripts/statusline.mjs`)
- Figure Builder → Figure Kernel: embeds kernel (evidence: `skills/hairline-create/build.mjs`)
- Figure Review → Figure Builder: builds page (evidence: `skills/hairline-create/look.mjs`)
- Figure Review → Figure Validator: validates page (evidence: `skills/hairline-create/look.mjs`)
- Figure Review → SVG Reader: reads source SVG (evidence: `skills/hairline-create/look.mjs`)
- SVG Reader → Figure Review: uses browser helpers (evidence: `skills/hairline-create/read.mjs`)
