version: "1.0.0" name: output-conventions description: "Convenzione output-as-file condivisa per tutti i comandi BetterCallClaude Italia. Definisce la struttura cartella bcc-output, naming dei file e template riassunto chat." tools:

• Read
• Grep
• Glob
• Bash
• WebSearch
• WebFetch

Convenzione Output BetterCallClaude Italia

Questo documento definisce il comportamento di output standard per tutti i comandi BetterCallClaude Italia che producono risultati piu lunghi di circa una pagina (~500 parole).

Regola

Ogni comando che produce un output lungo (memoria, ricerca, strategia, analisi, triage, traduzione, bozza) DEVE:

1. Scrivere il risultato completo come file nella cartella di lavoro.
2. Mostrare in chat solo un riassunto di 3-5 righe piu il path al file scritto.

Output brevi (citazione, verifica, raffina, versione, aiuto, privacy, riassumi --breve) possono restare in chat.

Struttura Cartella

<cartella lavoro>/bcc-output/
  YYYY-MM-DD-<slug>/
    01-intake.md
    02-ricerca.md
    03-strategia.md
    04-contraddittorio.md
    05-bozza-<documento>.md   (o .docx per redline)
    fonti.md

• `bcc-output` e il nome cartella predefinito. L'utente puo cambiarlo nel playbook locale (bettercallclaude-italia.local.md) sotto "Stile e formato" -> preferenza cartella output.
• La sottocartella con data-slug usa il formato YYYY-MM-DD-<breve-descrizione> (es. 2026-06-01-triage-nda-rossi).
• La numerazione segue le fasi di /legale-5step. I comandi eseguiti singolarmente scrivono solo i file pertinenti nella stessa struttura.
• `fonti.md` e sempre presente quando sono stati usati server MCP: elenca ogni fonte consultata con data di verifica -- questa e la traccia documentale per la due diligence.

Formati File

• Default: .md (Markdown).
• Redline / documenti per controparte: .docx (tracked changes dove applicabile).
• Su richiesta esplicita: qualsiasi formato.
• Il playbook puo impostare un formato predefinito nella sezione "Stile e formato".

Comportamento per Ambiente

• Cowork: la cartella di lavoro e la cartella condivisa selezionata dall'utente. I file appaiono direttamente nel file browser dell'utente.
• Claude Code: la cartella di lavoro e la root del progetto. Stessa struttura, diverso path base.

Template Riassunto Chat

Quando scrivi un file, mostra in chat:

**[Titolo del risultato]** scritto in `bcc-output/YYYY-MM-DD-slug/filename.md`
 
[Riassunto 3-5 righe dei risultati / conclusioni chiave]
 
Documento completo: `bcc-output/YYYY-MM-DD-slug/filename.md`
Fonti: `bcc-output/YYYY-MM-DD-slug/fonti.md`

Applicabilita

Comandi che producono file output con questa convenzione:

Comandi che restano in chat: citazione, verifica, raffina, riassumi --breve, versione, aiuto, privacy, start, doctor.