Architettura modulare · Versione build 2026.05.31

L'agente di Alessandra

Architettura modulare a 12 strati per un agente Claude personalizzato. Ogni strato è un modulo indipendente: memoria persistente, brand context, skill specializzate, sub-agent dedicati, guardrail di sicurezza, hook deterministici, struttura output organizzata.

Motore: Claude Opus 4.7 (1M context) Ambiente: file-based, locale 12 strati su 12 attivi 53/53 check di sanità ✅
10
Sub-agent
10
Skill custom
4
Hook deterministici
5
Script supporto
4
Livelli Guardrail
3
Tier memoria
2
Plugin distribuibili

I 12 strati dell'architettura

Ogni card rappresenta uno strato. Click per dettagli completi (cos'è, cosa contiene, file di riferimento, limiti). Tutti i 12 strati attivi dopo l'integrazione Notion MCP del 31 maggio 2026.

01 ATTIVO
🧠
Modello

Il cervello — Opus 4.7

Claude Opus 4.7 con 1M token di contesto. Da solo sa molto di mondo ma nulla di Alessandra. Il resto del sistema "lo onboarda" ad ogni sessione.

1Mcontesto
Opus 4.7modello
02 ATTIVO
📝
Contesto Alessandra

CLAUDE.md + regole

Il file che plasma identità, perimetro, regole, ritmi, priorità. Caricato automaticamente a ogni sessione.

1file root
~350righe regole
03 ATTIVO
Contesto Coesiva

Brand & Know-how

Modulo brand caricato su richiesta quando l'output deve essere riconoscibilmente Coesiva (deck, slide, post LinkedIn, materiali commerciali).

5file md
#6903DCviola brand
04 ATTIVO
🧠
Memoria · 3 tier

Memoria persistente

Working memory (settimana) + memo semantici (mesi) + lessons learned (sempre). Indicizzata in MEMORY.md, letta a ogni apertura sessione.

3tier
4memo seed T2
05 ATTIVO
🚀
Skill

Comandi specializzati

10 skill custom + catena strategica 6 step formalizzata (31 mag) + libreria 5 fondamenti strategici (Ehrenberg-Bass, JTBD, Category Design, Brand Architecture, Strategic Tension).

10skill
5plugin disattivate
06 ATTIVO
🤖
Sub-agent

10 esecutori delegati

Istanze separate del modello in .claude/agents/. Parsing (PDF, Excel, transcript), Research, Producer, Evaluator, System-auditor.

10sub-agent
3famiglie
07 ATTIVO
Hook deterministici

Codice che gira sempre

4 hook shell che girano prima/dopo le azioni dell'agente: anti-distruttivo, backup pre-Edit, log sub-agent, SessionStart briefing.

4hook attivi
11/11test OK
08 ATTIVO
🔌
Integrazioni native

Notion MCP · Google Calendar (in coda)

Workspace Notion dedicato a Coesiva connesso via MCP nativo. HQ + 4 sezioni satellite + 3 database (Progetti, Task, Documenti). Regola d'ingaggio in Integrazioni/Notion-Coesiva.md.

1connessa
1in coda
09 ATTIVO
📦
Plugin distribuibili

Backup + 2 plugin modulari

Backup completo tar.gz (9.5 MB) per migrazione/ripristino. 2 plugin modulari per condivisione team Coesiva. Doc master in _DISTRIBUTION.md.

1tar.gz backup
2plugin + zip
10 ATTIVO
🔒
Guardrail

4 livelli protezione

L1 anti-assunzione, L2 anti-conferma, L3 anti-sincopatia, L4 verifica multi-agente. Triage tabellare 14 output × 6 livelli. File protetti.

4livelli L1-L4
13file protetti
11 ATTIVO
🐍
Script supporto

5 utility Python/Shell

memory_lint, health_check, leverage_kpi, build_skill, export_deck_pptx. Manutenzione automatica, monitoraggio salute sistema, KPI.

5script
3Python + 2 Shell
12 ATTIVO
📊
Output & Dataset

Cartelle + KPI + log

Cartelle output organizzate (CLIENTI COESIVA, Strategia, Gestione, Weekly-Reviews). Log YAML sub-agent automatico. KPI di auto-osservazione.

3KPI agente
YAMLlog auto

🔍 Audit 29 maggio + decisioni post-build

Al termine della build sono stati lanciati 2 agenti esterni in parallelo: Auditor Tecnico (verifica coerenza, file, cross-refs, refusi) e Challenger Strategico (sfida le scelte architetturali). Il challenger ha identificato overengineering reale + gap concettuali. È stata applicata l'Opzione C: fix critici + 2 gap colmati + congelamento.

✅ Fix applicati (Opzione C)

  • Lista file protetti completata in CLAUDE.md + Guardrails.md (+ .claude/agents/, kpi, leverage-kpi)
  • Date stale sync (MEMORY.md + lessons-learned.md → 29 maggio)
  • Skill PMBOK name allineato al filename
  • 8 mantra cosmetici rimossi dai brief sub-agent
  • "Lateralità obbligatoria" → "raccomandata con principio non-inventare"
  • Inflazione reference (McKinsey/Wolff Olins) tolta da strategy-evaluator
  • 4 famiglie vuote MEMORY potate (coperte altrove)
  • Sub-agent transcript-parser aggiunto (gap call CNA)
  • Skill /weekly-review aggiunta (gap rituale fine settimana)
  • Lesson learned meta sulla replicazione architetture esterne

🧊 Cosa NON è stato tagliato (rinviato a luglio)

  • deck-producer / document-producer — decidere a luglio dopo uso reale Sprint 2 CNA
  • system-auditor — utile per prossimo audit luglio
  • 2 plugin distribuibili — restano, costo zero, valore futuro
  • Apparato KPI — dormiente, attivato quando popolato

A fine giugno 2026: rilanciare system-auditor con dati di uso reale → taglio per sottrazione. Stima: 30-40% del sistema sparirà. (Strato 8 Integrazioni attivato il 31 maggio con Notion MCP — non più nella lista dei rinviati.)

Timeline costruzione

28 mag · sera
Costruita la Memoria 3-tier (working + 4 memo seed + lessons learned + indice MEMORY.md). Costruito il modulo Contesto Coesiva (4 file md: Design-System, Design-Tokens, Voice-Coesiva, Knowledge-Base + README). Risolte 3 incoerenze tra brandbook 2023 e template HTML 2026 (opzione 2 — template HTML autoritativo). Audit skill locali: 5 archiviate Tier C, 5 pulite Tier B, 2 intatte Tier A. Mail corretta beta@→alessandra@.
29 mag · mattina
Installato Homebrew + poppler (per leggere PDF). Audit skill plugin (5 Tier C disattivate con regola HARD in CLAUDE.md). Costruiti i Guardrail L1-L4 potenziati su richiesta esplicita ("voglio output controllati e verificati anche da subagenti"). Sistema Output & Dataset: cartelle, KPI files vuoti, log-interactions YAML.
29 mag · pomeriggio
Costruiti i 7 sub-agent in 3 sessioni: A (skill deep-research + pdf-parser + excel-parser), B (deep-research-agent + strategy-evaluator + deck-evaluator), C (deck-producer-coesiva + document-producer-coesiva). Costruito system-auditor per audit periodici.
29 mag · sera-1
Costruiti i 4 hook deterministici (anti-distruttivo Bash, backup pre-Edit, log sub-agent YAML, SessionStart briefing) — testati 11/11 scenari OK. Costruiti i 5 script di supporto Python/Shell. Costruiti i plugin distribuibili (backup tar.gz + 2 plugin modulari + .zip + doc master _DISTRIBUTION.md).
29 mag · sera-2
Audit finale: lanciati Auditor Tecnico + Challenger Strategico in parallelo. Auditor: GO con 3 fix. Challenger: "Sì con riserve, congela e usa". Applicata Opzione C: 10 fix mirati + 2 gap colmati (transcript-parser + /weekly-review). Dichiarato congelamento Fase 1 fino a metà luglio. Aggiunta lesson learned meta sulla replicazione architetture esterne.
31 mag · rottura motivata del congelamento
Porting di 5 spunti strategici identificati da confronto con un agente gemello: nuovo sub-agent strategy-diverger (Opus, lateralità ancorata ai dati), nuovo file Strategia/Catena-Strategica.md (protocollo 6 step), nuova libreria fondamenti-strategici.md (5 teorie: Ehrenberg-Bass, JTBD, Category Design, Brand Architecture, Strategic Tension), strategy-evaluator potenziato (5ª dimensione verifica fonti via WebFetch), document-producer upgrade Sonnet→Opus, skill ricerca-analisi-strategica con regola dura WebSearch/WebFetch obbligatorio. Motivazione: progetto strategico in arrivo (Sprint 2 CNA Modena). Congelamento resta attivo per tutto il resto.
31 mag · Strato 08 attivato — Notion MCP
Costruito strato Integrazioni Native. Workspace Notion dedicato "Coesiva" creato (fisicamente separato dal Notion personale), connector MCP installato via Cowork, boundary test passato (0 leak). Struttura: Coesiva | Ale HQ + 4 sezioni satellite (Progetti e Task, To Do Settimanale, Calendario, Document Hub) + 3 database (Progetti, Task con Relation bidirezionale → Progetti, Documenti). Permessi: Read + Create + Update, NO Delete. Google Calendar MCP richiesto ad Anthropic ("Request" inviata, in coda). Regola d'ingaggio formalizzata in Integrazioni/Notion-Coesiva.md: whitelist ID, trigger di attivazione, sorgente di verità, procedura To Do Settimanale del lunedì. 12 strati su 12 attivi.
Sistema agente Alessandra — Build 2026.05.31
12 strati su 12 attivi · 53/53 check di sanità · Fase 1 chiusa
Audit periodico programmato dopo periodo di uso reale — system-auditor, taglio per sottrazione