Prompt per Claude Code

Contesto: in questa sessione di Claude Code potrei NON avere il repo/codice
caricato. Per prima cosa apri ENTRAMBI i repo, `~/Projects/api-kross-mattone`
(provisioning, custom tool + skill, config agente) e `~/Projects/mattone-platform`
(connessioni / pms_integrations / Vault / bridge Notion), e LEGGI le pagine
mattone-docs /onboarding/stato-e-continuazione e /onboarding/panoramica (matrice
passi×stato + dipendenze di fase); per lo stato reale usa gli MCP (Supabase per
pms_integrations e Vault, Conduit per l'agente). Poi procedi:

Dimmi a che punto è l'onboarding dello studente [NOME] e da dove riprendere.
Ricostruisci la MATRICE passi×stato (Anagrafica, Kross, Conduit, Smart check-in,
Stripe, verifica) assegnando a ognuno uno dei cinque stati: non iniziato / non
ora / in corso / collegato / verificato. Incrocia SEMPRE tre fonti reali:
1) la vista /connessioni (stato per-connettore, vista studente),
2) la tabella pms_integrations su Supabase (verità macchina + timestamp),
3) il Vault (presenza delle credenziali cifrate per quel connettore, se manca,
   il passo NON è davvero "collegato").
Ricorda che "collegato" != "funziona": per ogni passo collegato leggi i log e
verifica dal vivo (prenotazione letta, porta aperta, link Stripe generato).

GATE Conduit: prima di attivare o provisionare QUALSIASI workspace agente,
verifica che (a) il contratto "Servizio AI Ospiti" sia FIRMATO
(contract_signed = true) E (b) la carta sia a file in piattaforma (metodo di
pagamento aggiunto dallo studente). Se manca anche solo una delle due, NON
attivare nulla: segnalalo come blocco.

GUARDRAIL Conduit (non negoziabile): non cambiare MAI stati in massa via API
(resolve/dismiss/close/archive su escalation, gruppi, ticket, contatti,
workflow): il 07/09/2026 un batch di resolve ha spento per sempre il
raggruppamento delle escalation su due workspace, senza comando in UI per
tornare indietro. Prima di qualunque scrittura in massa chiedi alla chat di
supporto AI dentro Conduit cosa dipende da quello stato; lo stato "gestita"
si tiene da noi (Notion/Slack), non in Conduit.

Alla fine dimmi, richiamando i repo e le pagine docs che hai usato: il PRIMO
passo non ancora verificato (= da dove ripartire), cosa è in "non ora"
(rimandato di proposito) e cosa manca ancora dallo studente (così posso
avvisarlo, vedi il prompt "Avvisare lo studente di cosa gli manca"). Non
inventare: se una fonte non è leggibile nella sessione, dillo.

Contesto: in questa sessione di Claude Code potrei NON avere il repo/codice
caricato. Per prima cosa apri ENTRAMBI i repo, `~/Projects/api-kross-mattone`
(skill di onboarding, custom tool + catalog.json, provisioning Kross/Conduit) e
`~/Projects/mattone-platform` (connessioni / pms_integrations / Vault / bridge
Notion), e LEGGI le pagine mattone-docs /delivery/monitorare-studenti e
/onboarding/stato-e-continuazione; per lo stato reale usa gli MCP (Supabase per
pms_integrations e Vault, e, se serve confermare l'agente, Conduit in SOLA
LETTURA: get_automation_rate, list_*, simulate_conversation). Poi procedi:

Monitora l'AVANZAMENTO dell'onboarding dello studente [NOME] e dimmi, per OGNI
integrazione (Anagrafica/Notion, Kross, Conduit, Smart check-in, Stripe), a che
punto è. Per ognuna incrocia tre fonti reali:
1) la vista /connessioni (stato per-connettore, vista studente),
2) la tabella pms_integrations su Supabase (verità macchina + timestamp),
3) il Vault (presenza delle credenziali cifrate, se manca, NON è davvero
   "collegato").
Ricorda che "collegato" != "funziona": dove serve, conferma dal vivo ma in sola
lettura (una prenotazione letta da Kross, le skill core ATTACCATE al Guest Agent
via Conduit, un link Stripe di test).

Restituisci una TABELLA integrazione × [stato attuale | cosa manca | prossima
azione]. Poi in coda: la PROSSIMA azione singola più importante per far avanzare
lo studente, e cosa serve eventualmente dallo studente stesso (così posso
avvisarlo). NON attivare, provisionare o modificare nulla in questo giro: è un
monitoraggio in lettura. Non inventare: se una fonte non è leggibile nella
sessione, dillo.

