# Template format (mcp-mantis-ticket-writer)

Ogni template deve separare in modo esplicito:

1. regole di **formattazione MantisBT**;
2. regole **semantiche** del contenuto.

## Schema minimo

```yaml
name: bug-standard
description: template aziendale definitivo per ticket MantisBT
sections:
  - id: summary
    title: Riassunto
    formatting_rules:
      - formato obbligatorio: **ARGOMENTO** - ***ARGOMENTO2*** - Descrizione
    semantic_rules:
      - ARGOMENTO area funzionale
      - ARGOMENTO2 sotto-contesto
  - id: description
    title: Description
    formatting_rules:
      - descrizione funzionale concreta
    semantic_rules:
      - contesto
      - osservato vs atteso
      - evidenze e dubbi
  - id: steps_to_reproduce
    title: Steps To Reproduce
    formatting_rules:
      - heading consigliato: # Sviluppi con fallback **SVILUPPI**
      - elenco operativo
      - se disponibili evidenze tecniche, aggiungere ## Riferimenti tecnici (fallback **RIFERIMENTI TECNICI**)
      - snippet codice/query usando tripli backtick (es. ```sql ... ```) per specificare il linguaggio
    semantic_rules:
      - soli passaggi verificabili
      - dichiarare incertezza se dati incompleti
      - inserire l'intera analisi tecnica all'interno di questa sezione, non come nota isolata
      - riferimenti tecnici condizionali: path relativo, funzione/metodo, linea solo se certa, tabelle reali se note
      - vietato inventare path/funzioni/linee/tabelle
  - id: additional_information
    title: Additional Information
    formatting_rules:
      - heading consigliato: # Test con fallback **TEST**
      - sezione opzionale condizionale
    semantic_rules:
      - includere solo test richiesti o deducibili
      - omettere se non applicabile
```

## Requisiti obbligatori

- `name` univoco;
- `description` sintetica;
- `sections[]` con almeno tre sezioni obbligatorie:
  - `summary`
  - `description`
  - `steps_to_reproduce`
- `additional_information` opzionale, solo quando applicabile;
- ogni sezione deve includere sia `formatting_rules` sia `semantic_rules`.
- heading markdown consentiti con fallback testuale per compatibilita' Mantis eterogenea.

## Built-in attivo

- Built-in attivo unico: `bug-standard`.
- `bug-compact` e `analysis-ready` sono varianti legacy/documentali, non default attivi.

## Template locali esterni

Per template esterni via path locale:

1. validare presenza campi minimi;
2. se incompleto/ambiguo, dichiarare gap;
3. chiedere chiarimenti oppure fallback a template built-in;
4. tracciare sempre quale template e' stato effettivamente usato.