- 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.
2.4 KiB
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.mdseguendo 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/