Contesto: in questa sessione di Claude Code potrei NON avere il codice caricato.
Oltre a questo repo mattone-docs, apri anche il repo pertinente all'ARGOMENTO
(es. `~/Projects/mattone-platform`, il gateway `~/Projects/mattone-mcp-gateway`,
`~/Projects/api-kross-mattone`, o `~/Projects/cosmica-booking` per il guest
portal; per il TEMPLATE del sito direct booking non c'e' un percorso locale:
si clona il repository template dopo aver ottenuto l'accesso, vedi
mattone-docs /integrazioni/direct-booking/panoramica).
GUARDRAIL Conduit (non negoziabile): non cambiare MAI stati in massa via API
(resolve/dismiss/close/archive su escalation, gruppi, ticket, contatti,
workflow): il 07/09/2026 un batch di resolve ha spento per sempre il
raggruppamento delle escalation su due workspace, senza comando in UI per
tornare indietro. Prima di qualunque scrittura in massa chiedi alla chat di
supporto AI dentro Conduit cosa dipende da quello stato; lo stato "gestita"
si tiene da noi (Notion/Slack), non in Conduit.
Poi:

Usa i docs in questo repo mattone-docs come FONTE per guidarmi su [ARGOMENTO,
es. "collegare Kross a uno studente" / "il bridge Notion->Conduit" / "il metodo
di troubleshooting"]. Leggi le pagine pertinenti (cita il percorso da cui prendi
ogni regola), dammi i passi nell'ordine corretto con il "cosa prima / cosa dopo",
e se la mia domanda dipende da una condizione (profilo studente, PMS, presenza
smart-lock) elenca le varianti. Non inventare: se una cosa non è nei docs, dillo.

Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri i repo coinvolti, `~/Projects/api-kross-mattone`
(provisioning + skill onboarding), `~/Projects/mattone-platform` (connessioni/
Vault/bridge Notion) e il gateway `~/Projects/mattone-mcp-gateway`, e LEGGI la
pagina mattone-docs /onboarding/panoramica; usa gli MCP (Conduit, Supabase) per
le verifiche reali. Poi procedi:

Fai da guida per l'onboarding di un nuovo studente Mattone, seguendo la
procedura in mattone-docs /onboarding/panoramica. Procedi UN passo alla volta,
in quest'ordine: 1) Anagrafica & Notion, 2) PMS KrossBooking, 3) Conduit
(KB per-listing + custom tool con la loro skill + workflow + telefonia/WABA),
4) Smart check-in (solo se ha smart-lock), 5) Pagamenti Stripe (solo se vende
extra), 6) Verifica finale.

Regole:
- Prima di ogni passo, CHIEDIMI i dati che ti servono e che non hai (es. 3 credenziali
  Kross, workspace/agent Conduit, device smart-lock, chiave Stripe). Non
  inventare valori e non chiedermi segreti in chiaro: dimmi solo dove vanno
  (Vault) senza stamparli.
- Non passare allo step successivo finché quello attuale non è verificato con
  un test reale (es. auth Kross verde, trace di simulate_conversation che usa
  la skill+tool giusti, apertura porta reale, link Stripe di test).
- Rispetta la regola d'oro: ogni custom tool va montato SEMPRE con la sua
  prompting skill, e la KB è per-listing (mai globale).
- A ogni step dimmi: cosa hai fatto, come l'hai verificato (quale log/output),
  e cosa manca. Alla fine, esegui la checklist di /onboarding/6-verifica-finale.

Partiamo: lo studente è [NOME], PMS [Kross/altro], ha smart-lock? [sì/no],
vende extra? [sì/no]. Fammi la prima domanda.

Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri il repo dell'integrazione coinvolta (`~/Projects/api-kross-mattone`
per Conduit/telefonia, il gateway `~/Projects/mattone-mcp-gateway` per Kross/
Shelly/Stripe, `~/Projects/mattone-platform` per bridge Notion/GHL/connessioni,
`~/Projects/cosmica-booking` per il guest portal smart check-in) e LEGGI la
pagina mattone-docs /troubleshooting/metodo più la pagina Troubleshooting
dell'integrazione; usa gli MCP (Conduit, Supabase) per leggere i log veri.
GUARDRAIL Conduit (non negoziabile): non cambiare MAI stati in massa via API
(resolve/dismiss/close/archive su escalation, gruppi, ticket, contatti,
workflow): il 07/09/2026 un batch di resolve ha spento per sempre il
raggruppamento delle escalation su due workspace, senza comando in UI per
tornare indietro. Prima di qualunque scrittura in massa chiedi alla chat di
supporto AI dentro Conduit cosa dipende da quello stato; lo stato "gestita"
si tiene da noi (Notion/Slack), non in Conduit.
Poi procedi:

