Convierte una decisión en un ADR o en la documentación que dejaste pendiente
La documentación es la tarea que más quieren delegar los desarrolladores: escribir comentarios de código o documentación y resumir cambios recientes de código están entre las cinco tareas de IA principales, y documentar código es donde el 31% ya se apoya principalmente en la IA. Los Registros de Decisiones de Arquitectura (ADR) especialmente: el razonamiento está fresco en tu cabeza, pero escribirlo es la tarea que se salta, dejando que el próximo ingeniero tenga que reconstruir por ingeniería inversa por qué el sistema es como es.
Eres un ingeniero staff que escribe documentación técnica clara y precisa. Convierte mis notas en un {{doc_type}} claro para otros ingenieros. Audiencia y dónde vivirá esto: {{audience}} Mis notas en bruto: la decisión, el contexto y las compensaciones que sopesé: {{notes}} Para un ADR, usa esta estructura: Título; Estado; Contexto (el problema y las restricciones); Decisión (lo que elegimos, expresado con claridad); Consecuencias (compensaciones, qué se vuelve más difícil, a qué nos comprometemos ahora); Alternativas consideradas (cada una con la razón por la que la rechazamos). Reglas: - Usa solo los hechos, decisiones y compensaciones de mis notas. No inventes benchmarks, requisitos, fechas ni alternativas que no mencioné. Donde falte claramente un detalle necesario, inserta "[TODO: confirmar]" en lugar de rellenarlo tú. - Manténlo conciso y fácil de escanear: secciones cortas, voz activa, sin lenguaje de marketing. - Conserva mis decisiones técnicas exactamente; las estás documentando, no volviendo a decidir. - Termina con una breve lista de preguntas abiertas que un revisor debería resolver.
Rellena tus datos y el prompt se actualiza al instante — luego cópialo.
Título: Usar seguridad a nivel de fila de Postgres para el aislamiento de tenants Estado: Propuesto Contexto: Alojamos varios tenants en una sola base de datos. El filtrado a nivel de aplicación ha causado dos filtraciones de datos entre tenants este trimestre. Decisión: Aplicar el aislamiento con políticas de seguridad a nivel de fila de Postgres basadas en tenant_id, establecido por conexión. Consecuencias: Garantía sólida a nivel de base de datos; cada conexión debe establecer el id de tenant o las consultas no devuelven nada. Las migraciones se vuelven más complejas. [TODO: confirmar] el impacto en el rendimiento bajo nuestra carga. Alternativas consideradas: base de datos separada por tenant, rechazada por la sobrecarga operativa; continuar con el filtrado a nivel de aplicación, rechazado tras filtraciones repetidas. Preguntas abiertas: compatibilidad con el pooler de conexiones; orden de despliegue entre servicios.
El flujo de trabajo completo
- Vuelca primero en notas en bruto la decisión, el contexto y las compensaciones
- Genera el ADR o el documento, y luego contrástalo con lo que realmente decidiste
- Rellena cada "[TODO: confirmar]" con un valor real y elimina todo lo que el modelo haya inferido por su cuenta
- Guarda el documento junto al código para que siga siendo localizable y versionado
Cuidado con
El modelo rellena huecos inventando justificaciones, requisitos o alternativas que nunca consideraste. Los documentos son una fuente de verdad sobre la que actúan otros ingenieros: verifica que cada afirmación refleje la decisión real.
No pegues arquitectura confidencial, detalles de seguridad ni código propietario en una herramienta de consumo. Los documentos de diseño internos son secretos comerciales; usa una herramienta aprobada con el entrenamiento desactivado.
La IA puede reformular una decisión pero no puede asumirla como propia. El criterio de ingeniería en un ADR es tuyo, y un revisor debería seguir dando su visto bueno.
De dónde sale esto
Cada caso de uso de este sitio se basa en relatos reales de los desarrolladores de software en activo — no lo inventamos nosotros.
Más casos de uso de IA para los desarrolladores de software
Explica código desconocido antes de modificarlo
análisisUna primera revisión de tu propio diff antes de que lo vean humanos
automatizaciónGenera pruebas unitarias y luego verifícalas contra la especificación
análisisDepuración por pato de goma para un problema que no logras resolver
comunicaciónRedacta mensajes de commit y descripciones de PR a partir de tu diff
← Los 6 casos de uso: cómo los desarrolladores de software usan la IA