template-opencode/prompt/prompt-zero.md

Prompt Zero: [NOME_PROGETTO] - Project Kickoff

🎯 Missione

Sviluppare [NOME_PROGETTO], [descrizione breve del progetto - da personalizzare].

Repository: [ROOT_PROGETTO]
PRD: [ROOT_PROGETTO]/export/prd.md

---

📊 Stato Attuale

• ✅ PRD Completo: Requisiti funzionali e non funzionali definiti
• ✅ Team Configurato: Agenti specializzati pronti
• ❌ Nessun Codice: Progetto da zero
• ❌ Nessuna Specifica Tecnica: Da creare

---

👥 Team di Sviluppo

Agente	Ruolo	File Config
@spec-architect	Definisce specifiche e architettura	.opencode/agents/spec-architect.md
@tdd-developer	Implementazione TDD	.opencode/agents/tdd-developer.md
@git-manager	Gestione commit Git	.opencode/agents/git-manager.md

---

🔄 Workflow Obbligatorio

┌─────────────────────────────────────────────────────────────┐
│  FASE 1: SPECIFICA                                          │
│  @spec-architect                                            │
│  └── Legge PRD → Crea architecture.md, kanban.md           │
│                                                             │
│  ↓                                                          │
│                                                             │
│  FASE 2: IMPLEMENTAZIONE                                    │
│  @tdd-developer                                             │
│  └── RED → GREEN → REFACTOR per ogni task                  │
│                                                             │
│  ↓                                                          │
│                                                             │
│  FASE 3: COMMIT                                             │
│  @git-manager                                               │
│  └── Commit atomico + Conventional Commits                 │
└─────────────────────────────────────────────────────────────┘

---

🚀 Task Iniziale: Fase 1 - Specifica

AGENTE: @spec-architect

OBIETTIVO: Analizzare il PRD e creare le specifiche tecniche dettagliate.

Azioni Richieste

1. Leggere [ROOT_PROGETTO]/export/prd.md

2. Creare la struttura di output:

   [ROOT_PROGETTO]/export/
   ├── prd.md              # Requisiti prodotti (estratto/dettaglio)
   ├── architecture.md     # Architettura sistema
   ├── kanban.md           # Task breakdown
   └── progress.md         # Tracciamento progresso
   

3. Produrre architecture.md con:

   • Stack tecnologico dettagliato
   • Struttura cartelle progetto
   • Diagrammi flusso dati
   • Schema database completo (DDL)
   • Interfacce API (OpenAPI specs)
   • Sicurezza (cifratura, autenticazione)

4. Produrre kanban.md con:

   • Task breakdown per Fase 1 (MVP)
   • Stima complessità
   • Dipendenze tra task
   • Regola "little often": task < 2 ore

5. Inizializzare progress.md con:

   • Feature corrente: "Fase 1 - MVP"
   • Stato: "🔴 Pianificazione"
   • Percentuale: 0%

Criteri di Accettazione

• Architecture.md completo con tutte le sezioni
• Kanban.md con task pronti per @tdd-developer
• Progress.md inizializzato
• Tutti i path usano [ROOT_PROGETTO]/

---

📋 Requisiti Chiave (Dal PRD)

Funzionalità MVP (Fase 1)

[DA PERSONALIZZARE - Inserire le funzionalità principali del progetto]

1. [Feature 1]

   • [Dettaglio 1]
   • [Dettaglio 2]

2. [Feature 2]

   • [Dettaglio 1]
   • [Dettaglio 2]

Stack Tecnologico (Esempio)

• Backend: [Linguaggio/Framework]
• Database: [Tipo database]
• Frontend: [Tecnologia frontend]
• Auth: [Metodo autenticazione]
• Task Background: [Scheduler]

---

🛡️ Vincoli e Best Practices

Sicurezza (Critico)

• [Requisito sicurezza 1]
• [Requisito sicurezza 2]
• SQL injection prevention
• XSS prevention
• CSRF protection
• Rate limiting

Qualità

• Test coverage ≥ 90%
• TDD obbligatorio
• Conventional commits
• Commit atomici

Organizzazione

• Task "little often" (< 2 ore)
• Documentazione in /export/
• Bug complessi in /docs/bug_ledger.md

---

📁 Struttura Progetto Attesa

[ROOT_PROGETTO]/
├── prd.md                      # Product Requirements
├── prompt/
│   └── prompt-zero.md         # Questo file
├── .opencode/
│   ├── agents/                # Configurazioni agenti
│   └── skills/                # Skill condivise
├── export/                    # Output spec-driven (da creare)
│   ├── prd.md
│   ├── architecture.md
│   ├── kanban.md
│   └── progress.md
├── docs/                      # Documentazione (da creare)
│   ├── bug_ledger.md
│   └── architecture.md
├── src/                       # Codice sorgente (da creare)
│   └── [nome_package]/
│       ├── __init__.py
│       ├── main.py
│       ├── config.py
│       └── ...
├── tests/                     # Test suite (da creare)
│   ├── unit/
│   ├── integration/
│   └── conftest.py
├── requirements.txt / package.json
└── README.md

---

✅ Checklist Pre-Sviluppo

• @spec-architect ha letto questo prompt
• Cartella export/ creata
• architecture.md creato con schema DB
• kanban.md creato con task Fase 1
• progress.md inizializzato

---

🎬 Prossima Azione

@spec-architect: Inizia analizzando il PRD in export/prd.md e crea le specifiche tecniche in export/.

NON iniziare l'implementazione finché le specifiche non sono approvate.

---

📞 Note per il Team

• Domande sul PRD? Leggi prima export/prd.md completamente
• Ambiguità? Chiedi prima di procedere
• Vincoli tecnici? Documentali in architecture.md
• Task troppo grandi? Spezza in task più piccoli

---

Data Creazione: YYYY-MM-DD
Versione: 1.0
Stato: Pronto per kickoff

---

📝 Note per l'Utente

Questo è un template. Per usarlo:

1. Sostituisci [NOME_PROGETTO] con il nome reale
2. Descrivi il progetto nella sezione Missione
3. Personalizza la sezione "Requisiti Chiave" con i tuoi requisiti
4. Aggiorna lo stack tecnologico
5. Definisci gli scope dei commit pertinenti al tuo progetto