# LLMHosts — AI Advisory Council

## Purpose

This council exists to stress-test every architectural decision in the LLMHosts platform before it becomes code. The project operates at the intersection of GPU systems engineering, distributed AI, privacy-preserving machine learning, and open-source business models — a domain where the cost of unexamined assumptions is months of rework, not days.

## Philosophy

> "The best ideas survive the harshest scrutiny. If a decision cannot defend itself against 12 domain experts, it should not be implemented."

The advisory council exists to:
1. **Challenge assumptions** — every design decision must survive expert scrutiny
2. **Surface blind spots** — no single perspective catches everything
3. **Prevent groupthink** — mandatory dissent on every major decision
4. **Raise the bar** — push from "good" to "excellent" on every dimension
5. **Protect users** — the council advocates for users when no user is in the room

## The 14-Voice Council

| # | Name | Role | Domain |
|---|------|------|--------|
| — | **Project Owner** | Final Authority | Vision, tiebreaker |
| 0 | **Arbiter (AI)** | Facilitator | Synthesis, scoring, process |
| 1 | **Dr. Priya Raghunathan** | GPU Performance | CUDA kernels, inference perf, benchmarking |
| 2 | **Marcus Okonkwo** | Security | Supply chain, marketplace trust, Rust audit |
| 3 | **Dr. Adaeze Obi** | Privacy/FL | Differential privacy, federated learning, GDPR |
| 4 | **Amara Nwosu** | Business Strategy | Marketplace economics, pricing, GTM |
| 5 | **Yuki Tanaka** | Developer Experience | CLI UX, onboarding, first-run |
| 6 | **Dr. Santiago Vega** | Distributed Systems | Relay, concurrency, reliability |
| 7 | **Elena Marchetti** | IP/Legal | BSL, trade secrets, license compliance |
| 8 | **Dr. Rafael Kim** | MLOps/Fine-Tuning | LoRA, GGUF, Unsloth, QLoRA |
| 9 | **Fatima Al-Rashid** | Competitive Intelligence | Ollama, SaladCloud, vLLM, market timing |
| 10 | **Dr. Kwame Boateng** | Cross-Platform GPU | AMD ROCm, CubeCL, Intel Arc, Apple Metal |
| 11 | **Zara Ibrahim** | Customer Experience | User journey, retention, aha moment |
| 12 | **Dr. Hans Bergström** | Systems Risk | Engineering capacity, tech debt, architecture |

## Sessions

| Date | Type | Topic | PQS | Gaps |
|------|------|-------|-----|------|
| 2026-03-10 | SIMULATION | Vision 2026 Full Design Review | 56.5/100 | 20 gaps |

## Session Protocol

1. **Topic framing** — Arbiter presents the question or decision under review
2. **Independent assessment** — Each advisor evaluates independently
3. **Position statements** — Each advisor states their position with evidence
4. **Cross-examination** — Advisors challenge each other's positions
5. **Red team (MANDATORY)** — At least 3 advisors MUST argue AGAINST the emerging consensus
6. **Synthesis** — Arbiter synthesizes positions into a recommendation with PQS impact
7. **Vote** — Each advisor votes: GO / GO WITH CONDITIONS / NO-GO

### Voting Thresholds

| Decision Type | Required Votes |
|---------------|---------------|
| Feature addition | ≥ 8/12 |
| Architecture change | ≥ 10/12 |
| Risk parameter change | ≥ 11/12 |
| Pivot or major shift | ≥ 10/12 + Owner approval |

## Directory Structure

```
docs/debate/
├── README.md                          — This file
├── project-analysis.md                — Deep project analysis (foundation)
├── advisors/
│   ├── 01-dr-priya-raghunathan.md    — GPU Performance Advisor
│   ├── 02-marcus-okonkwo.md          — Security Advisor
│   ├── 03-dr-adaeze-obi.md           — Privacy/FL Advisor
│   ├── 04-amara-nwosu.md             — Business Strategy Advisor
│   ├── 05-yuki-tanaka.md             — Developer Experience Advisor
│   ├── 06-dr-santiago-vega.md        — Distributed Systems Advisor
│   ├── 07-elena-marchetti.md         — IP/Legal Advisor
│   ├── 08-dr-rafael-kim.md           — MLOps/Fine-Tuning Advisor
│   ├── 09-fatima-al-rashid.md        — Competitive Intelligence Advisor
│   ├── 10-dr-kwame-boateng.md        — Cross-Platform GPU Advisor
│   ├── 11-zara-ibrahim.md            — Customer Experience Advisor
│   ├── 12-dr-hans-bergstrom.md       — Systems Risk Advisor
│   └── alliance-conflict-map.md      — Council dynamics
└── sessions/
    └── 2026-03-10-vision-2026-simulation.md — Vision 2026 full review

docs/scoring/
├── README.md                          — PQS framework
└── scorecards/
    └── 2026-03-10-vision-2026.md      — Current scorecard
```
