MdExplorer

Il tuo strumento per lo Spec Driven Development

Scrivi specifiche tecniche che diventano la "single source of truth" del tuo progetto. Versiona con Git, crea diagrammi con PlantUML, esporta in PDF/Word per review e approvazioni.

Versione corrente: 2.1.6Aggiornamento automatico integrato

Perché Spec Driven Development?

Le specifiche guidano lo sviluppo, non il contrario

📝 Scrivi Prima le Specifiche

Documenta cosa deve fare il software PRIMA di scrivere codice. Le specifiche diventano il contratto tra stakeholder e team di sviluppo.

🔄 Versiona Insieme al Codice

Specifiche e codice vivono nello stesso repository Git. Ogni commit, branch e PR include le modifiche alle spec, garantendo sincronizzazione perfetta.

✅ Single Source of Truth

Non più documenti obsoleti in Confluence o Google Docs. Le specifiche sono sempre allineate con il codice in produzione perché fanno parte dello stesso progetto.

Benefici Tangibili

  • ✓ Meno bug: requisiti chiari riducono fraintendimenti
  • ✓ Team allineato: tutti lavorano dalla stessa fonte di verità
  • ✓ Onboarding veloce: nuovi membri leggono le spec per capire il sistema
  • ✓ Review efficaci: stakeholder approvano le spec prima dello sviluppo
  • ✓ Documentazione viva: si aggiorna con ogni feature, non "dopo se c'è tempo"

LLM Wiki: il wiki che si auto-mantiene con l'AI

Il pattern di Andrej Karpathy (2026) per costruire conoscenza che si accumula nel tempo

"MdExplorer è l'IDE; l'LLM è il programmatore; il wiki è il codebase." — adattamento dell'idea di Karpathy (LLM Wiki, Aprile 2026)

Invece di fare retrieval (RAG) su documenti grezzi ad ogni domanda — riscoprendo le stesse cose mille volte — lasci che un agente AI mantenga un wiki strutturato in markdown. Ogni risposta utile diventa una nuova pagina. La conoscenza si accumula invece di evaporare.

📥

Raw Sources

I documenti grezzi (PDF, articoli, transcript). Mai modificati — il curatore umano li raccoglie e li annota.

📚

Wiki

Pagine markdown sintetiche: entità, concetti, sintesi, indice, log. Mantenute dall'LLM, leggibili e versionabili.

📜

Schema

Un singolo CLAUDE.md che governa: come strutturare, come aggiornare, come citare. Il contratto tra umano e LLM.

Perché MdExplorer è il substrato perfetto

Il pattern LLM Wiki può essere implementato con setup multi-app frammentato. MdExplorer integra tutto out-of-the-box in un'unica app cross-platform:

  • ✅ Progetti markdown con cross-link nativo
  • CLAUDE.md supportato out-of-the-box
  • ✅ Git integrato per versionare il wiki
  • ✅ Search semantico locale (no cloud)
  • ✅ PlantUML per diagrammi nelle pagine concept
  • ✅ Embed di Claude Code / Copilot CLI via App Store interno

Come MdExplorer Supporta lo Spec Driven Development

Tutti gli strumenti per scrivere, versionare e condividere specifiche tecniche

📝

Scrivi Specifiche

Editor Markdown professionale con preview in tempo reale. Scrivi requisiti funzionali, casi d'uso e design tecnico in formato leggibile e versionabile.

🔄

Living Documentation

Integrazione Git completa: commit, branch, push. Le specifiche vivono nel repository con il codice, garantendo sincronizzazione perfetta.

📊

Visual Design

PlantUML integrato per diagrammi architetturali, sequence diagram, use case. Visualizza il design direttamente nelle specifiche.

🔗

Traceability

Link interni tra documenti: collega requisiti, design e implementazione. Naviga velocemente tra specifiche correlate.

🗂️

Organizzazione

Gestione progetti con tree view e ricerca full-text. Organizza specifiche per modulo, feature o sprint.

📤

Distribuzione

Export PDF/Word professionale per review, approvazioni e condivisione con stakeholder non tecnici.

👥

Collaborazione

Workflow Git per review delle specifiche: branch, pull request, merge. Il team collabora come sul codice.

💻

Multi-piattaforma

Windows e Linux. Stesso workflow per tutto il team, indipendentemente dal sistema operativo.

Download

Scegli la versione per il tuo sistema operativo

🪟

Windows

Versione 2.1.57

Download per Windows v2.1.57

Installer leggero (3 MB) che scaricherà automaticamente l'applicazione completa

Richiede Windows 10 o superiore

🐧

Linux

Versione 2.1.6

Download AppImage v2.1.6

Ubuntu 20.04+ / Debian 10+ / Fedora 35+

🐳

Docker 🍎 🐧 🪟

Preview 0.1.1

Guida Docker macOS + Linux + Win

Unica via per macOS. Image pubblica su GHCR (~1 GB), avvio in pochi secondi.

Richiede Docker Desktop o Docker Engine

Aggiornamenti automatici: Tutte le versioni includono l'auto-update integrato

🔒 Sicurezza: File firmati digitalmente e con verifica checksum SHA512

Documentazione

🛰️ LLM Wiki di Karpathy

Il pattern emergente per knowledge management con AI agent: tre layer, schema CLAUDE.md, knowledge compounding. Demo funzionante inclusa.

Esplora →

📖 Guida Introduttiva

Primi passi con MdExplorer: installazione, configurazione e primo progetto.

Leggi la guida →

🐳 Docker (macOS / Linux / Windows)

Esegui MdExplorer ovunque tramite container Docker. L'unico modo per usarlo su macOS.

Esplora →

🔄 Workflow SDD

Il ciclo Spec Driven Development con Claude Code: dalle specifiche al codice.

Scopri di più →

🤖 Claude Code Workflow

Usa Claude Code con CLAUDE.md per generare codice allineato alle specifiche.

Esplora →

🔧 Integrazione Git

Usa Git integrato: commit, branch, merge e risoluzione conflitti.

Vai alla guida →

📊 PlantUML & Diagrammi

Crea diagrammi professionali con PlantUML embedded.

Scopri come →

📤 Export PDF/Word

Esporta documenti in formati professionali con template personalizzati.

Leggi la guida →

FAQ

Domande frequenti e soluzioni ai problemi comuni.

Vai alle FAQ →

🚀 Case Study: Errantia

Come il progetto Errantia è stato costruito con MdExplorer + Claude Code + SDD.

Vedi il case study →