Milepost: memoria persistente en Markdown para Claude Code

Claude Code, el agente de codificación de Anthropic que trabaja directamente en tu terminal, tiene un talón de Aquiles conocido: olvida el contexto entre sesiones. Cada vez que cierras la ventana, el conocimiento acumulado sobre la arquitectura de tu proyecto, tus decisiones de diseño y tus preferencias se pierde. Milepost, una herramienta open source publicada en GitHub por el desarrollador Sasha Mitrovich, ataca ese problema con la solución más simple posible: memoria de largo plazo en Markdown plano, sin bases de datos vectoriales, sin servicios en la nube y sin dependencias pesadas.

El dato que llama la atención es su radical minimalismo: cero infraestructura. Mientras la industria empuja soluciones de memoria basadas en embeddings y bases de datos vectoriales que cuestan dinero y añaden latencia, Milepost apuesta por archivos .md legibles por humanos que puedes versionar con Git. En este artículo analizamos qué resuelve, cómo encaja en el flujo diario de un builder hispanohablante y cuándo tiene sentido adoptarlo frente a alternativas.

¿Qué es Milepost y qué problema resuelve?

Milepost ("mojón" o "hito kilométrico" en inglés) es un sistema de memoria de largo plazo para Claude Code que almacena el contexto del proyecto en archivos Markdown planos. La premisa es directa: en lugar de depender de una capa de memoria propietaria o de re-explicarle a Claude tu proyecto en cada sesión, Milepost mantiene un registro persistente y editable a mano.

Según la descripción del proyecto en GitHub, el enfoque es "plain-Markdown long-term memory for Claude Code" — memoria de largo plazo en Markdown puro. Esto significa tres ventajas concretas:

• Transparencia total: puedes leer y editar la memoria de tu agente en cualquier editor de texto. Nada de cajas negras.
• Versionado con Git: al ser texto plano, cada cambio en la memoria queda registrado en tu historial de commits.
• Cero coste de infraestructura: no hay base de datos vectorial ni endpoint que pagar o mantener.

Conviene ser honestos con el matiz: en el momento de escribir esto, el proyecto es muy nuevo y con adopción incipiente en Hacker News (apenas 1 punto y sin comentarios). No es una herramienta consolidada, sino una propuesta temprana que refleja una tendencia de fondo real.

Desde nuestra experiencia con Claude Code, el problema que ataca Milepost es genuino: el CLAUDE.md nativo ayuda, pero gestionar contexto acumulado de forma estructurada sigue siendo un dolor real en proyectos largos.

¿Qué significa para los builders?

La memoria persistente de agentes es uno de los cuellos de botella más citados por quienes construyen con LLMs en producción. Un agente que no recuerda decisiones previas obliga a re-inyectar contexto, lo que consume tokens y dinero. Con precios de Claude en el rango de $3 por millón de tokens de entrada para modelos como Sonnet, re-explicar el contexto de un proyecto grande en cada sesión se paga en la factura.

Milepost encaja en el flujo de trabajo de forma no intrusiva. Un uso típico:

# La estructura de memoria vive en tu repo
/project
  /.milepost
    architecture.md
    decisions.md
    conventions.md

Comparado con alternativas: las soluciones basadas en RAG (Retrieval-Augmented Generation, recuperación aumentada por búsqueda) con bases vectoriales como Pinecone o Chroma ofrecen búsqueda semántica potente, pero añaden complejidad operativa y coste. Milepost sacrifica esa sofisticación a cambio de simplicidad y control. Frente al CLAUDE.md nativo de Claude Code, Milepost propone una estructura más deliberada y organizada por dominios.

Para los builders hispanohablantes esto significa algo importante: es una herramienta que puedes auditar, adaptar y traducir sin fricción. Al ser Markdown plano, puedes escribir tu memoria de proyecto en español sin preocuparte por cómo un sistema de embeddings maneja el idioma — un problema real cuando trabajas en mercados donde la documentación mezcla inglés técnico y español.

¿Está disponible en España y LATAM?

Al ser un proyecto open source alojado en GitHub, Milepost está disponible sin restricciones geográficas para cualquier developer en España, Colombia, México, Argentina o Chile. No hay licencias de pago ni bloqueos regionales.

El coste indirecto está en el uso de Claude Code, que requiere una suscripción a los planes de Anthropic (Pro o Max) o acceso vía API. En euros, el plan Pro de Claude ronda los 18-20 € al mes según la región y el tipo de cambio, mientras que el consumo por API se factura por tokens. Milepost, al reducir la re-inyección de contexto, puede ayudar a contener ese gasto — un factor relevante para startups y freelancers hispanohablantes que trabajan con presupuestos ajustados.

En cuanto a regulación, al ser archivos locales bajo tu control, Milepost es compatible con requisitos de soberanía de datos: nada sale de tu máquina hacia un tercero salvo lo que ya envías a la API de Anthropic. Para equipos en España sujetos al RGPD, mantener la memoria del proyecto en texto plano versionado facilita la trazabilidad.

¿Qué hace un builder en Bogotá o Madrid con esto hoy? Clonarlo, probarlo en un proyecto real de dos semanas y evaluar si reduce el tiempo de "recontextualización" al retomar el trabajo cada mañana.

¿Cómo empezar con Milepost?

Los pasos accionables, dado que es un proyecto joven:

• 1. Visita el repositorio en github.com/sashamitrovich/milepost y revisa el README para los requisitos actuales.
• 2. Ten Claude Code ya instalado y funcionando en tu terminal.
• 3. Integra la estructura de carpetas de memoria en tu proyecto y comienza a documentar decisiones a medida que avanzas.
• 4. Versiona los archivos de memoria con Git para tener historial.

Recomendación práctica: empieza documentando solo las decisiones arquitectónicas clave, no todo. La memoria útil es curada, no exhaustiva. Un archivo decisions.md con 10 entradas bien escritas vale más que 200 notas automáticas sin filtrar.

Conclusión

Milepost no es todavía una herramienta madura, pero encarna una idea potente: la memoria de agentes no siempre necesita infraestructura compleja. Para muchos proyectos, Markdown plano versionado con Git es suficiente y gana en transparencia, coste y control. Nuestra lectura original: en 2026 veremos una divergencia clara entre soluciones de memoria "pesadas" (vectoriales, para casos con miles de documentos) y "ligeras" como Milepost (para el conocimiento estructurado de un proyecto). Para el builder hispanohablante que valora auditar lo que su agente recuerda, la memoria en Markdown para Claude Code es una apuesta que merece una prueba de dos semanas. Comparte este artículo si te fue útil.