LogWhisperer AI - 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/

2.4 KiB Raw Blame History