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·LibraryProcessmethodologies/ccpm/ccpm-epic-planning
- lib-process:shared--claudekit-code-review·LibraryProcessmethodologies/claudekit/claudekit-code-review
- lib-process:shared--domain-driven-design·LibraryProcessmethodologies/domain-driven-design
- lib-process:shared--event-storming·LibraryProcessmethodologies/event-storming
- lib-process:shared--maestro-bootstrap·LibraryProcessmethodologies/maestro/maestro-bootstrap
- lib-process:shared--ontology-driven-development·LibraryProcessmethodologies/ontology-driven-development
- lib-process:shared--rpikit-decision·LibraryProcessmethodologies/rpikit/rpikit-decision
- lib-process:shared--spec-kit-planning·LibraryProcessmethodologies/spec-kit/spec-kit-planning
- lib-process:ai-agents-conversational--chatbot-design-implementation·LibraryProcessspecializations/ai-agents-conversational/chatbot-design-implementation
- lib-process:ai-agents-conversational--chunking-strategy-design·LibraryProcessspecializations/ai-agents-conversational/chunking-strategy-design
- lib-process:ai-agents-conversational--conversational-persona-design·LibraryProcessspecializations/ai-agents-conversational/conversational-persona-design
- lib-process:ai-agents-conversational--dialogue-flow-design·LibraryProcessspecializations/ai-agents-conversational/dialogue-flow-design
- lib-process:ai-agents-conversational--langgraph-workflow-design·LibraryProcessspecializations/ai-agents-conversational/langgraph-workflow-design
- lib-process:ai-agents-conversational--plan-and-execute-agent·LibraryProcessspecializations/ai-agents-conversational/plan-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·LibraryProcessspecializations/data-science-ml/ml-architecture-design
- lib-process:devops-sre-platform--cloud-ha-architecture-plan·LibraryProcesscloud-ha-architecture-plan
- lib-process:decision-intelligence--decision-support-system-architecture·LibraryProcessspecializations/domains/business/decision-intelligence/decision-support-system-architecture
- lib-process:decision-intelligence--operational-reporting-system-design·LibraryProcessspecializations/domains/business/decision-intelligence/operational-reporting-system-design
- lib-process:knowledge-management--mentoring-program-design·LibraryProcessdomains/business/knowledge-management/mentoring-program-design
- lib-process:public-relations--corporate-messaging-architecture·LibraryProcessspecializations/domains/business/public-relations/corporate-messaging-architecture
- lib-process:public-relations--crisis-communications-plan·LibraryProcessspecializations/domains/business/public-relations/crisis-communications-plan
- lib-process:aerospace-engineering--composite-structure-design·LibraryProcessspecializations/domains/science/aerospace-engineering/composite-structure-design
- lib-process:aerospace-engineering--mission-design-analysis·LibraryProcessspecializations/domains/science/aerospace-engineering/mission-design-analysis
- lib-process:aerospace-engineering--rocket-propulsion-design·LibraryProcessspecializations/domains/science/aerospace-engineering/rocket-propulsion-design
- lib-process:automotive-engineering--battery-system-design·LibraryProcessspecializations/domains/science/automotive-engineering/battery-system-design
- lib-process:automotive-engineering--vehicle-architecture-definition·LibraryProcessspecializations/domains/science/automotive-engineering/vehicle-architecture-definition
- lib-process:civil-engineering--bridge-design-lrfd·LibraryProcesscivil-engineering/bridge-design-lrfd
- lib-process:civil-engineering--foundation-design·LibraryProcesscivil-engineering/foundation-design
- lib-process:civil-engineering--highway-geometric-design·LibraryProcesscivil-engineering/highway-geometric-design
- lib-process:civil-engineering--hydraulic-structure-design·LibraryProcesscivil-engineering/hydraulic-structure-design
- lib-process:civil-engineering--intersection-signal-design·LibraryProcesscivil-engineering/intersection-signal-design
- lib-process:civil-engineering--pavement-design·LibraryProcesscivil-engineering/pavement-design
- lib-process:civil-engineering--reinforced-concrete-design·LibraryProcesscivil-engineering/reinforced-concrete-design
- lib-process:civil-engineering--retaining-wall-design·LibraryProcesscivil-engineering/retaining-wall-design
- lib-process:civil-engineering--seismic-design-analysis·LibraryProcesscivil-engineering/seismic-design-analysis
- lib-process:civil-engineering--stormwater-management-design·LibraryProcesscivil-engineering/stormwater-management-design
- lib-process:civil-engineering--structural-steel-design·LibraryProcesscivil-engineering/structural-steel-design
- lib-process:civil-engineering--water-distribution-design·LibraryProcesscivil-engineering/water-distribution-design
- lib-process:electrical-engineering--analog-circuit-design·LibraryProcessspecializations/domains/science/electrical-engineering/analog-circuit-design
- lib-process:electrical-engineering--bms-design·LibraryProcessspecializations/domains/science/electrical-engineering/bms-design
- lib-process:electrical-engineering--communication-system-design·LibraryProcessspecializations/domains/science/electrical-engineering/communication-system-design
- lib-process:electrical-engineering--digital-filter-design·LibraryProcessspecializations/domains/science/electrical-engineering/digital-filter-design
- lib-process:electrical-engineering--digital-logic-design·LibraryProcessspecializations/domains/science/electrical-engineering/digital-logic-design
- lib-process:electrical-engineering--dsp-algorithm-design·LibraryProcessspecializations/domains/science/electrical-engineering/dsp-algorithm-design
- lib-process:electrical-engineering--emc-design-testing·LibraryProcessspecializations/domains/science/electrical-engineering/emc-design-testing
- lib-process:electrical-engineering--feedback-control-design·LibraryProcessspecializations/domains/science/electrical-engineering/feedback-control-design
- lib-process:electrical-engineering--highspeed-pcb-design·LibraryProcessspecializations/domains/science/electrical-engineering/highspeed-pcb-design
- lib-process:electrical-engineering--mixed-signal-design·LibraryProcessspecializations/domains/science/electrical-engineering/mixed-signal-design
- lib-process:electrical-engineering--motor-drive-design·LibraryProcessspecializations/domains/science/electrical-engineering/motor-drive-design
- lib-process:electrical-engineering--switching-power-supply-design·LibraryProcessspecializations/domains/science/electrical-engineering/switching-power-supply-design
- lib-process:industrial-engineering--design-of-experiments·LibraryProcessdomains/science/industrial-engineering/design-of-experiments
- lib-process:industrial-engineering--workstation-design·LibraryProcessdomains/science/industrial-engineering/workstation-design
- lib-process:mechanical-engineering--conceptual-design-trade-study·LibraryProcessspecializations/domains/science/mechanical-engineering/conceptual-design-trade-study
- lib-process:mechanical-engineering--heat-exchanger-design·LibraryProcessspecializations/domains/science/mechanical-engineering/heat-exchanger-design
- lib-process:mechanical-engineering--hvac-system-design·LibraryProcessspecializations/domains/science/mechanical-engineering/hvac-system-design
- lib-process:mechanical-engineering--test-plan-development·LibraryProcesstest-plan-development
- lib-process:mechanical-engineering--thermal-management-design·LibraryProcessspecializations/domains/science/mechanical-engineering/thermal-management-design
- lib-process:arts-culture--audio-design·LibraryProcessfilm-tv-production/audio-design
- lib-process:arts-culture--visitor-experience-design·LibraryProcessarts-culture/visitor-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·LibraryProcesssoftware-architecture/adr-documentation
- lib-process:software-architecture--atam-analysis·LibraryProcesssoftware-architecture/atam-analysis
- lib-process:software-architecture--c4-model-documentation·LibraryProcesssoftware-architecture/c4-model-documentation
- lib-process:software-architecture--cloud-architecture-design·LibraryProcessspecializations/software-architecture/cloud-architecture-design
- lib-process:software-architecture--data-architecture-design·LibraryProcessspecializations/software-architecture/data-architecture-design
- lib-process:software-architecture--ddd-strategic-modeling·LibraryProcessspecializations/software-architecture/ddd-strategic-modeling
- lib-process:software-architecture--devops-architecture-alignment·LibraryProcessspecializations/software-architecture/devops-architecture-alignment
- lib-process:software-architecture--event-storming·LibraryProcesssoftware-architecture/event-storming
- lib-process:software-architecture--microservices-decomposition·LibraryProcessspecializations/software-architecture/microservices-decomposition
- lib-process:software-architecture--observability-implementation·LibraryProcessspecializations/software-architecture/observability-implementation
- lib-process:software-architecture--quality-attributes-workshop·LibraryProcesssoftware-architecture/quality-attributes-workshop
- lib-process:software-architecture--resilience-patterns·LibraryProcesssoftware-architecture/resilience-patterns
- lib-process:software-architecture--security-architecture-review·LibraryProcessspecializations/software-architecture/security-architecture-review
- lib-process:software-architecture--system-design-review·LibraryProcesssoftware-architecture/system-design-review
- lib-process:software-architecture--tech-stack-evaluation·LibraryProcessspecializations/software-architecture/tech-stack-evaluation
- lib-process:technical-documentation--adr-docs·LibraryProcesstechnical-documentation/adr-docs
- lib-process:web-development--micro-frontend-module-federation·LibraryProcessspecializations/web-development/micro-frontend-module-federation
- lib-skill:software-architecture--adr-generator·LibrarySkilladr-generator
- lib-skill:software-architecture--c4-diagram-generator·LibrarySkillc4-diagram-generator