From 6852c13668f9daa7a12c52e65edb483acb0cc2bb Mon Sep 17 00:00:00 2001
From: Luca Sacchi Ricciardi <luca@lucasacchi.net>
Date: Tue, 7 Apr 2026 10:15:21 +0200
Subject: [PATCH] docs(readme): add OpenCode initialization instructions

Add section explaining how to initialize project with OpenCode:
- Commands to analyze existing codebase
- Instructions to create PRD with spec-architect
- Steps to update agents and skills for the specific project
- Warning about importance of initialization for correct context
---
 README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/README.md b/README.md
index d05835b..d0a91ed 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,54 @@ find . -type f -name "*.md" -exec sed -i 's|\[ROOT_PROGETTO\]|/path/to/mio-proge
 - [ ] Aggiungi funzionalità MVP specifiche
 - [ ] Personalizza stack tecnologico
 
+### 4. Inizializza con OpenCode (IMPORTANTE)
+
+Dopo aver copiato i file template, **devi chiedere ad OpenCode di configurare il progetto** per operare correttamente:
+
+#### Comandi da eseguire con OpenCode:
+
+**1. Analizza la codebase esistente:**
+```
+"@opencode Analizza la codebase di questo progetto e identifica:
+- Tecnologie e framework utilizzati
+- Struttura delle cartelle
+- Pattern architetturali esistenti
+- Convenzioni di codice già in uso"
+```
+
+**2. Crea il PRD (Product Requirements Document):**
+```
+"@spec-architect Crea il file export/prd.md con i requisiti del prodotto.
+Descrivi: [spiega brevemente cosa deve fare il progetto]
+Include: obiettivi, user stories, requisiti funzionali e non funzionali, stack tecnologico"
+```
+
+**3. Attualizza agenti e skill:**
+```
+"@opencode Analizza la cartella .opencode e aggiorna:
+- .opencode/skills/project-guidelines/SKILL.md con le convenzioni specifiche di questo progetto
+- .opencode/agents/spec-architect.md con il path corretto del progetto
+- .opencode/agents/tdd-developer.md con il path corretto e i pattern di test del progetto
+- .opencode/agents/git-manager.md con il path corretto
+- .opencode/WORKFLOW.md con il nome del progetto e gli scope dei commit appropriati"
+```
+
+**4. Crea architettura e task breakdown:**
+```
+"@spec-architect Leggi export/prd.md e crea:
+- export/architecture.md con le scelte architetturali
+- export/kanban.md con il breakdown delle task
+- export/progress.md inizializzato per il tracciamento"
+```
+
+#### ⚠️ Nota Importante
+
+Senza questa inizializzazione, OpenCode **non avrà il contesto corretto** per operare sul progetto. Gli agenti devono essere configurati con:
+- Il path assoluto del progetto (`[ROOT_PROGETTO]`)
+- Le convenzioni specifiche del linguaggio/framework
+- Gli scope dei commit appropriati
+- La struttura delle cartelle del progetto
+
 ---
 
 ## 📁 Struttura del Template