---
name: feedback-data-expert-workflow
description: "Workflow di aggiornamento della conoscenza dominio ICR (data-expert.md) — scrittura immediata da parte di Adrian durante sessioni sul dominio, senza aspettare fine sessione"
metadata:
  type: feedback
---

**⚠️ Aggiornato il 30/08/2026**: la regola originale (04/08/2026) descriveva un "dual-write" tra
`archivio/Adrian/agenti/data-expert.md` (la KB) e `.claude/agents/data-expert.md` (le istruzioni
sintetiche del subagente `data-expert`). Il subagente è stato **dismesso** il 30/08/2026 —
preferenza esplicita di Mauro per istanze persistenti/nominabili (la classe "esperti", vedi
`archivio/Adrian/riferimento/claude-cli-headless.md`) invece di subagenti dentro `.claude/agents/`,
percepiti come meno chiari/più fonte di confusione. Il suo ruolo di consultazione è assorbito da
`expert-data` (`scripts/slave-sentinels/expert-data/CLAUDE.md`). Resta **un solo file** da
aggiornare: `data-expert.md`. La regola sotto (scrivere subito, non aspettare) resta valida,
solo non più "dual".

## Scrivere subito nella KB, non aspettare fine sessione

Quando Mauro conferma una regola di business logic o una convenzione operativa nel dominio dati
ICR (es. "usa solo edizione 1", "ALTRI sempre in coda", "veg non provenienza"), va scritta
**subito** in `archivio/Adrian/agenti/data-expert.md`, con tag `[CONFERMATO]` — non è un output da
proporre e aspettare, è un documento vivo che si aggiorna mentre la conversazione procede.

**Why:** confermato da Mauro il 2026-07-17 dopo una sessione intensiva in cui questo pattern è
stato seguito con successo ("Hai fatto molto bene. Anche queste convenzioni sul layout è
importante che le assimili"). Una scoperta "solo detta in conversazione" e mai scritta è persa
alla prossima sessione — non serve invocare formalmente un agente dedicato per farlo, è Adrian
stesso (nella sessione diretta con Mauro) a scrivere mentre la conversazione procede.

**How to apply:** quando Mauro dice qualcosa tipo "lavoriamo sui dati ICR/PowerBricks" o è già
chiaro dal contesto (parla di rifer, edizione, diritti, veg, tipologie, ecc.), trattare ogni sua
affermazione di fatto come materiale `[CONFERMATO]` da scrivere subito nella KB — non aspettare la
fine sessione, non chiedere conferma per scrivere (il meccanismo è già validato). Per
investigazioni più ampie su dati/schema non ancora visti, `expert-data` può esplorare (ha gli
stessi strumenti Bash/duckdb) ma **segnala** invece di scrivere direttamente — la scrittura in
`data-expert.md` resta ad Adrian finché non si sblocca il criterio operativo/architetturale
(vedi `claude-cli-headless.md`).