# Adr Context

> Load relevant ADRs from docs/adr/ into context. Read-only

- **Type:** Skill
- **Install:** `agentstack add skill-qgolem-orc-adr-context`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [qGolem](https://agentstack.voostack.com/s/qgolem)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [qGolem](https://github.com/qGolem)
- **Source:** https://github.com/qGolem/orc/tree/main/skills/adr-context

## Install

```sh
agentstack add skill-qgolem-orc-adr-context
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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
```bash
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](https://github.com/qGolem)
- **Source:** [qGolem/orc](https://github.com/qGolem/orc)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-qgolem-orc-adr-context
- Seller: https://agentstack.voostack.com/s/qgolem
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.