Applica il metodo di troubleshooting di mattone-docs /troubleshooting/metodo a
questo problema: [DESCRIVI IL SINTOMO, es. "l'agente Conduit dice 'occupato'
per [NOME PROPRIETÀ] dal 20 al 22/09 ma è libera"].

Segui le 5 mosse, in ordine, e mostrami cosa trovi a ciascuna:
1) RIPRODUCI il problema con un caso concreto (property + date + canale).
2) LEGGI I LOG reali (Vercel runtime logs, risposta grezza dell'API col codice
   errore, trace di simulate_conversation, list_calls per la voce). NON
   concludere nulla prima di aver letto un log vero: il log batte l'impressione.
3) ISOLA: è auth o dispositivo? nostro codice o servizio esterno? Usa i codici
   (401 credenziali, 161 device offline, 429 rate limit, error_code 11/16 Kross).
4) VERIFICA L'IPOTESI prima del fix (testa la causa, non imporla).
5) NOTIFICA + DOCUMENTA: proponi il fix che spiega COSA non va E come si
   risolve, e aggiorna la pagina Troubleshooting giusta (con il codice).

Consulta la pagina Troubleshooting dell'integrazione coinvolta in mattone-docs
(Kross, Conduit, Notion, GHL, Shelly, SwitchBot, WABA) per i sintomi già noti.
Non dire "risolto" senza una prova riprodotta.

Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri `~/Projects/mattone-platform` (connessioni/Vault) e, se il
dubbio tocca la config agente, `~/Projects/api-kross-mattone`; poi LEGGI le
pagine mattone-docs /onboarding/panoramica e quella dell'integrazione coinvolta.
Poi procedi:

Ho un dubbio di processo: [ES. "collego prima Kross o prima Conduit?" /
"monto il tool Stripe prima o dopo la chiave nel Vault?"].

Rispondi citando l'ordine corretto dai mattone-docs (/onboarding/panoramica e la
pagina dell'integrazione coinvolta). Spiega COSA va prima e COSA dopo, e
soprattutto PERCHÉ quell'ordine, cioè cosa si romperebbe invertendolo (es.
iniettare i custom tool senza la api_key valida nel Vault rompe l'agente che
già gira; una KB globale invece che per-listing causa leak tra appartamenti).
Se la risposta dipende da una condizione (ha smart-lock? vende extra? PMS
diverso da Kross?), dimmi le varianti. Cita le pagine docs da cui prendi la
regola.

Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri i repo `~/Projects/api-kross-mattone` (provisioning, custom
tool + catalog.json, skill onboarding) e `~/Projects/mattone-platform` (bridge
KB da Notion, connessioni/Vault), e LEGGI le pagine mattone-docs
/onboarding/3-conduit e /integrazioni/conduit/pacchetto-completo; per creare e
testare usa l'MCP Conduit (simulate_conversation). Poi procedi:

Fai il provisioning dell'agente Conduit per lo studente [NOME]. GATE DI
ATTIVAZIONE da verificare PRIMA di tutto: (a) contratto "Servizio AI Ospiti"
FIRMATO (contract_signed = true) E (b) carta a file nella piattaforma (metodo di
pagamento aggiunto, area billing). Se manca anche solo una delle due, FERMATI e
dimmelo: NON provisionare/attivare il workspace, nessuna eccezione. Solo a gate
superato, procedi nell'ordine tassativo: 1) verifica che la terna Kross
(hotel_id+username+password) sia già
nel Vault come cred_secret_id (NON chiedermi le credenziali in chiaro, dimmi
solo se ci sono); 2) genera la KB per-listing dal Notion tramite il bridge (una
cartella per appartamento, entity_id scopati sul listing_id, MAI una KB
globale); 3) monta i custom tool con NOMI CANONICI, OGNUNO con la sua prompting
skill (Kross->kross-reservation-reader, Shelly/SwitchBot->smart-lock-opener,
Stripe->payment-link-generator): tool senza skill = agente che lo ignora; 4)
configura i workflow deterministici. Poi verifica via MCP che le skill core
siano ATTACCATE al Guest Agent (skill_ids != 0) e testa con simulate_conversation
mostrandomi il trace: deve fare load_skill -> tool giusto -> risposta corretta,
non il nativo. Chiedimi workspace_id/agent_id se non li hai.

Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri il repo `~/Projects/mattone-platform` (bridge KB
Notion->Conduit) e LEGGI le pagine mattone-docs /integrazioni/notion/bridge-conduit
e /integrazioni/conduit/kb; usa gli MCP (Notion per i dati veri, Conduit per la
KB risultante). Poi procedi:

