evol-dd 0.6.0

El framework que evoluciona.

Evol-DD

El framework de desarrollo agéntico que aprende con cada proyecto que construye.

Evol-DD elimina los servidores permanentes mediante Model Context Protocol (MCP) y memoria local. Está diseñado para equipos que necesitan agentes que recuerden el contexto entre sesiones, conviertan errores en lecciones arquitectónicas y corran nativamente dentro del IDE sin depender de plataformas cerradas.

---

❖ Por qué Evol-DD

La mayoría de frameworks de IA tienen más de 180 agentes permanentes en disco, dependen de infraestructura compleja y repiten los mismos errores proyecto tras proyecto.

Problema Común	Solución Evol-DD
► Agentes infinitos y pesados	16 Core + Agentes Efímeros bajo demanda.
► Amnesia de sesión a sesión	Memoria Nativa serializada en AGENT_MEMORY.md.
► Mismos errores recurrentes	Motor de Lecciones integrado al flujo CI/CD.
► Cerrado a una plataforma	100% Portable (Cursor, Windsurf, Claude Code, Copilot).

---

❖ Ecosistema Core

1. Memoria Local Persistente

Busca decisiones pasadas y contexto sin tokens adicionales en el LLM.

python3 scripts/evol-memory.py search "decisión arquitectónica sobre la BD"

2. Motor de Lecciones

Automatiza que el agente nunca repita el mismo error técnico.

python3 scripts/evol-lessons.py add --categoria SEGURIDAD --leccion "Gate key aislada por proyecto"

3. Agentes Efímeros Criptográficos

Levanta un especialista para un ticket y retíralo (hash SHA-256) cuando acabe.

python3 scripts/evol-agent-lifecycle.py create --name "auditor-sec" --expires-after 1

---

❖ Instalación y Desinstalación

Requiere Python 3.10+ y pipx.

Instalación Rápida

# 1. Instalación Global (disponible en todos los IDEs vía pipx)
pipx install evol-dd && evol

# 2. Inicializar tu repositorio
evol init . --profile core

Desinstalación

Si deseas retirar Evol-DD de tu sistema y de tus IDEs:

# Elimina el paquete global
pipx uninstall evol-dd

# Eliminar skills e integraciones locales de tus IDEs
rm -rf ~/.claude/commands/evol*
rm -rf ~/.gemini/skills/evol*

(Nota: Tus datos de memoria y lecciones en los repositorios locales no se borran, ya que pertenecen a tu código fuente).

---

❖ Arquitectura del Sistema (Mermaid)

graph TD
    A[IDE / Terminal] --> B[Evol CLI]
    B --> C[Orquestador]
    C --> D[Memoria & Lecciones Local]
    C --> E[Ejecutor GitFlow]
    C --> F[Agentes Efímeros]
    C -.-> G[Model Context Protocol]

---

❖ Documentación y Ecosistema (FAQ)

► Compatibilidad de IDEs

Soporte "Zero-Config" vía comando /evol para:

• Claude Code
• OpenCode
• Cursor
• Windsurf
• Antigravity
• VSCode Copilot (vía Tasks)

► Documentación Completa y Gobernanza

• Constitución Evol-DD
• Manifest de Agentes
• C4 Model
• Índice de Disciplinas

---

❖ Licencia

MIT. Ver el archivo LICENSE para más detalles.