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)
93 lines
1.2 KiB
Markdown
93 lines
1.2 KiB
Markdown
# Architecture Document (Export)
|
|
|
|
> Decisioni architetturali e diagrammi di flusso.
|
|
|
|
## Istruzioni
|
|
|
|
Questo file deve essere creato/aggiornato dall'agente `@spec-architect` durante la fase di analisi.
|
|
|
|
## Contenuto Richiesto
|
|
|
|
1. **Scelte Architetturali**
|
|
- Pattern architetturali
|
|
- Motivazioni
|
|
- Trade-off
|
|
|
|
2. **Stack Tecnologico**
|
|
- Tecnologie e versioni
|
|
- Motivazioni scelta
|
|
|
|
3. **Diagrammi di Flusso**
|
|
- Architettura sistema
|
|
- Flussi dati
|
|
- Sequenze operazioni
|
|
|
|
4. **Interfacce e Contratti**
|
|
- API contracts
|
|
- Interfacce tra componenti
|
|
|
|
---
|
|
|
|
## Template
|
|
|
|
```markdown
|
|
# Architecture - [Nome Progetto/Feature]
|
|
|
|
## 1. Overview
|
|
|
|
[Descrizione ad alto livello]
|
|
|
|
## 2. System Architecture
|
|
|
|
```
|
|
[ASCII art o riferimento a diagramma]
|
|
```
|
|
|
|
## 3. Componenti
|
|
|
|
### 3.1 [Nome Componente]
|
|
**Responsabilità:**
|
|
-
|
|
|
|
**Interfacce:**
|
|
- Input:
|
|
- Output:
|
|
|
|
**Dipendenze:**
|
|
-
|
|
|
|
## 4. Data Flow
|
|
|
|
```
|
|
[Descrizione flusso dati]
|
|
```
|
|
|
|
## 5. API Contracts
|
|
|
|
### [Endpoint]
|
|
```
|
|
POST /api/v1/...
|
|
Request:
|
|
body: { ... }
|
|
|
|
Response:
|
|
200: { ... }
|
|
400: { ... }
|
|
```
|
|
|
|
## 6. Decisioni
|
|
|
|
### [DEC-001] - [Titolo]
|
|
**Decisione:**
|
|
|
|
**Motivazione:**
|
|
|
|
**Alternative:**
|
|
|
|
**Conseguenze:**
|
|
```
|
|
|
|
---
|
|
|
|
*Questo file verrà popolato durante la fase di specifica*
|