| name | related |
| description | Shows the dependency graph for one Architecture Decision Record. Give it an ADR id (e.g. "ADR-007") and it lists outbound edges (Related Decisions entries, Supersedes claims, Superseded by / Amended by status refs) and inbound edges (every other ADR that references it, with the reference kind), flagging dangling references to ADRs that do not exist. Read-only and safe to call from parallel subagents. Invoke before superseding or retiring an ADR, or whenever you need to know what depends on a decision. |
| argument-hint | [ADR id; e.g. "ADR-007" or "7"] |
| license | MIT |
| allowed-tools | ["Read","Bash"] |
adr-kit related
You are running /adr-kit:related. Purpose: show who an ADR points at and who
points back at it, before anyone changes its status. This is read-only; it
never edits ADRs.
Procedure
-
Take the ADR id from the argument. If none was given, ask the user which
ADR to inspect (id or title fragment is enough; resolve a title fragment by
listing docs/adr/ADR-*.md and matching).
-
Resolve the plugin path and run the bundled graph tool from the project
root:
ADR_KIT=$(ls -d ~/.claude/plugins/cache/rvdbreemen-adr-kit/adr-kit/*/ | sort -V | tail -1)
python "$ADR_KIT/bin/adr-related" ADR-NNN --format json
- Use
--adr-dir <path> if the project keeps ADRs somewhere other than
docs/adr/.
- Exit code 2 means the id is unknown or the directory is missing; relay
the stderr message and stop.
-
Present the graph readably, not as raw JSON:
ADR-NNN <title> (status, file path)- Outbound: one line per edge,
-> ADR-MMM [kind] <title> (<status>).
Kinds: related, supersedes, superseded-by, amended-by.
- Inbound: one line per edge,
<- ADR-MMM [kind] <title> (<status>).
Inbound also surfaces mention edges: plain ADR-id occurrences outside
any declared relationship.
-
If the dangling list is non-empty, call it out explicitly: these are
references to ADR ids that do not exist in the set. Suggest fixing the
stale link (typo) or restoring the missing ADR; do not fix it yourself in
this skill.
-
One closing sentence of interpretation: e.g. "Nothing depends on this ADR;
superseding it is low-risk" or "Three Accepted ADRs reference this one;
superseding it requires updating their Related Decisions."
Boundaries
- Read-only. Never modify ADRs, statuses, or links during a graph load.
- Matching is whole-token: ADR-043 is never inferred from ADR-0430. Trust the
tool's edges; do not add speculative relationships the files do not state.
- A
mention edge is weak evidence, not a declared dependency. Say so when it
is the only inbound edge.
- If the user wants to act on the graph (supersede, retire), hand off to
/adr-kit:supersede or /adr-kit:retire instead of editing here.
