# Capability Map: Superman — Agente Unico di Market Intelligence

> Fase 0 (spec-driven development). Risposta alla direttiva: l'approccio dei DUE agenti
> Gemini Enterprise (Clark + Kent) non funziona → UN agente unico con TUTTE le funzionalità
> previste nei documenti (`01_Agente_Clark.md`, `02_Agente_Kent.md`, `10_REQUISITI_V2.md`,
> `11_SPEC_V2_CLARK.md`, `03_STORICIZZAZIONE_e_DIFF.md`).

## Nome

**Superman** — unione naturale di **Clark** (benchmark) e **Kent** (digest & condivisione).
Rispetta la convenzione del team (nome inglese riconoscibile, allude al ruolo, no punteggiatura,
pop culture). Nomi alternativi scartati: *Clarky* (perde la parte Kent), *Beacon* (non pop culture).

## Moduli

| Module id | Responsabilità | Dipende da |
|---|---|---|
| `agent-core` | System instructions agente unico: 5 ruoli interni (Coordinatore, Collector, Validatore, Reporter, Publisher) ≤ 30k caratteri | — |
| `engine` | Pipeline Python: migrate/validate/diff/digest/publish, schema dati v2, fingerprint, confidenze | agent-core (stessa spec) |
| `site` | Sito professionale su t8agent.mailittlexp.org: benchmark live, digest, spec, governance | engine (dati), agent-core (spec) |
| `ops` | Deploy (CF Pages + dominio), runbook run mattutino, cron opzionale con dichiarazione consumo LLM | site, engine |

Build order: agent-core → engine → site → ops.

## Fonti di verità delle funzionalità (tutte incorporate)

| Documento | Funzionalità ereditate |
|---|---|
| `01_Agente_Clark.md` (V1) | benchmark per ambito FIXED/MOBILE/PHONE, ID stabili, diff novità, snapshot JSON, report daily |
| `02_Agente_Kent.md` | digest Teams leggibile da telefonino, pubblicazione con fallback copia/incolla, messaggio di lancio |
| `10_REQUISITI_V2.md` | 39 requisiti SRC/DAT/FUN/NFR/GOV/QLT (anti-spoofing, schema v2, governance, KPI) |
| `11_SPEC_V2_CLARK.md` | pipeline ruoli interni in UN agente (già bozza dell'unificazione → ora diventa requisito), schema JSON v2, gestione errori |
| `03_STORICIZZAZIONE_e_DIFF.md` | convenzione cartelle, retention 90 giorni, logica diff, schema SQLite fase 2 |

## Non-scope (dichiarati)

- Scraping live integrale di tutti gli operatori → fase 2 (adapter `fetcher.py` pronto, test su fonti statiche).
- Scheduling automatico 8:00 → ops fase 2 (cron opzionale, consumo LLM dichiarato nel runbook).
- Connessione connector Teams/SharePoint di Gemini Enterprise → dipende dai permessi account; fallback copia/incolla sempre disponibile.
