Doc Harness: Una Habilidad de Código de Claude para Mantener el Estado del Proyecto Entre Sesiones

Doc Harness es una habilidad de Claude Code diseñada para resolver el problema de que los agentes de IA pierdan el seguimiento del estado del proyecto durante sesiones de trabajo prolongadas. Crea un sistema de documentación ligero dentro de tu carpeta de proyecto que cualquier agente puede leer para comprender el estado del proyecto, seguir las reglas establecidas y continuar el trabajo sin problemas.

Qué Resuelve

La herramienta aborda problemas comunes al usar Claude Code en proyectos que abarcan múltiples sesiones: reinicios de contexto donde los agentes olvidan el trabajo reciente, dificultad para navegar proyectos con 30+ archivos, olvido gradual de reglas establecidas (como "siempre probar antes de confirmar") y la necesidad de pasar 20+ minutos reexplicando proyectos a nuevos agentes.

Cómo Funciona

Doc Harness mantiene cinco archivos estructurados en tu carpeta de proyecto. El archivo clave es CURRENT_STATUS.md, que utiliza una estructura de "coche en movimiento":

• Historial reciente (por dónde has estado)
• Detalle del trabajo actual (dónde estás)
• Próximos pasos (hacia dónde vas)
• Principios de trabajo (cómo conducir)

Cuando termina una fase de trabajo, los detalles se archivan permanentemente y el estado se borra para la siguiente fase.

Comandos

La habilidad proporciona dos comandos principales:

• /doc-harness init - Crea cinco documentos adaptados a tu proyecto
• /doc-harness check - Audita la salud de la documentación (verifica si los archivos están registrados y el estado está actualizado) y lee las reglas del proyecto al agente, provocando una reflexión sobre si se están siguiendo las reglas

Principio Fundamental

La herramienta opera bajo el principio "Escríbelo o piérdelo", reconociendo que el contexto de IA es temporal mientras que los archivos son permanentes. Cada resultado, decisión o insight importante debe guardarse en un archivo y registrarse en el índice.

Instalación

git clone https://github.com/cilidinezy-commits/doc-harness.git
cp -r doc-harness/skill ~/.claude/skills/doc-harness

Después de la instalación, puedes decirle a tu agente "configurar la documentación del proyecto" sin necesidad de comandos de barra si prefieres lenguaje natural.

Compatibilidad

Funciona para cualquier tipo de proyecto, incluidos artículos de investigación, funciones SaaS, análisis de datos, artículos, bibliotecas de software y cualquier cosa que abarque múltiples sesiones. Se incluyen versiones en inglés y chino, y la herramienta se publica bajo licencia MIT.