# petronio2nd/delcouncil architecture

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

- Interactive diagram: https://gitdiagram.com/petronio2nd/delcouncil
- Repository: https://github.com/petronio2nd/delcouncil

## Overview

delcouncil combina um método de orquestração de agentes com skills, scripts e integrações para Claude Code e OpenCode. O fluxo principal é o orquestrador dividir a tarefa e escolher capacidade e executor; a dupla executa e pode acionar revisão cruzada conforme risco, enquanto a trava global controla fontes de consumo. Os mods aplicam roteamento e proteções nos harnesses e oferecem visibilidade de sessão. O README documenta capacidades cujas implementações não foram amostradas; relações entre esses módulos foram omitidas quando não havia evidência suficiente.

Main entry points: [`mods/orquestra/hooks/register.tsx`](https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/register.tsx) (Harness Orquestra), [`skills/orquestrador/SKILL.md`](https://github.com/petronio2nd/delcouncil/blob/main/skills/orquestrador/SKILL.md) (Orquestrador), [`mods/orquestra/hooks/rota-claude.ts`](https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/rota-claude.ts) (Rota Claude), [`mods/orquestra/hooks/fontes.ts`](https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/fontes.ts) (Regras de fontes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Orquestração e revisão"]
  node_orchestrator["Orquestrador<br/>[SKILL.md]"]
  node_policy["Política de modelos"]
  node_dupla["Dupla e executores<br/>[SKILL.md]"]
  node_reviewer["Revisor cruzado<br/>[SKILL.md]"]
  node_source_lock["Trava de fontes<br/>[fontes.ps1]"]
end

subgraph group_harness["Integrações de agentes"]
  node_routing_rules["Regras de rota<br/>[roteamento.ts]"]
  node_claude_route["Rota Claude<br/>[rota-claude.ts]"]
  node_orquestra_register["Harness Orquestra<br/>[register.tsx]"]
  node_gemeo["Plugin Gêmeo<br/>[index.ts]"]
  node_gemeo_route["Rota OpenCode<br/>[rota.ts]"]
  node_gemeo_sources["Fontes OpenCode<br/>[fontes.ts]"]
  node_quota["Cotas e consumo<br/>[cotas.ts]"]
  node_source_rules["Regras de fontes<br/>[fontes.ts]"]
  node_source_claude["Leitura de fontes<br/>[fontes-claude.ts]"]
end

subgraph group_session["Sessão e proteções"]
  node_dashboard["Painel de sessões<br/>[leitura.ts]"]
  node_session_status["Faixa de uso<br/>[register.tsx]"]
  node_status_meter["Medidor de uso<br/>[format.ts]"]
  node_wait_guard["Modo aguardar<br/>[rules.ts]"]
  node_secret_guard["Proteção de segredos<br/>[rules.ts]"]
  node_portuguese["Idioma português<br/>[lang.ts]"]
  node_session_naming["Nome da sessão<br/>[exigir-nome.py]"]
  node_session_status_name["Estado no título<br/>[register.ts]"]
end

subgraph group_skills["Skills especializadas"]
  node_specialist_skills["Skills de método"]
  node_analysis_skill["Análise documental<br/>[SKILL.md]"]
  node_debug_skill["Depuração e código<br/>[SKILL.md]"]
  node_report_skill["Relatórios e metas<br/>[SKILL.md]"]
end

node_user(("Usuário"))

node_user -->|"solicita tarefa"| node_orchestrator
node_orchestrator -->|"consulta política"| node_policy
node_orchestrator -->|"despacha fatias"| node_dupla
node_orchestrator -->|"confere entrega"| node_reviewer
node_dupla -->|"controla consumo"| node_source_lock
node_orquestra_register -->|"inicia rota"| node_claude_route
node_orquestra_register -->|"consulta fontes"| node_source_rules
node_orquestra_register -->|"lê fontes"| node_source_claude
node_orquestra_register -->|"consulta cotas"| node_quota
node_orquestra_register -->|"usa lógica"| node_dashboard
node_claude_route -->|"valida rota"| node_routing_rules
node_claude_route -->|"verifica bloqueio"| node_source_rules
node_claude_route -->|"lê estado"| node_source_claude
node_gemeo -->|"aplica rota"| node_gemeo_route
node_gemeo -->|"verifica fonte"| node_gemeo_sources
node_gemeo_route -->|"escolhe rota"| node_routing_rules
node_gemeo_sources -->|"reutiliza regras"| node_source_rules
node_session_status -.->|"formata status"| node_status_meter
node_user -->|"usa skill"| node_specialist_skills
node_user -->|"inicia análise"| node_analysis_skill
node_user -->|"investiga defeito"| node_debug_skill
node_user -->|"gera relatório"| node_report_skill

click node_orchestrator "https://github.com/petronio2nd/delcouncil/blob/main/skills/orquestrador/SKILL.md"
click node_policy "https://github.com/petronio2nd/delcouncil/blob/main/skills/orquestrador/politica-modelos.json"
click node_dupla "https://github.com/petronio2nd/delcouncil/blob/main/skills/dupla/SKILL.md"
click node_reviewer "https://github.com/petronio2nd/delcouncil/blob/main/skills/revisor/SKILL.md"
click node_source_lock "https://github.com/petronio2nd/delcouncil/blob/main/skills/dupla/scripts/fontes.ps1"
click node_routing_rules "https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/roteamento.ts"
click node_claude_route "https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/rota-claude.ts"
click node_orquestra_register "https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/register.tsx"
click node_gemeo "https://github.com/petronio2nd/delcouncil/blob/main/mods/gemeo/index.ts"
click node_gemeo_route "https://github.com/petronio2nd/delcouncil/blob/main/mods/gemeo/rota.ts"
click node_gemeo_sources "https://github.com/petronio2nd/delcouncil/blob/main/mods/gemeo/fontes.ts"
click node_quota "https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/cotas.ts"
click node_source_rules "https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/fontes.ts"
click node_source_claude "https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/fontes-claude.ts"
click node_dashboard "https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/leitura.ts"
click node_session_status "https://github.com/petronio2nd/delcouncil/blob/main/mods/session-band/hooks/register.tsx"
click node_status_meter "https://github.com/petronio2nd/delcouncil/blob/main/mods/medidor/hooks/format.ts"
click node_wait_guard "https://github.com/petronio2nd/delcouncil/blob/main/mods/aguardar/hooks/rules.ts"
click node_secret_guard "https://github.com/petronio2nd/delcouncil/blob/main/mods/segredos/hooks/rules.ts"
click node_portuguese "https://github.com/petronio2nd/delcouncil/blob/main/mods/portugues/hooks/lang.ts"
click node_session_naming "https://github.com/petronio2nd/delcouncil/blob/main/mods/nome-sessao/exigir-nome.py"
click node_session_status_name "https://github.com/petronio2nd/delcouncil/blob/main/mods/status-nome/hooks/register.ts"
click node_specialist_skills "https://github.com/petronio2nd/delcouncil/tree/main/skills"
click node_analysis_skill "https://github.com/petronio2nd/delcouncil/blob/main/skills/iniciar-analise/SKILL.md"
click node_debug_skill "https://github.com/petronio2nd/delcouncil/blob/main/skills/dev-debug/SKILL.md"
click node_report_skill "https://github.com/petronio2nd/delcouncil/blob/main/skills/status-report/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_orchestrator,node_policy,node_dupla,node_reviewer,node_source_lock toneBlue
class node_routing_rules,node_claude_route,node_orquestra_register,node_gemeo,node_gemeo_route,node_gemeo_sources,node_quota,node_source_rules,node_source_claude toneAmber
class node_dashboard,node_session_status,node_status_meter,node_wait_guard,node_secret_guard,node_portuguese,node_session_naming,node_session_status_name toneMint
class node_specialist_skills,node_analysis_skill,node_debug_skill,node_report_skill toneRose
class node_user toneIndigo
```

## Components

### Orquestração e revisão

- [Orquestrador](https://github.com/petronio2nd/delcouncil/blob/main/skills/orquestrador/SKILL.md): `skills/orquestrador/SKILL.md`
- [Política de modelos](https://github.com/petronio2nd/delcouncil/blob/main/skills/orquestrador/politica-modelos.json): `skills/orquestrador/politica-modelos.json`
- [Dupla e executores](https://github.com/petronio2nd/delcouncil/blob/main/skills/dupla/SKILL.md): `skills/dupla/SKILL.md`
- [Revisor cruzado](https://github.com/petronio2nd/delcouncil/blob/main/skills/revisor/SKILL.md): `skills/revisor/SKILL.md`
- [Trava de fontes](https://github.com/petronio2nd/delcouncil/blob/main/skills/dupla/scripts/fontes.ps1): `skills/dupla/scripts/fontes.ps1`

### Integrações de agentes

- [Regras de rota](https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/roteamento.ts): `mods/orquestra/hooks/roteamento.ts`
- [Rota Claude](https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/rota-claude.ts): `mods/orquestra/hooks/rota-claude.ts`
- [Harness Orquestra](https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/register.tsx): `mods/orquestra/hooks/register.tsx`
- [Plugin Gêmeo](https://github.com/petronio2nd/delcouncil/blob/main/mods/gemeo/index.ts): `mods/gemeo/index.ts`
- [Rota OpenCode](https://github.com/petronio2nd/delcouncil/blob/main/mods/gemeo/rota.ts): `mods/gemeo/rota.ts`
- [Fontes OpenCode](https://github.com/petronio2nd/delcouncil/blob/main/mods/gemeo/fontes.ts): `mods/gemeo/fontes.ts`
- [Cotas e consumo](https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/cotas.ts): `mods/orquestra/hooks/cotas.ts`
- [Regras de fontes](https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/fontes.ts): `mods/orquestra/hooks/fontes.ts`
- [Leitura de fontes](https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/fontes-claude.ts): `mods/orquestra/hooks/fontes-claude.ts`

### Sessão e proteções

- [Painel de sessões](https://github.com/petronio2nd/delcouncil/blob/main/mods/orquestra/hooks/leitura.ts): `mods/orquestra/hooks/leitura.ts`
- [Faixa de uso](https://github.com/petronio2nd/delcouncil/blob/main/mods/session-band/hooks/register.tsx): `mods/session-band/hooks/register.tsx`
- [Medidor de uso](https://github.com/petronio2nd/delcouncil/blob/main/mods/medidor/hooks/format.ts): `mods/medidor/hooks/format.ts`
- [Modo aguardar](https://github.com/petronio2nd/delcouncil/blob/main/mods/aguardar/hooks/rules.ts): `mods/aguardar/hooks/rules.ts`
- [Proteção de segredos](https://github.com/petronio2nd/delcouncil/blob/main/mods/segredos/hooks/rules.ts): `mods/segredos/hooks/rules.ts`
- [Idioma português](https://github.com/petronio2nd/delcouncil/blob/main/mods/portugues/hooks/lang.ts): `mods/portugues/hooks/lang.ts`
- [Nome da sessão](https://github.com/petronio2nd/delcouncil/blob/main/mods/nome-sessao/exigir-nome.py): `mods/nome-sessao/exigir-nome.py`
- [Estado no título](https://github.com/petronio2nd/delcouncil/blob/main/mods/status-nome/hooks/register.ts): `mods/status-nome/hooks/register.ts`

### Skills especializadas

- [Skills de método](https://github.com/petronio2nd/delcouncil/tree/main/skills): `skills`
- [Análise documental](https://github.com/petronio2nd/delcouncil/blob/main/skills/iniciar-analise/SKILL.md): `skills/iniciar-analise/SKILL.md`
- [Depuração e código](https://github.com/petronio2nd/delcouncil/blob/main/skills/dev-debug/SKILL.md): `skills/dev-debug/SKILL.md`
- [Relatórios e metas](https://github.com/petronio2nd/delcouncil/blob/main/skills/status-report/SKILL.md): `skills/status-report/SKILL.md`

### Other components

- **Usuário**

## Connections

- Usuário → Orquestrador: solicita tarefa (evidence: `README.md`)
- Orquestrador → Política de modelos: consulta política (evidence: `README.md`)
- Orquestrador → Dupla e executores: despacha fatias (evidence: `README.md`)
- Orquestrador → Revisor cruzado: confere entrega (evidence: `README.md`)
- Dupla e executores → Trava de fontes: controla consumo (evidence: `README.md`)
- Harness Orquestra → Rota Claude: inicia rota (evidence: `mods/orquestra/hooks/register.tsx`)
- Harness Orquestra → Regras de fontes: consulta fontes (evidence: `mods/orquestra/hooks/register.tsx`)
- Harness Orquestra → Leitura de fontes: lê fontes (evidence: `mods/orquestra/hooks/register.tsx`)
- Harness Orquestra → Cotas e consumo: consulta cotas (evidence: `mods/orquestra/hooks/register.tsx`)
- Harness Orquestra → Painel de sessões: usa lógica (evidence: `mods/orquestra/hooks/register.tsx`)
- Rota Claude → Regras de rota: valida rota (evidence: `mods/orquestra/hooks/rota-claude.ts`)
- Rota Claude → Regras de fontes: verifica bloqueio (evidence: `mods/orquestra/hooks/rota-claude.ts`)
- Rota Claude → Leitura de fontes: lê estado (evidence: `mods/orquestra/hooks/rota-claude.ts`)
- Plugin Gêmeo → Rota OpenCode: aplica rota (evidence: `mods/gemeo/index.ts`)
- Plugin Gêmeo → Fontes OpenCode: verifica fonte (evidence: `mods/gemeo/index.ts`)
- Rota OpenCode → Regras de rota: escolhe rota (evidence: `mods/gemeo/rota.ts`)
- Fontes OpenCode → Regras de fontes: reutiliza regras (evidence: `mods/gemeo/fontes.ts`)
- Faixa de uso → Medidor de uso: formata status
- Usuário → Skills de método: usa skill (evidence: `README.md`)
- Usuário → Análise documental: inicia análise (evidence: `README.md`)
- Usuário → Depuração e código: investiga defeito (evidence: `README.md`)
- Usuário → Relatórios e metas: gera relatório (evidence: `README.md`)
