Documentación y ADRs para proyectos con agentes IA
Guía estructurada para registrar decisiones arquitectónicas (ADRs), comentarios de código, documentación de APIs y READMEs, poniendo el foco en documentar el 'por qué' no el 'qué'. Incluye plantillas, ciclo de vida de ADRs y checklists de verificación adaptados para equipos que trabajan con agentes IA.
Incluida en el Pase · para cualquier-proyecto-software, Claude, GitHub
// qué_hace
Proporciona un sistema completo de plantillas y criterios para documentar decisiones arquitectónicas (ADRs), APIs, READMEs y changelogs en proyectos de software.
// cómo_lo_hace
Mediante plantillas ADR con estructura Contexto/Decisión/Alternativas/Consecuencias, guías de comentarios inline y checklists de verificación orientados a que tanto humanos como agentes IA entiendan el razonamiento detrás del código.
// ejemplo_de_uso
Úsala para dejar documentado por qué se tomó una decisión técnica importante, de modo que el equipo (y los agentes IA) la entiendan meses después. Ej.: redactar un ADR explicando por qué se eligió PostgreSQL frente a MongoDB para el modelo de datos del producto.
// plataformas
// opiniones_de_la_comunidad
Opiniones
Cargando opiniones…