Normativa-colombiana-MCP: Instructions file for Claude Code

Instrucciones del proyecto

Criterio al escribir código

Rige para todos los agentes: para mí y para cualquier subagente. Cada punto está aquí porque su ausencia ya costó algo en este repo.

• Borrar el camino viejo, no envolverlo. Cuando el enlace permanente del Consejo de Estado resultó equivalente al postback de WebForms, se sustituyó entero en vez de dejar los dos. Nada de capas de compatibilidad, respaldos ni migraciones para conservar lo que ya no hace falta.
• La implementación más simple que cumpla el requisito de hoy. Se descartó empaquetar el corpus en SQLite con FTS5 —dependencia nativa y un snapshot que envejece— porque el requisito real se cubría consultando en vivo. Sin abstracciones especulativas ni configuración para valores que no cambian.
• Crecer por capas, sin romper lo que ya sirve. Primero cuatro reguladores funcionando de extremo a extremo, después diez encima. Nunca cambiar un producto que funciona por complejidad a medio terminar.
• Un módulo por responsabilidad. Una fuente, un fichero en src/fuentes/. Cuando diez fuentes resultaron tener la misma forma, se les dio un contrato común (src/fuentes/sectorial.ts) en lugar de diez herramientas casi iguales.
• Reutilizar lo que ya está instalado antes de escribir nada. pedir de src/nucleo/http.ts para todo HTTP y cargar de src/nucleo/parse.ts para HTML: traen ritmo por dominio, reintentos, decodificación y cadena de certificados. Un fetch directo se salta las cuatro cosas. Comprobar la documentación y los tipos de una dependencia antes de dar por hecho que le falta algo.
• Decidir para el largo plazo. El contrato Adaptador se escribió antes que los adaptadores, y por eso diez subagentes en paralelo produjeron piezas que encajan. Un apaño pensado para reemplazarse después se queda para siempre.
• Cuando el atajo es deliberado, se marca. Comentario ponytail: diciendo cuál es el techo y cuál sería el salto siguiente.

Command Code como subagente