Adr Context

ADR Context Loader

Load relevant architectural decisions from docs/adr/ before implementing or verifying tasks.

Process

1. List all ADRs — Glob docs/adr/**/*.md
2. Extract metadata — Read title (# ADR-XXX: ...) and status line from each file
3. Filter by topic — Identify ADRs relevant to the caller's task topic (passed as $ARGUMENTS)
4. Load relevant ADRs — Read full content of matching ADRs
5. Output summary — Report which ADRs apply, their decisions, and constraints to respect

Implementation Steps

Step 1: Discover all ADRs

Glob pattern: docs/adr/**/*.md

Step 2: Read metadata

For each ADR file:

• Read the first line containing # ADR-XXX: to extract title
• Read the ## Status section to determine status (Accepted, Rejected, Superseded, etc.)

Step 3: Filter by relevance

Given the task topic from $ARGUMENTS, identify ADRs that match by:

• Title keywords (e.g., "auth" matches "Authentication system architecture")
• Filename patterns (e.g., ADR-001-*.md)
• Status (only include Accepted or superseded-but-still-relevant ones)

Step 4: Load and return content

For each relevant ADR:

• Read the full file
• Include in output summary

Step 5: Output summary format

## Relevant ADRs for [task topic]

### ADR-XXX: [Title]
- **Status**: [Accepted/Superseded]
- **Key Decision**: [one-liner]
- **Constraints to respect**:
  - Constraint 1
  - Constraint 2
- **Full decision context**: [excerpt or link]

---

### Constraints Summary
- [List all constraints from all ADRs]

Example

If task topic is "auth", and docs/adr/ contains:

• ADR-001-authentication-strategy.md → MATCH
• ADR-002-database-schema.md → no match
• ADR-003-oauth-provider-selection.md → MATCH

Output would include ADR-001 and ADR-003 with their decisions and constraints.

Output to Caller

Return the summary to the caller's context so they can see:

• Which ADRs apply to their task
• What architectural decisions have been made
• What constraints must be respected during implementation/verification

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: qGolem
• Source: qGolem/orc
• License: MIT

Install and usage instructions live in the source repository linked above.