About

Imported from vladm3105/aidoc-flow-framework (platforms/claude-code-plugin/skills/adr-roadmap/SKILL.md). Install upstream with npx skills add vladm3105/aidoc-flow-framework --skill adr-roadmap. Copyright stays with the author.

adr-roadmap

Name: adr-roadmap
Author: vladm3105

Purpose

Analyze a project's Architecture Decision Records (ADRs, Layer 5) and produce a phased implementation roadmap: dependency mapping, critical path, phase decomposition, timeline estimates, per-phase risk assessment, and a testing and technical-debt strategy. Engine-agnostic — works for any domain (web, mobile, data, ML, infrastructure, embedded).

Upstream: ADR. Downstream: feeds SPEC → TDD → IPLAN delivery sequencing.

When to Use

Use adr-roadmap when:

A project has roughly five or more ADRs that need coordinated, phased rollout.
You need visibility into architectural dependencies and the critical path.
Stakeholders need a timeline, milestones, and an executive summary derived from ADR complexity.

Do not use it for a single ADR with a trivial implementation, for informational ADRs with no build work, when planning from requirements (use ../doc-brd/SKILL.md / ../doc-prd/SKILL.md / ../doc-ears/SKILL.md), or when you only need diagrams (use ../charts-flow/SKILL.md).

Behavior

Inventory ADRs — read every ADR-*.md, extract ID, title, status, complexity (1–5), effort, and dependencies; warn on missing complexity or broken dependency references; error if no ADRs are found.
Build the dependency graph — classify hard / soft / no dependencies, detect cycles (error), compute the critical path, and find clusters that can run in parallel.
Estimate effort — map complexity to base effort, sum across ADRs, apply a risk buffer (~20%), and flag high-risk ADRs (complexity 4–5 with many deps).
Form phases — apply the chosen phase model (poc-mvp-prod default, iterative, or waterfall), respecting dependencies, capping phase length (default 8 weeks), isolating risk, and ending phases on natural milestones. Adapt for greenfield, brownfield/migration (add rollback + dual-run), or refactoring (module-by-module) projects.
Build the timeline — derive phase durations from effort and team size, add inter-phase buffers, and produce a Gantt chart (via ../charts-flow/SKILL.md) with milestones.
Write the roadmap at {adr_dir}/ADR-00_IMPLEMENTATION-ROADMAP.md: Document Control, executive summary, per-phase sections (objectives, ADRs, architecture diagram, order, deliverables, success/exit criteria, risk), dependency matrix, technical-debt management, risk assessment, testing strategy, and traceability back to upstream (BRD–BDD) and downstream (SPEC/TDD/IPLAN) artifacts.

Constraints: use ADR decisions as-is (make no technology choices); map every ADR to exactly one phase; never exceed the phase cap; keep language objective; require rollback plans for production phases. Keep each document under 100k tokens.

Related Resources

ADR layer: ${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/README.md · ${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/ADR-TEMPLATE.yaml
ID & tag standards: ${CLAUDE_PLUGIN_ROOT}/framework/governance/ID_NAMING_STANDARDS.md
Traceability: ${CLAUDE_PLUGIN_ROOT}/framework/governance/TRACEABILITY.md
Diagrams: ../charts-flow/SKILL.md
Downstream generation: ../doc-spec/SKILL.md · ../doc-tdd/SKILL.md · ../doc-iplan/SKILL.md
Traceability check: ../doc-validator/SKILL.md

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/vladm3105-aidoc-flow-framework-adr-roadmap/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

vladm3105-aidoc-flow-framework-adr-roadmap.ocm.jsonjson

{
  "ocm": "1",
  "id": "vladm3105-aidoc-flow-framework-adr-roadmap",
  "kind": "skill",
  "name": "adr-roadmap",
  "description": "Generate a phased implementation roadmap from a set of Architecture Decision Records, with dependencies, timeline, risk, and testing strategy. Use when coordinating delivery of multiple ADRs.",
  "publisher": "vladm3105",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "customer_support"
    ],
    "tags": [
      "skill-md",
      "sdd-workflow",
      "utility",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Generate a phased implementation roadmap from a set of Architecture Decision Records, with dependencies, timeline, risk, and testing strategy. Use when coordinating delivery of multiple ADRs."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/vladm3105/aidoc-flow-framework",
      "path": "platforms/claude-code-plugin/skills/adr-roadmap/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/vladm3105/aidoc-flow-framework/blob/HEAD/platforms/claude-code-plugin/skills/adr-roadmap/SKILL.md",
      "key": "vladm3105/aidoc-flow-framework/platforms/claude-code-plugin/skills/adr-roadmap/SKILL.md"
    }
  },
  "instructions": "# adr-roadmap\n\n## Purpose\n\nAnalyze a project's Architecture Decision Records (ADRs, Layer 5) and produce a\nphased implementation roadmap: dependency mapping, critical path, phase\ndecomposition, timeline estimates, per-phase risk assessment, and a testing and\ntechnical-debt strategy. Engine-agnostic — works for any domain (web, mobile,\ndata, ML, infrastructure, embedded).\n\n**Upstream**: ADR. **Downstream**: feeds SPEC → TDD → IPLAN delivery sequencing.\n\n## When to Use\n\nUse `adr-roadmap` when:\n\n- A project has roughly five or more ADRs that need coordinated, phased rollout.\n- You need visibility",
  "cost": {
    "context_tokens": 827
  }
}

Fetch it by URL: GET /api/v1/registry/vladm3105-aidoc-flow-framework-adr-roadmap/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.