II.
Workflow overview
Reference · liveworkflow:architecture-decision-record
Architecture Decision Record overview
Lightweight on-demand workflow invoked whenever a significant architectural decision must be made and preserved for future reference. The proposing engineer or architect drafts an ADR document describing the context, options considered, decision made, and expected consequences. The draft circulates to relevant stakeholders for asynchronous comment over a fixed review window. After consensus or formal approval, the ADR is merged into the repository's decision log and linked from affected code or documentation. The workflow creates a durable, discoverable record of why the system is the way it is, reducing repeated debates and onboarding friction.
Attributes
displayName
Architecture Decision Record
description
Lightweight on-demand workflow invoked whenever a significant architectural decision
must be made and preserved for future reference. The proposing engineer or architect
drafts an ADR document describing the context, options considered, decision made,
and expected consequences. The draft circulates to relevant stakeholders for
asynchronous comment over a fixed review window. After consensus or formal approval,
the ADR is merged into the repository's decision log and linked from affected code
or documentation. The workflow creates a durable, discoverable record of why the
system is the way it is, reducing repeated debates and onboarding friction.
workflowKind
development
triggerType
on-demand
typicalCadence
per-decision
complexity
moderate
Outgoing edges
applies_to_domain2
- domain:software-engineering·DomainSoftware Engineering
- domain:platform-engineering·DomainPlatform Engineering
involves_role5
- role:architect·RoleArchitect
- role:principal-engineer·RolePrincipal Engineer
- role:tech-lead·RoleTech Lead
- role:engineering-manager·RoleEngineering Manager
- role:cto·RoleChief Technology Officer
triggers_responsibility3
- responsibility:architecture-decision·ResponsibilityArchitecture Decision
- responsibility:documentation·ResponsibilityDocumentation
- responsibility:knowledge-sharing·ResponsibilityKnowledge Sharing
Incoming edges
lib_implements_workflow175
- lib-agent:devops-sre-platform--infra-architect·LibraryAgentinfra-architect
- lib-agent:meta--process-architect·LibraryAgentprocess-architect
- lib-agent:security-compliance--threat-modeling-agent·LibraryAgentthreat-modeling-agent
- lib-agent:software-architecture--adr-author·LibraryAgentadr-author
- lib-agent:software-architecture--atam-analyst·LibraryAgentatam-analyst
- lib-agent:software-architecture--c4-model-architect·LibraryAgentc4-model-architect
- lib-agent:software-architecture--cloud-solutions-architect·LibraryAgentcloud-solutions-architect
- lib-agent:software-architecture--cqrs-event-sourcing-expert·LibraryAgentcqrs-event-sourcing-expert
- lib-agent:software-architecture--data-architect·LibraryAgentdata-architect
- lib-agent:software-architecture--ddd-expert·LibraryAgentddd-expert
- lib-agent:software-architecture--devops-architect·LibraryAgentdevops-architect
- lib-agent:software-architecture--event-storming-facilitator·LibraryAgentevent-storming-facilitator
- lib-agent:software-architecture--microservices-architect·LibraryAgentmicroservices-architect
- lib-agent:software-architecture--observability-architect·LibraryAgentobservability-architect
- lib-agent:software-architecture--quality-attributes-specialist·LibraryAgentquality-attributes-specialist
- lib-agent:software-architecture--resilience-patterns-engineer·LibraryAgentresilience-patterns-engineer
- lib-agent:software-architecture--security-architect·LibraryAgentsecurity-architect
- lib-agent:software-architecture--tech-stack-evaluator·LibraryAgenttech-stack-evaluator
- lib-agent:web-development--architecture-documentation·LibraryAgentarchitecture-documentation
- lib-agent:web-development--frontend-architect·LibraryAgentfrontend-architect
- lib-agent:web-development--fullstack-architect·LibraryAgentfullstack-architect
- lib-agent:web-development--micro-frontend-architect·LibraryAgentmicro-frontend-architect
- lib-process:shared--ccpm-epic-planning·LibraryProcessccpm-epic-planning
- lib-process:shared--claudekit-code-review·LibraryProcessclaudekit-code-review
- lib-process:shared--domain-driven-design·LibraryProcessdomain-driven-design
- lib-process:shared--event-storming·LibraryProcessevent-storming
- lib-process:shared--maestro-bootstrap·LibraryProcessmaestro-bootstrap
- lib-process:shared--ontology-driven-development·LibraryProcessontology-driven-development
- lib-process:shared--rpikit-decision·LibraryProcessrpikit-decision
- lib-process:shared--spec-kit-planning·LibraryProcessspec-kit-planning
- lib-process:ai-agents-conversational--chatbot-design-implementation·LibraryProcesschatbot-design-implementation
- lib-process:ai-agents-conversational--chunking-strategy-design·LibraryProcesschunking-strategy-design
- lib-process:ai-agents-conversational--conversational-persona-design·LibraryProcessconversational-persona-design
- lib-process:ai-agents-conversational--dialogue-flow-design·LibraryProcessdialogue-flow-design
- lib-process:ai-agents-conversational--langgraph-workflow-design·LibraryProcesslanggraph-workflow-design
- lib-process:ai-agents-conversational--plan-and-execute-agent·LibraryProcessplan-and-execute-agent
- lib-process:algorithms-optimization--advanced-dp-techniques·LibraryProcessspecializations/algorithms-optimization/advanced-dp-techniques
- lib-process:algorithms-optimization--advanced-graph-algorithms·LibraryProcessspecializations/algorithms-optimization/advanced-graph-algorithms
- lib-process:algorithms-optimization--algorithm-implementation·LibraryProcessspecializations/algorithms-optimization/algorithm-implementation
- lib-process:algorithms-optimization--atcoder-contest·LibraryProcessspecializations/algorithms-optimization/atcoder-contest
- lib-process:algorithms-optimization--backtracking-pruning·LibraryProcessspecializations/algorithms-optimization/backtracking-pruning
- lib-process:algorithms-optimization--behavioral-interview-prep·LibraryProcessspecializations/algorithms-optimization/behavioral-interview-prep
- lib-process:algorithms-optimization--binary-search-applications·LibraryProcessspecializations/algorithms-optimization/binary-search-applications
- lib-process:algorithms-optimization--classic-dp-library·LibraryProcessspecializations/algorithms-optimization/classic-dp-library
- lib-process:algorithms-optimization--code-level-optimization·LibraryProcessspecializations/algorithms-optimization/code-level-optimization
- lib-process:algorithms-optimization--codeforces-contest·LibraryProcessspecializations/algorithms-optimization/codeforces-contest
- lib-process:algorithms-optimization--combinatorics-counting·LibraryProcessspecializations/algorithms-optimization/combinatorics-counting
- lib-process:algorithms-optimization--complexity-optimization·LibraryProcessspecializations/algorithms-optimization/complexity-optimization
- lib-process:algorithms-optimization--computational-geometry·LibraryProcessspecializations/algorithms-optimization/computational-geometry
- lib-process:algorithms-optimization--correctness-proof-testing·LibraryProcessspecializations/algorithms-optimization/correctness-proof-testing
- lib-process:algorithms-optimization--cses-learning-path·LibraryProcessspecializations/algorithms-optimization/cses-learning-path
- lib-process:algorithms-optimization--divide-conquer-design·LibraryProcessspecializations/algorithms-optimization/divide-conquer-design
- lib-process:algorithms-optimization--dp-pattern-matching·LibraryProcessspecializations/algorithms-optimization/dp-pattern-matching
- lib-process:algorithms-optimization--dp-state-optimization·LibraryProcessspecializations/algorithms-optimization/dp-state-optimization
- lib-process:algorithms-optimization--dp-transition-derivation·LibraryProcessspecializations/algorithms-optimization/dp-transition-derivation
- lib-process:algorithms-optimization--faang-interview-prep·LibraryProcessspecializations/algorithms-optimization/faang-interview-prep
- lib-process:algorithms-optimization--fenwick-tree-implementation·LibraryProcessspecializations/algorithms-optimization/fenwick-tree-implementation
- lib-process:algorithms-optimization--graph-traversal·LibraryProcessspecializations/algorithms-optimization/graph-traversal
- lib-process:algorithms-optimization--greedy-algorithm-design·LibraryProcessspecializations/algorithms-optimization/greedy-algorithm-design
- lib-process:algorithms-optimization--interview-problem-explanation·LibraryProcessspecializations/algorithms-optimization/interview-problem-explanation
- lib-process:algorithms-optimization--leetcode-problem-solving·LibraryProcessspecializations/algorithms-optimization/leetcode-problem-solving
- lib-process:algorithms-optimization--memory-optimization·LibraryProcessspecializations/algorithms-optimization/memory-optimization
- lib-process:algorithms-optimization--mock-coding-interview·LibraryProcessspecializations/algorithms-optimization/mock-coding-interview
- lib-process:algorithms-optimization--number-theory-algorithms·LibraryProcessspecializations/algorithms-optimization/number-theory-algorithms
- lib-process:algorithms-optimization--pattern-matching-algorithms·LibraryProcessspecializations/algorithms-optimization/pattern-matching-algorithms
- lib-process:algorithms-optimization--pattern-recognition·LibraryProcessspecializations/algorithms-optimization/pattern-recognition
- lib-process:algorithms-optimization--prime-algorithms·LibraryProcessspecializations/algorithms-optimization/prime-algorithms
- lib-process:algorithms-optimization--progress-tracking·LibraryProcessspecializations/algorithms-optimization/progress-tracking
- lib-process:algorithms-optimization--range-query-optimization·LibraryProcessspecializations/algorithms-optimization/range-query-optimization
- lib-process:algorithms-optimization--segment-tree-implementation·LibraryProcessspecializations/algorithms-optimization/segment-tree-implementation
- lib-process:algorithms-optimization--shortest-path-algorithms·LibraryProcessspecializations/algorithms-optimization/shortest-path-algorithms
- lib-process:algorithms-optimization--skill-gap-analysis·LibraryProcessspecializations/algorithms-optimization/skill-gap-analysis
- lib-process:algorithms-optimization--string-processing·LibraryProcessspecializations/algorithms-optimization/string-processing
- lib-process:algorithms-optimization--system-design-interview·LibraryProcessspecializations/algorithms-optimization/system-design-interview
- lib-process:algorithms-optimization--topic-mastery-certification·LibraryProcessspecializations/algorithms-optimization/topic-mastery-certification
- lib-process:algorithms-optimization--two-pointer-sliding-window·LibraryProcessspecializations/algorithms-optimization/two-pointer-sliding-window
- lib-process:data-science-ml--ml-architecture-design·LibraryProcessml-architecture-design
- lib-process:devops-sre-platform--cloud-ha-architecture-plan·LibraryProcesscloud-ha-architecture-plan
- lib-process:decision-intelligence--decision-support-system-architecture·LibraryProcessdecision-support-system-architecture
- lib-process:decision-intelligence--operational-reporting-system-design·LibraryProcessoperational-reporting-system-design
- lib-process:knowledge-management--mentoring-program-design·LibraryProcessmentoring-program-design
- lib-process:public-relations--corporate-messaging-architecture·LibraryProcesscorporate-messaging-architecture
- lib-process:public-relations--crisis-communications-plan·LibraryProcesscrisis-communications-plan
- lib-process:aerospace-engineering--composite-structure-design·LibraryProcesscomposite-structure-design
- lib-process:aerospace-engineering--mission-design-analysis·LibraryProcessmission-design-analysis
- lib-process:aerospace-engineering--rocket-propulsion-design·LibraryProcessrocket-propulsion-design
- lib-process:automotive-engineering--battery-system-design·LibraryProcessbattery-system-design
- lib-process:automotive-engineering--vehicle-architecture-definition·LibraryProcessvehicle-architecture-definition
- lib-process:civil-engineering--bridge-design-lrfd·LibraryProcessbridge-design-lrfd
- lib-process:civil-engineering--foundation-design·LibraryProcessfoundation-design
- lib-process:civil-engineering--highway-geometric-design·LibraryProcesshighway-geometric-design
- lib-process:civil-engineering--hydraulic-structure-design·LibraryProcesshydraulic-structure-design
- lib-process:civil-engineering--intersection-signal-design·LibraryProcessintersection-signal-design
- lib-process:civil-engineering--pavement-design·LibraryProcesspavement-design
- lib-process:civil-engineering--reinforced-concrete-design·LibraryProcessreinforced-concrete-design
- lib-process:civil-engineering--retaining-wall-design·LibraryProcessretaining-wall-design
- lib-process:civil-engineering--seismic-design-analysis·LibraryProcessseismic-design-analysis
- lib-process:civil-engineering--stormwater-management-design·LibraryProcessstormwater-management-design
- lib-process:civil-engineering--structural-steel-design·LibraryProcessstructural-steel-design
- lib-process:civil-engineering--water-distribution-design·LibraryProcesswater-distribution-design
- lib-process:electrical-engineering--analog-circuit-design·LibraryProcessanalog-circuit-design
- lib-process:electrical-engineering--bms-design·LibraryProcessbms-design
- lib-process:electrical-engineering--communication-system-design·LibraryProcesscommunication-system-design
- lib-process:electrical-engineering--digital-filter-design·LibraryProcessdigital-filter-design
- lib-process:electrical-engineering--digital-logic-design·LibraryProcessdigital-logic-design
- lib-process:electrical-engineering--dsp-algorithm-design·LibraryProcessdsp-algorithm-design
- lib-process:electrical-engineering--emc-design-testing·LibraryProcessemc-design-testing
- lib-process:electrical-engineering--feedback-control-design·LibraryProcessfeedback-control-design
- lib-process:electrical-engineering--highspeed-pcb-design·LibraryProcesshighspeed-pcb-design
- lib-process:electrical-engineering--mixed-signal-design·LibraryProcessmixed-signal-design
- lib-process:electrical-engineering--motor-drive-design·LibraryProcessmotor-drive-design
- lib-process:electrical-engineering--switching-power-supply-design·LibraryProcessswitching-power-supply-design
- lib-process:industrial-engineering--design-of-experiments·LibraryProcessdesign-of-experiments
- lib-process:industrial-engineering--workstation-design·LibraryProcessworkstation-design
- lib-process:mechanical-engineering--conceptual-design-trade-study·LibraryProcessconceptual-design-trade-study
- lib-process:mechanical-engineering--heat-exchanger-design·LibraryProcessheat-exchanger-design
- lib-process:mechanical-engineering--hvac-system-design·LibraryProcesshvac-system-design
- lib-process:mechanical-engineering--test-plan-development·LibraryProcesstest-plan-development
- lib-process:mechanical-engineering--thermal-management-design·LibraryProcessthermal-management-design
- lib-process:arts-culture--audio-design·LibraryProcessaudio-design
- lib-process:arts-culture--visitor-experience-design·LibraryProcessvisitor-experience-design
- lib-process:embedded-systems--hardware-software-codesign·LibraryProcessspecializations/embedded-systems/hardware-software-codesign
- lib-process:embedded-systems--isr-design·LibraryProcessspecializations/embedded-systems/isr-design
- lib-process:embedded-systems--low-power-design·LibraryProcessspecializations/embedded-systems/low-power-design
- lib-process:embedded-systems--memory-architecture-planning·LibraryProcessspecializations/embedded-systems/memory-architecture-planning
- lib-process:embedded-systems--real-time-architecture-design·LibraryProcessspecializations/embedded-systems/real-time-architecture-design
- lib-process:fpga-programming--axi-interface-design·LibraryProcessspecializations/fpga-programming/axi-interface-design
- lib-process:fpga-programming--cdc-design·LibraryProcessspecializations/fpga-programming/cdc-design
- lib-process:fpga-programming--clock-network-design·LibraryProcessspecializations/fpga-programming/clock-network-design
- lib-process:fpga-programming--design-for-testability·LibraryProcessspecializations/fpga-programming/design-for-testability
- lib-process:fpga-programming--fsm-design·LibraryProcessspecializations/fpga-programming/fsm-design
- lib-process:fpga-programming--hardware-software-codesign·LibraryProcessspecializations/fpga-programming/hardware-software-codesign
- lib-process:fpga-programming--memory-interface-design·LibraryProcessspecializations/fpga-programming/memory-interface-design
- lib-process:fpga-programming--pipeline-architecture·LibraryProcessspecializations/fpga-programming/pipeline-architecture
- lib-process:fpga-programming--rtl-module-architecture·LibraryProcessspecializations/fpga-programming/rtl-module-architecture
- lib-process:fpga-programming--verilog-systemverilog-design·LibraryProcessspecializations/fpga-programming/verilog-systemverilog-design
- lib-process:game-development--audio-design-integration·LibraryProcessspecializations/game-development/audio-design-integration
- lib-process:game-development--level-design-process·LibraryProcessspecializations/game-development/level-design-process
- lib-process:game-development--narrative-design·LibraryProcessspecializations/game-development/narrative-design
- lib-process:gpu-programming--parallel-algorithm-design·LibraryProcessspecializations/gpu-programming/parallel-algorithm-design
- lib-process:meta--process-creation·LibraryProcessmeta/process-creation
- lib-process:meta--specialization-creation·LibraryProcessmeta/specialization-creation
- lib-process:network-programming--custom-protocol-design·LibraryProcessspecializations/network-programming/custom-protocol-design
- lib-process:performance-optimization--caching-strategy-design·LibraryProcessspecializations/performance-optimization/caching-strategy-design
- lib-process:programming-languages--ast-design·LibraryProcessspecializations/programming-languages/ast-design
- lib-process:programming-languages--effect-system-design·LibraryProcessspecializations/programming-languages/effect-system-design
- lib-process:programming-languages--ir-design·LibraryProcessspecializations/programming-languages/ir-design
- lib-process:programming-languages--language-grammar-design·LibraryProcessspecializations/programming-languages/language-grammar-design
- lib-process:programming-languages--memory-allocator-design·LibraryProcessspecializations/programming-languages/memory-allocator-design
- lib-process:programming-languages--module-system-design·LibraryProcessspecializations/programming-languages/module-system-design
- lib-process:robotics-simulation--mpc-controller-design·LibraryProcessspecializations/robotics-simulation/mpc-controller-design
- lib-process:robotics-simulation--robot-system-design·LibraryProcessspecializations/robotics-simulation/robot-system-design
- lib-process:sdk-platform-development--api-design-specification·LibraryProcessspecializations/sdk-platform-development/api-design-specification
- lib-process:sdk-platform-development--platform-api-gateway-design·LibraryProcessspecializations/sdk-platform-development/platform-api-gateway-design
- lib-process:sdk-platform-development--plugin-extension-architecture·LibraryProcessspecializations/sdk-platform-development/plugin-extension-architecture
- lib-process:sdk-platform-development--sdk-architecture-design·LibraryProcessspecializations/sdk-platform-development/sdk-architecture-design
- lib-process:software-architecture--adr-documentation·LibraryProcessadr-documentation
- lib-process:software-architecture--atam-analysis·LibraryProcessatam-analysis
- lib-process:software-architecture--c4-model-documentation·LibraryProcessc4-model-documentation
- lib-process:software-architecture--cloud-architecture-design·LibraryProcesscloud-architecture-design
- lib-process:software-architecture--data-architecture-design·LibraryProcessdata-architecture-design
- lib-process:software-architecture--ddd-strategic-modeling·LibraryProcessddd-strategic-modeling
- lib-process:software-architecture--devops-architecture-alignment·LibraryProcessdevops-architecture-alignment
- lib-process:software-architecture--event-storming·LibraryProcessevent-storming
- lib-process:software-architecture--microservices-decomposition·LibraryProcessmicroservices-decomposition
- lib-process:software-architecture--observability-implementation·LibraryProcessobservability-implementation
- lib-process:software-architecture--quality-attributes-workshop·LibraryProcessquality-attributes-workshop
- lib-process:software-architecture--resilience-patterns·LibraryProcessresilience-patterns
- lib-process:software-architecture--security-architecture-review·LibraryProcesssecurity-architecture-review
- lib-process:software-architecture--system-design-review·LibraryProcesssystem-design-review
- lib-process:software-architecture--tech-stack-evaluation·LibraryProcesstech-stack-evaluation
- lib-process:technical-documentation--adr-docs·LibraryProcesstechnical-documentation/adr-docs
- lib-process:web-development--micro-frontend-module-federation·LibraryProcessmicro-frontend-module-federation
- lib-skill:software-architecture--adr-generator·LibrarySkilladr-generator
- lib-skill:software-architecture--c4-diagram-generator·LibrarySkillc4-diagram-generator