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:
55
README.md
55
README.md
@@ -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>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user