docs: update documentation with MCP configuration and agent catalog

- Add MCP servers documentation (n8n, context7, sequential-thinking)
- Update README.md with complete project structure and requirements.txt
- Transform agents.md into comprehensive agent staff catalog (9 agents)
- Update CHANGELOG.md with [Unreleased] MCP entries
- Fix ingestion_script.md acceptance criteria checkboxes
- Add .opencode/opencode.json to .gitignore for security
- Include new agent configs: n8n_specialist_agent, context_auditor_agent
- Include new skill playbooks: n8n_automation, context7_documentation

Security: API credentials in .opencode/opencode.json are now gitignored
This commit is contained in:
Luca Sacchi Ricciardi
2026-04-02 18:21:21 +02:00
parent 9205c4ef32
commit 3a455e48d2
9 changed files with 405 additions and 67 deletions

View File

@@ -40,6 +40,13 @@ Agentic Dev: OpenCode.ai
Il progetto segue una metodologia **Spec-Driven** e **TDD** (Test-Driven Development).
### Prerequisiti
- **Python** 3.12 o superiore
- **Bash** 4.0+
- **curl** (GNU coreutils)
- **Node.js** 18+ (per i MCP servers)
### Clone e setup
```bash
@@ -52,9 +59,29 @@ python3 -m venv venv
source venv/bin/activate
# Installazione dipendenze
pip install pytest
pip install -r requirements.txt
```
### Configurazione MCP (OpenCode.ai)
Il progetto utilizza tre MCP (Model Context Protocol) servers per estendere le capacità dell'agente AI:
1. **sequential-thinking** - Problem solving strutturato
2. **context7** - Recupero documentazione contestuale delle librerie
3. **n8n** - Integrazione con workflow automation
La configurazione è già presente in `.opencode/opencode.json`. Per utilizzarla:
```bash
# Assicurati di avere npx installato
npm install -g npx
# Avvia OpenCode
opencode
```
**Nota sulla sicurezza:** Le credenziali n8n sono configurate nel file `.opencode/opencode.json`. Non committare mai questo file con credenziali di produzione.
### Eseguire i Test
```bash
@@ -117,7 +144,8 @@ opencode
- `docs/prd.md` - Product Requirements Document
- `docs/specs/` - Specifiche tecniche per ogni sprint
- `docs/reviews/` - Project Review post-sprint
- `docs/sprintN_verification.md` - Report verifica sprint
- `docs/1.setup_procedure/` - Procedure di setup OpenCode.ai
- `docs/sprint1_verification.md` - Report verifica sprint
## 📁 Struttura del Progetto
@@ -127,12 +155,16 @@ LogWhispererAI/
├── CHANGELOG.md # Log modifiche
├── README.md # Questo file
├── LICENSE.md # Licenza proprietaria
├── requirements.txt # Dipendenze Python (pytest, requests)
├── docs/
│ ├── prd.md # Product Requirements Document
│ ├── specs/
│ │ └── ingestion_script.md # Specifica tecnica Sprint 1
│ ├── reviews/
│ │ └── sprint1_review.md # Project Review Sprint 1
│ ├── 1.setup_procedure/ # Setup OpenCode.ai
│ │ ├── setup.md # Procedura setup
│ │ └── agents.md # Configurazione agenti
│ └── sprint1_verification.md # Report verifica
├── scripts/
│ ├── logwhisperer.sh # Script principale
@@ -141,8 +173,22 @@ LogWhispererAI/
│ ├── __init__.py
│ └── test_logwhisperer.py # Test suite Python
└── .opencode/
├── agents/ # Configurazioni agenti
── skills/ # Skills TDD e Git
├── opencode.json # Configurazione MCP servers
── 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
│ ├── n8n_specialist_agent.md
│ └── context_auditor_agent.md
└── skills/ # Playbook condivisi
├── TDD_Python_Specialist/
├── Git_and_Changelog/
├── n8n_automation_mastery/
└── context7_documentation_retrivial/
```
## ⚖️ Licenza e Note Legali
@@ -167,4 +213,3 @@ Per i dettagli completi, consultare il file [LICENSE.md](LICENSE.md).
<p align="center">
<em>LogWhispererAI - "Safety first, little often, double check"</em>
</p>