# LogWhispererAI - Agent Rules

Regole operative per gli agenti AI che collaborano su questo progetto.

---

## Metodologia di Lavoro

### Spec-Driven
Prima di ogni modifica, l'agente deve aggiornare o confermare le specifiche in `docs/specs/`.

### TDD (Test-Driven Development)
Non scrivere logica senza un test fallimentare preventivo. Usa pytest.

### Sacchi Method
Applica sempre "**Safety first, little often, double check**". Verifica i permessi prima di eseguire comandi bash distruttivi.

### Git Workflow
- **Conventional Commits**: usa `feat:`, `fix:`, `docs:`, `test:`, `refactor:`, `chore:`
- **Atomic Commits**: un commit per singola modifica funzionale
- **Changelog**: aggiorna `CHANGELOG.md` seguendo lo standard Common Changelog

---

## Staff di Agenti

Configurazioni dettagliate in `.opencode/agents/`:

| Agente | Ruolo | Focus |
|--------|-------|-------|
| `@tech-lead` | L'Architetto | Validazione specifiche, architettura |
| `@product-manager` | Il Garante del Valore | PRD, roadmap, priorità |
| `@python-developer` | Il Costruttore TDD | Implementazione Python (PEP8) |
| `@bash-expert` | Lo Specialista Ingestion | Script Bash (low footprint) |
| `@security-auditor` | Il Guardiano | Vulnerabilità, protezione dati |
| `@qa-engineer` | Il Tester | Test suite, copertura, regressioni |
| `@documentation-agent` | Il Cronista | Changelog, docs, commit messages |

---

## Workflow Operativo

```
1. @product-manager → definisce obiettivo
2. @tech-lead → scrive/valida specifica in docs/specs/
3. @qa-engineer → scrive test (RED phase)
4. @python-developer / @bash-expert → implementa (GREEN phase)
5. @security-auditor → valida sicurezza
6. @documentation-agent → aggiorna changelog e commit
```

---

## Struttura Configurazione

```
.opencode/
├── agents/              # Configurazioni agenti individuali
│   ├── tech-lead.md
│   ├── product-manager.md
│   ├── python-developer.md
│   ├── bash-expert.md
│   ├── security-auditor.md
│   ├── qa-engineer.md
│   └── documentation-agent.md
└── skills/              # Playbook condivisi
    ├── TDD_Python_Specialist/
    └── Git_and_Changelog/
```

---

## Skills Disponibili

Skills condivise in `.opencode/skills/`:

- **TDD_Python_Specialist/**: Workflow TDD (RED → GREEN → REFACTOR)
- **Git_and_Changelog/**: Conventional commits, Common Changelog

---

*Per configurazioni dettagliate, vedere i file in `.opencode/agents/`*