hex-adr-search

Search Architecture Decision Records by keyword, status, or date.

4|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/gaberger/hex --skill hex-adr-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hex-adr-search
Source: https://github.com/gaberger/hex/tree/main/.claude/skills/hex-adr-search
Command: npx skills add https://github.com/gaberger/hex --skill hex-adr-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly locate Architecture Decision Records (ADRs) by keyword, status, or date to reduce time spent manually browsing documentation.

Core Features & Use Cases

  • Search ADRs by keyword across docs/adrs/
  • Filter ADRs by status or date to focus on relevant decisions
  • Display ADR metadata including number, title, status, and context snippets

Quick Start

Ask for your search term and run hex adr search across docs/adrs/ to retrieve matching ADRs.

Frequently Asked Questions about hex-adr-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Architecture Decision Records by keyword or status?

Search Architecture Decision Records by providing a keyword, status, or date to filter and retrieve matching ADR metadata including number, title, and context snippets from the docs/adrs/ directory. It uses grep-like search capabilities to quickly locate relevant design decisions.

What is the best way to find specific ADRs across a large documentation repository?

The best way to find specific ADRs is to run a targeted keyword, status, or date search across the docs/adrs/ repository. This approach displays matching ADR metadata and context snippets, reducing time spent manually browsing documentation.

Can I filter Architecture Decision Records by date to focus on recent design decisions?

Yes, you can filter Architecture Decision Records by date to focus on relevant decisions. The search functionality supports filtering by date, status, or keyword across the docs/adrs/ repository to quickly locate specific design contexts.

Do I need a specific directory structure to search ADRs with grep?

Yes, you need ADR files stored under the docs/adrs/ directory structure. The search relies on basic grep-like capabilities to scan this specific repository location to retrieve matching Architecture Decision Records.

What metadata is displayed when searching for Architecture Decision Records?

Searching for Architecture Decision Records displays ADR metadata including the decision number, title, status, and context snippets. This provides quick access to design decisions and their surrounding context without opening individual files.