architecture-decision-records
Crear decisiones de arquitectura claras rápidamente
Los equipos pierden contexto cuando las decisiones no están documentadas o están dispersas. Esta habilidad proporciona plantillas ADR, guía del ciclo de vida y listas de verificación de revisión para capturar decisiones de manera consistente.
Descargar el ZIP de la skill
Subir en Claude
Ve a Configuración → Capacidades → Skills → Subir skill
Activa y empieza a usar
Pruébalo
Usando "architecture-decision-records". Write an ADR to adopt Redis for caching product pages.
Resultado esperado:
- ADR-0010: Use Redis for product page caching
- Status: Accepted
- Context: Slow page loads during peak traffic
- Decision: Add Redis as a read through cache
- Consequences: Faster reads, added cache invalidation work
Usando "architecture-decision-records". Create an ADR for choosing between REST and GraphQL.
Resultado esperado:
- ADR-0015: Use GraphQL for the API layer
- Status: Accepted
- Context: Mobile clients need flexible data fetching
- Decision: Adopt GraphQL with Apollo Server
- Considered: REST API with pagination, Falcor
- Positive: Reduced over-fetching, strong typing
- Negative: Added complexity, caching challenges
Auditoría de seguridad
SeguroPure documentation skill containing only templates and guidance for writing Architecture Decision Records. All 56 static findings are false positives: detected patterns are markdown documentation examples, harmless text strings in prose, and legitimate documentation links. No executable code, file access, network activity, or external commands are present.
Factores de riesgo
🌐 Acceso a red (9)
⚙️ Comandos externos (25)
Puntuación de calidad
Lo que puedes crear
Documentar decisiones importantes
Crear ADRs estructurados para decisiones de base de datos, plataforma e integración.
Estandarizar registros de decisiones
Adoptar un proceso ADR consistente y lista de verificación de revisión entre equipos.
Revisar decisiones pasadas
Comprender elecciones históricas y sus consecuencias durante la incorporación.
Prueba estos prompts
Crear un ADR ligero para adoptar TypeScript en nuestro frontend. Incluir contexto, decisión y consecuencias.
Escribir un ADR estándar comparando PostgreSQL, MySQL y MongoDB para nuestro catálogo de productos.
Redactar un ADR de deprecación para reemplazar MongoDB con PostgreSQL, incluyendo un plan de migración.
Crear un ADR estilo RFC para event sourcing en gestión de pedidos, con motivación, diseño, desventajas y alternativas.
Mejores prácticas
- Escribir ADRs antes de que comience la implementación
- Registrar tanto consecuencias positivas como negativas
- Vincular ADRs relacionados y actualizar el estado con el tiempo
Evitar
- Editar ADRs aceptados en lugar de supersededarlos
- Omitir contexto y motivadores de la decisión
- Usar lenguaje vago sin decisiones claras