5c7dd95974
- Replace hardcoded project paths with generic placeholders ([NOME_PROGETTO], [ROOT_PROGETTO]) - Add .opencode/ configuration with agent definitions (spec-architect, tdd-developer, git-manager, security-reviewer) - Add export/ templates (prd, architecture, kanban, progress, githistory) - Add docs/ templates (bug_ledger, architecture) - Add prompt/prompt-zero.md kickoff template - Update README.md with installation instructions and usage guide Template now ready for reuse in new projects with workflow: 1. Spec-Driven (@spec-architect) 2. TDD (@tdd-developer) 3. Git management (@git-manager)
60 lines
1.4 KiB
Markdown
60 lines
1.4 KiB
Markdown
# Architecture Decision Records
|
|
|
|
> Registro delle decisioni architetturali e dei pattern di design utilizzati.
|
|
|
|
## Formato
|
|
|
|
```markdown
|
|
## [YYYY-MM-DD] - [Titolo Decisione]
|
|
|
|
### Contesto
|
|
[Background e motivazione]
|
|
|
|
### Decisione
|
|
[Cosa è stato deciso]
|
|
|
|
### Conseguenze
|
|
- Positivo: [Benefici]
|
|
- Negativo: [Trade-off]
|
|
|
|
### Alternative Considerate
|
|
- [Alternativa 1]: [Perché scartata]
|
|
- [Alternativa 2]: [Perché scartata]
|
|
```
|
|
|
|
---
|
|
|
|
## Esempio Template
|
|
|
|
## 2026-04-05 - Uso di FastAPI come framework API
|
|
|
|
### Contesto
|
|
Necessità di un framework web async per l'API REST con documentazione OpenAPI automatica.
|
|
|
|
### Decisione
|
|
Adottare FastAPI come framework principale per:
|
|
- Supporto nativo async/await
|
|
- Validazione automatica con Pydantic
|
|
- Documentazione OpenAPI/Swagger integrata
|
|
- Performance elevate
|
|
|
|
### Conseguenze
|
|
- **Positivo:**
|
|
- Sviluppo più rapido con type hints
|
|
- Documentazione API sempre aggiornata
|
|
- Validazione input automatica
|
|
- Supporto nativo async per I/O bound operations
|
|
|
|
- **Negativo:**
|
|
- Curva di apprendimento per sviluppatori nuovi
|
|
- Dipendenza da Pydantic v2
|
|
|
|
### Alternative Considerate
|
|
- **Flask**: Scartato per mancanza di supporto async nativo
|
|
- **Django REST Framework**: Scartato per essere troppo pesante per API-only
|
|
- **Starlette**: Scartato in favore di FastAPI che include più funzionalità out-of-box
|
|
|
|
---
|
|
|
|
*Aggiungere nuove decisioni in ordine cronologico crescente*
|