# focuslead/ai-council-framework architecture

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

- Interactive diagram: https://gitdiagram.com/focuslead/ai-council-framework
- Repository: https://github.com/focuslead/ai-council-framework

## Overview

The repository presents a research-backed methodology for multi-AI deliberation, not an implemented runtime: the tree contains documentation and examples but no source code. The graph follows the README’s documented user-to-answer protocol and roles; implementation details beyond that documentation are not inferred.

Main entry points: [`README.md`](https://github.com/focuslead/ai-council-framework/blob/main/README.md) (Synthesize consensus)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Council orchestration"]
  node_pm["Project manager<br/>[README.md]"]
  node_depth["Depth mode<br/>[README.md]"]
  node_members["Council members<br/>[README.md]"]
end

subgraph group_deliberation["Deliberation protocol"]
  node_distribute["Distribute prompt<br/>[README.md]"]
  node_collect["Collect responses<br/>[README.md]"]
  node_synthesize["Synthesize consensus<br/>[README.md]"]
  node_debate["Structured debate<br/>[README.md]"]
  node_consensus["Consensus scoring<br/>[README.md]"]
end

subgraph group_validation["Validation"]
  node_fresh_eyes["Fresh Eyes validator<br/>[README.md]"]
  node_web_search["Web search"]
  node_verify["Verification<br/>[README.md]"]
end

subgraph group_delivery["Decision output"]
  node_deliver["Final recommendation<br/>[README.md]"]
  node_human_decision(("Human decision<br/>[README.md]"))
end

node_human(("Human user"))

node_human -->|"submits question"| node_pm
node_human -->|"selects depth"| node_depth
node_depth -->|"guides rigor"| node_pm
node_pm -->|"orchestrates"| node_distribute
node_distribute -->|"sends prompt"| node_members
node_members -->|"provide responses"| node_collect
node_collect -->|"returns responses"| node_pm
node_pm -->|"synthesizes"| node_synthesize
node_synthesize -->|"scores claims"| node_consensus
node_synthesize -->|"surfaces disagreement"| node_debate
node_debate -->|"requests evidence"| node_members
node_debate -->|"informs revision"| node_synthesize
node_synthesize -->|"sends answer"| node_fresh_eyes
node_fresh_eyes -->|"validates constructively"| node_verify
node_verify -.->|"checks claims"| node_web_search
node_verify -->|"informs recommendation"| node_deliver
node_consensus -->|"provides scores"| node_deliver
node_deliver -->|"presents split decision"| node_human_decision

click node_pm "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_depth "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_members "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_distribute "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_collect "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_synthesize "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_debate "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_consensus "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_fresh_eyes "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_verify "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_deliver "https://github.com/focuslead/ai-council-framework/blob/main/README.md"
click node_human_decision "https://github.com/focuslead/ai-council-framework/blob/main/README.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_pm,node_depth,node_members,node_human toneBlue
class node_distribute,node_collect,node_synthesize,node_debate,node_consensus toneAmber
class node_fresh_eyes,node_web_search,node_verify toneMint
class node_deliver,node_human_decision toneRose
```

## Components

### Council orchestration

- [Project manager](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`
- [Depth mode](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`
- [Council members](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`

### Deliberation protocol

- [Distribute prompt](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`
- [Collect responses](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`
- [Synthesize consensus](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`
- [Structured debate](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`
- [Consensus scoring](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`

### Validation

- [Fresh Eyes validator](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`
- **Web search**
- [Verification](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`

### Decision output

- [Final recommendation](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`
- [Human decision](https://github.com/focuslead/ai-council-framework/blob/main/README.md): `README.md`

### Other components

- **Human user**

## Connections

- Human user → Project manager: submits question
- Human user → Depth mode: selects depth
- Depth mode → Project manager: guides rigor
- Project manager → Distribute prompt: orchestrates
- Distribute prompt → Council members: sends prompt
- Council members → Collect responses: provide responses
- Collect responses → Project manager: returns responses
- Project manager → Synthesize consensus: synthesizes
- Synthesize consensus → Consensus scoring: scores claims
- Synthesize consensus → Structured debate: surfaces disagreement
- Structured debate → Council members: requests evidence
- Structured debate → Synthesize consensus: informs revision
- Synthesize consensus → Fresh Eyes validator: sends answer
- Fresh Eyes validator → Verification: validates constructively
- Verification → Web search: checks claims
- Verification → Final recommendation: informs recommendation
- Consensus scoring → Final recommendation: provides scores
- Final recommendation → Human decision: presents split decision