(Ri)genera la KB Conduit dello studente [NOME] dal registro appartamenti Notion.
Regole tassative: UNA cartella KB per appartamento, con gli entity_id scopati
sul listing_id corrispondente; MAI una KB globale condivisa tra appartamenti
(causa leak: accessi/listino/regole di un altro immobile). Prima di scrivere,
dimmi: quali righe Notion verranno incluse e quali rischiano di essere scartate
dallo split-by-listing (e perché, es. Name diverso dal listing PMS, campi
mancanti). Dopo il sync, verifica su Conduit che ogni cartella esista e sia
scopata sul listing giusto. Non inventare dati: se un campo manca nel Notion,
segnalamelo invece di riempirlo.

Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri il repo `~/Projects/api-kross-mattone` (custom tool +
catalog.json, nomi canonici) e LEGGI le pagine mattone-docs
/delivery/monitorare-studenti e /integrazioni/conduit/troubleshooting; per lo
stato reale usa l'MCP Conduit. Poi procedi:

Fai un health-check del workspace Conduit dello studente [NOME] e dammi un
verdetto sintetico verde/giallo/rosso. Controlla: 1) le skill core sono
ATTACCATE al Guest Agent (skill_ids != 0), non solo esistenti; 2) i custom tool
hanno i NOMI CANONICI attesi e sono montati (Kross/Shelly/Stripe secondo cosa
usa lo studente); 3) ogni tool ha la sua skill abbinata (tool orfani = ignorati
dall'agente); 4) la KB è per-listing (nessuna cartella globale); 5) i KPI base
(automation rate insieme a operation_mode/autopilot_sent — l'automation rate da solo conta le
proposte, non le risposte inviate, se l'agente è in copilot; escalation, eventuali errori ricorrenti).
Fai un simulate_conversation di prova e mostrami il trace. Elenca in coda SOLO i
problemi trovati, ordinati per gravità, con l'azione di fix per ciascuno.

Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri il repo `~/Projects/api-kross-mattone` (provisioning +
custom tool) e LEGGI le pagine mattone-docs /delivery/problemi-ricorrenti-conduit
e /delivery/token-conduit-coach; per intervenire sui workspace usa l'MCP Conduit
con il token coach (accesso a tutti i workspace studenti). Poi procedi:

Ripara il workspace Conduit dello studente [NOME] (o [workspace_id]). Prima
DIAGNOSTICA leggendo lo stato reale via MCP (non a memoria): skill_ids staccate,
nomi tool non canonici, tool senza skill, KB globale invece che per-listing, KB
non sincronizzata dal Notion. Mostrami la lista dei problemi trovati con la
prova (output MCP) PRIMA di toccare qualcosa. Poi proponi il piano di fix
nell'ordine giusto e, alla mia conferma, applicalo: riattacca le skill core al
Guest Agent, rinomina/riallinea i tool ai nomi canonici, riabbina tool+skill,
rigenera la KB per-listing dal bridge Notion. Alla fine ri-testa con
simulate_conversation e mostrami il trace: deve usare load_skill -> tool giusto.
Non dichiarare "risolto" senza un test riprodotto.

Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri il repo `~/Projects/mattone-platform` (connessioni /
pms_integrations / Vault) e LEGGI le pagine mattone-docs
/onboarding/stato-e-continuazione e /riferimenti/strumenti-team-studenti; per lo
stato reale usa gli MCP (Supabase), e per inviare il messaggio l'MCP
WhatsApp/Slack (o Resend per email) SE è collegato nella tua sessione. Poi procedi:

Per lo studente [NOME], ricostruisci cosa MANCA (incrociando /connessioni,
pms_integrations e Vault) e prepara un messaggio da mandargli, plain, gentile,
chiaro, in italiano, che elenchi SOLO i pezzi mancanti e, per ognuno, l'azione
concreta che deve fare (es. "collega Notion da app.mattone.co -> Connessioni",
"firma il contratto nella tua area", "crea la Restricted Key Stripe e incollala
in Connessioni -> Pagamenti"). NON inviare nulla senza mostrarmi prima la bozza
e chiedermi conferma del canale (WhatsApp / Slack / email) e del destinatario.
Se l'MCP WhatsApp/Slack non è collegato nella mia sessione, dimmelo e rimandami
a /riferimenti/strumenti-team-studenti per installarlo, e intanto dammi il testo
pronto da copiare.

Devo costruire il sito di prenotazione diretta per lo studente [NOME]. Usa
mattone-docs /integrazioni/direct-booking/procedura-guidata come fonte: guidami
fase per fase, fammi le domande una alla volta, non andare avanti finché il
controllo della fase non è verde, e cita la pagina da cui prendi ogni regola.