Files
template-opencode/docs/bug_ledger.md
Luca Sacchi Ricciardi 5c7dd95974 feat(template): add complete OpenCode project template with placeholder paths
- 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)
2026-04-07 10:12:41 +02:00

881 B

Bug Ledger

Registro dei bug complessi risolti con sintomo, causa, soluzione e prevenzione.

Formato

## YYYY-MM-DD: [Titolo Bug]
**Sintomo:** [Descrizione sintomo]
**Causa:** [Root cause]
**Soluzione:** [Fix applicato]
**Prevenzione:** [Come evitare in futuro]

Esempio Template

2026-04-05: Race condition in webhook dispatch

Sintomo: Webhook duplicati inviati sotto carico elevato

Causa: Manca meccanismo di lock nel dispatcher, richieste concorrenti causano doppia delivery

Soluzione:

  • Aggiunto asyncio.Lock() nel dispatcher
  • Sequentializza invio webhook per lo stesso evento

Prevenzione:

  • Test di carico obbligatori per componenti async
  • Code review focus su race condition
  • Documentare comportamento thread-safe nei docstring

Aggiungere nuovi bug in ordine cronologico decrescente (più recente in cima)