Files
LogWhispererAI/AGENTS.md
Luca Sacchi Ricciardi 92217897ca fix: standardize project name to LogWhispererAI (no space)
- Replace all occurrences of 'LogWhisperer AI' with 'LogWhispererAI'
- Fix 47 instances across 30 files including:
  - Documentation (README, PRD, specs, docs)
  - Frontend components (Footer, Navbar, Hero, etc.)
  - Backend files (Dockerfile, server.js)
  - Workflow files (n8n, bash scripts)
  - Configuration files (AGENTS.md, LICENSE)

Ensures consistent branding across the entire codebase.
2026-04-03 17:07:35 +02:00

2.4 KiB

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/