adr-roadmap

Architecture Decision Records (ADRs) can be transformed into phased implementation roadmaps by analyzing dependencies, estimating timelines, and decomposing work into logical phases. This Skill parses ADRs, identifies critical paths, and produces Mermaid diagrams and task lists with effort and risk estimates for execution planning.

Yes. This approach analyzes ADRs spanning web, mobile, data, ML, and infrastructure domains simultaneously. It computes inter-dependencies, generates critical path analysis, applies complexity and risk scoring, and produces visual dependency graphs and Gantt charts to show how decisions relate across domains.

Mermaid diagrams provide intuitive visual representation of ADR relationships and phased execution. This Skill generates both dependency graphs and Gantt charts in Mermaid format, enabling clear communication of roadmap structure, timelines, and resource allocation to all stakeholders.

By applying dependency mapping, complexity scoring, and risk assessment to ADRs, you can decompose architectural decisions into phased tasks with resource allocation and risk buffers. This produces actionable implementation tasks with timeline estimates and identified mitigation strategies.

Yes. For migration projects with numerous ADRs and cross-domain dependencies, this approach generates comprehensive roadmaps including timelines, resource needs, critical path analysis, and risk assessments. It ensures predictable execution and architectural alignment throughout the transition.

ADRs should be stored as structured documents (typically Markdown) in a dedicated directory. The Skill parses ADR metadata and decision content to extract dependencies, domains, and complexity signals, then computes phased decompositions and produces Mermaid artifacts and implementation task outputs.