# MantisBT Syntax & Formatting Guide

Questa skill supporta due profili di formattazione. Scegli il profilo in base al template risolto:

- `bug-standard`: profilo moderno con plugin avanzato disponibile.
- `legacy-markdown`: profilo legacy senza dipendenze da plugin avanzato.

## 1. Regole condivise minime

- **Intestazioni**: usare Markdown standard (`#`, `##`, `###`).
- **Composizione base**: liste puntate (`- `, `* `), liste numerate (`1. `), grassetto (`**bold**`), corsivo (`*italic*`).
- **Fallback testuali**: mantenere fallback in grassetto sotto heading operativi critici (es. `## Riferimenti tecnici` + `**RIFERIMENTI TECNICI**`) per installazioni Mantis eterogenee.

## 2. Profilo `bug-standard` (plugin avanzato disponibile)

Quando il template risolto e' `bug-standard`:

- gli snippet `code/query` nel ticket finale devono usare tripli backtick;
- quando utile, specificare la lingua (`php`, `sql`, `cfml`, `js`);
- mantenere output copy-paste ready e compatibile anche su installazioni Mantis eterogenee.

Feature plugin avanzate (backtick con lingua, `diff-<lingua>`) sono informative/capability-aware:

- i backtick sono il default del formato finale del ticket `bug-standard`;
- usarle solo in contesti non in conflitto con il template selezionato.

## 3. Profilo `legacy-markdown` (senza plugin avanzato)

Quando il template risolto e' `legacy-markdown`:

- non richiedere funzionalita' plugin (syntax highlight, line numbers automatici, `diff-<lingua>`);
- usare snippet `code/query` solo in `<pre>...</pre>`;
- evitare assunzioni di rendering avanzato lato Mantis.

Esempio legacy:

````text
<pre>
SELECT id_cliente, codice_fiscale
FROM anag_clienti
WHERE codice_fiscale IS NULL OR codice_fiscale = '';
</pre>
````

## 4. Formattazione contenuti analitici (`mcp-technical-analyst`)

Quando integri output da `mcp-technical-analyst`:

1. Preserva struttura Markdown (liste, citazioni, tabelle) compatibile con MantisBT.
2. Se template `bug-standard`, converti o mantieni gli snippet nel formato finale in tripli backtick (lingua opzionale ma consigliata).
3. Se template `legacy-markdown`, converti snippet in `<pre>...</pre>` ed evita estensioni plugin.