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
This commit is contained in:
Luca Sacchi Ricciardi
2026-04-07 10:15:21 +02:00
parent 5c7dd95974
commit 6852c13668

View File

@@ -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