Prompts

# Prompts

## Perche esiste questa cartella

I prompt sono contratti operativi agent-safe. Ogni prompt principale `00-06` usa la stessa struttura verificabile.

Il prompt non e la richiesta: e il contratto operativo.

## Struttura standard (Prompt Contract)

Ogni prompt principale include sempre:

1. `Purpose`
2. `When to use`
3. `Required context`
4. `Role`
5. `Task`
6. `Inputs`
7. `Output contract`
8. `Quality bar`
9. `Anti-drift rules`
10. `Stop conditions`
11. `Self-check`
12. `Human review checklist`
13. `Next step`

## Relazione con playground

Il playground ti da il primo risultato rapido. I prompt `00-06` trasformano quel risultato in processo controllato.

## Relazione con exercises

Gli esercizi richiedono uso disciplinato dei prompt e aggiornamento tracker.

Prima di usare la sequenza completa `00-06`, e consigliato completare la First Mission:

- `documentation/first-mission/README.md`
- `documentation/first-mission/first-mission-dossier-template.md`

## Come usare i prompt

1. leggi `README.md` e il contesto del repository
2. leggi `AGENTS.md` per guardrail e confini
3. leggi le skills in `.agents/skills/`
4. scegli il prompt della fase corrente
5. copia il prompt e incollalo nell'agente
6. verifica l'output rispetto a checklist e confini
7. passa al prompt successivo solo quando il risultato e chiaro

## Quando usare i prompt principali 00-06

| Prompt | Quando usarlo | Cosa produce | Input consigliati | Output atteso |
|---|---|---|---|---|
| `00-agent-onboarding.md` | Avvio sessione | allineamento operativo | source-of-truth + richiesta | scope, confini, rischi, piano, stop conditions |
| `01-requirement-analysis.md` | Analisi richiesta | requirement chiarito | richiesta raw + vincoli | objective, scope, rischi, acceptance criteria |
| `02-architecture-planning.md` | Prima dei task | blueprint didattico | output 01 + boundary | confini, componenti, trade-off, quality risks |
| `03-task-breakdown.md` | Prima del codice | task plan incrementale | output 01-02 | task, dipendenze, DoD, gate, rischio drift |
| `04-implementation-start.md` | Task in corso | implementazione scoped | task + file target | cambi, file toccati, trade-off, gate |
| `05-quality-gate.md` | Fine iterazione | validazione completa | diff + stato repo | lint/build/typecheck/check:structure/quality |
| `06-documentation-alignment.md` | Chiusura ciclo | riallineamento docs | output 05 + docs | update coerenti, gap residui, boundary check |

## Sequenza consigliata

Onboarding -> Requirement Analysis -> Architecture Planning -> Task Breakdown -> Implementation -> Quality Gate -> Documentation Alignment

Collegamento consigliato:

`First Mission` -> Prompt `00 -> 06` -> Exercises/Workflow.

## Quando usare workflow-maintenance

Usa `prompts/workflow-maintenance/` quando il task riguarda:

- generazione capitoli workflow
- generazione backlog da requirement
- aggiornamento tracker
- review consistenza requirement/workflow/documentazione

## Prompt standard di avvio