File-level at the top of any file matched by a record's applies-to globs.
Symbol-level on any line carrying an inline // dl:adr 0042 anchor.
Hover — a rich tooltip (status, deciders, summary, open link) on an inline anchor.
Link Selection to Decision Record — inserts a language-aware anchor comment above the
current line, so precise links move with the code through refactors.
Diagnostics (Problems panel) — warns about dangling anchors (dl:adr pointing at a missing
record) and code governed by a superseded/deprecated record.
Read view — a themed webview rendering the record with its status, metadata, and a clickable
supersedes/superseded-by chain.
Full-text search across id, title, tags, deciders, and body.
Decisions view in the activity bar — every record grouped by status.
Status bar count of decisions governing the active file.
Commands: New Decision Record (from template), Open Decision Record, Show Decisions for This
File, Link Selection to Decision Record, Search Decision Records, Open Preview.
Records are MADR-style markdown files in docs/adr/ (configurable). Markdown is the only source of
truth; the extension keeps a disposable in-memory index warmed by a file watcher.
Linking code to a decision
Two complementary mechanisms:
applies-to globs (in the record) — coarse, file/folder level, zero code changes.
Inline anchors (in the code) — // dl:adr 0042 above a symbol; precise and refactor-proof.
Use Link Selection to Decision Record from the editor context menu to insert one.