Perfil de habilidad

Architecture Decision Records (ADR)

ADR format, decision log, team alignment, ADR management tools

Architecture & System Design Architecture Governance

Roles

donde aparece esta habilidad

Niveles

ruta de crecimiento estructurada

Requisitos obligatorios

los otros 7 opcionales

Dominio

Architecture & System Design

skills.group

Architecture Governance

Última actualización

17/3/2026

Cómo usar

Selecciona tu nivel actual y compara las expectativas.

Qué se espera en cada nivel

La tabla muestra cómo crece la profundidad desde Junior hasta Principal.

Rol	Obligatorio	Descripción
Technical Writer		Understands the purpose of Architecture Decision Records and their role in capturing architectural decisions. Knows the basic ADR structure (context, decision, consequences). Can find and read existing ADRs in the project repository.

Rol	Obligatorio	Descripción
Engineering Manager		Applies ADR practices in engineering management: ensures teams document significant technical decisions, reviews ADRs for completeness and stakeholder alignment, and tracks decision outcomes. Facilitates architectural decision-making processes across team boundaries.
Technical Lead		Applies ADR practices in technical leadership: writes well-structured Architecture Decision Records with context, options analysis, and consequences. Reviews team ADRs for technical accuracy and maintains ADR repository with consistent numbering and status tracking.
Technical Writer		Independently creates ADRs based on discussions with architects and developers. Maintains numbering, coherence, and relevance of records. Integrates ADRs into docs-as-code pipeline, ensuring publication on the developer portal.

Rol	Obligatorio	Descripción
Engineering Manager	Obligatorio	Designs ADR governance framework for engineering organization: defines ADR templates, review workflows, and lifecycle management processes. Implements metrics for decision quality tracking and ensures ADRs inform capacity planning and technical roadmaps.
Solutions Architect	Obligatorio	Designs ADR practice for solution architecture: creates comprehensive decision records covering system boundaries, integration patterns, and technology selections. Evaluates cross-system impact of architectural decisions and maintains traceability between ADRs and implementation.
Technical Lead	Obligatorio	Designs ADR practice for technical teams: establishes lightweight decision records for code-level choices, defines escalation criteria for architecture-level ADRs, and implements ADR-as-code workflows integrated with version control and CI/CD pipelines.
Technical Writer		Develops ADR process for the entire organization: templates, review rules, lifecycle statuses (proposed, accepted, deprecated, superseded). Helps architects formulate decisions clearly and argumentatively, reviews context and consequences.

Rol	Obligatorio	Descripción
Engineering Manager	Obligatorio	Defines product architectural strategy with Architecture Decision Records. Shapes architecture guidelines. Conducts architecture reviews.
Solutions Architect	Obligatorio	Defines product architectural strategy with Architecture Decision Records. Establishes architecture guidelines. Conducts architecture reviews.
Technical Lead	Obligatorio	Defines the product's architectural strategy with Architecture Decision Records. Establishes architecture guidelines. Conducts architecture reviews.
Technical Writer		Establishes corporate Architecture Decision Records practices: governance, integration with architecture review board, onboarding for new developers. Conducts ADR audits and ensures their relevance as the system evolves.

Rol	Obligatorio	Descripción
Engineering Manager	Obligatorio	Defines organizational architectural strategy. Designs reference architectures. Establishes architecture governance.
Solutions Architect	Obligatorio	Defines enterprise ADR strategy and architectural governance framework. Shapes organization-wide decision-making culture with structured ADR processes spanning multiple domains and business units. Mentors architects on effective decision documentation and trade-off analysis.
Technical Lead	Obligatorio	Defines enterprise ADR standards and technical decision-making framework. Shapes engineering culture around evidence-based architectural decisions with measurable outcomes. Establishes cross-team ADR review boards and drives adoption of decision records as first-class engineering artifacts.
Technical Writer		Defines architectural knowledge management strategy at the company level, where ADR is a key element. Establishes connections between ADRs, C4 diagrams, and architecture roadmap, ensuring traceability from business requirements to technical implementation.

Junior 1 requisitos

Technical Writer

Understands the purpose of Architecture Decision Records and their role in capturing architectural decisions. Knows the basic ADR structure (context, decision, consequences). Can find and read existing ADRs in the project repository.

Middle 3 requisitos

Engineering Manager

Applies ADR practices in engineering management: ensures teams document significant technical decisions, reviews ADRs for completeness and stakeholder alignment, and tracks decision outcomes. Facilitates architectural decision-making processes across team boundaries.
Technical Lead

Applies ADR practices in technical leadership: writes well-structured Architecture Decision Records with context, options analysis, and consequences. Reviews team ADRs for technical accuracy and maintains ADR repository with consistent numbering and status tracking.
Technical Writer

Independently creates ADRs based on discussions with architects and developers. Maintains numbering, coherence, and relevance of records. Integrates ADRs into docs-as-code pipeline, ensuring publication on the developer portal.

Senior 4 requisitos

Engineering Manager
Obligatorio

Designs ADR governance framework for engineering organization: defines ADR templates, review workflows, and lifecycle management processes. Implements metrics for decision quality tracking and ensures ADRs inform capacity planning and technical roadmaps.
Solutions Architect
Obligatorio

Designs ADR practice for solution architecture: creates comprehensive decision records covering system boundaries, integration patterns, and technology selections. Evaluates cross-system impact of architectural decisions and maintains traceability between ADRs and implementation.
Technical Lead
Obligatorio

Designs ADR practice for technical teams: establishes lightweight decision records for code-level choices, defines escalation criteria for architecture-level ADRs, and implements ADR-as-code workflows integrated with version control and CI/CD pipelines.

Lead / Staff 4 requisitos

Engineering Manager
Obligatorio

Defines product architectural strategy with Architecture Decision Records. Shapes architecture guidelines. Conducts architecture reviews.
Solutions Architect
Obligatorio

Defines product architectural strategy with Architecture Decision Records. Establishes architecture guidelines. Conducts architecture reviews.
Technical Lead
Obligatorio

Defines the product's architectural strategy with Architecture Decision Records. Establishes architecture guidelines. Conducts architecture reviews.

Principal 4 requisitos

Engineering Manager
Obligatorio

Defines organizational architectural strategy. Designs reference architectures. Establishes architecture governance.
Solutions Architect
Obligatorio

Defines enterprise ADR strategy and architectural governance framework. Shapes organization-wide decision-making culture with structured ADR processes spanning multiple domains and business units. Mentors architects on effective decision documentation and trade-off analysis.
Technical Lead
Obligatorio

Defines enterprise ADR standards and technical decision-making framework. Shapes engineering culture around evidence-based architectural decisions with measurable outcomes. Establishes cross-team ADR review boards and drives adoption of decision records as first-class engineering artifacts.

Comunidad

👁 Seguir ✏️ Sugerir cambio

Cargando comentarios...