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)
1.4 KiB
1.4 KiB
Architecture Decision Records
Registro delle decisioni architetturali e dei pattern di design utilizzati.
Formato
## [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