skills.rest
MohamedSayedK
MohamedSayedKCOMMUNITY
Explore all skills by this author →
GitHub

adr-index

Query and search Architecture Decision Records stored in a project's ADR folder.

Updated Jun 2, 2026
Search Tags:#documentation#markdown#adr#search#query#architecture decisions#decision records
One-click install
npx skills add https://github.com/MohamedSayedK/omnigrid --skill adr-index-mohamedsayedk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-index
Source: https://github.com/MohamedSayedK/omnigrid/tree/main/assets/core/skills/adr-index
Command: npx skills add https://github.com/MohamedSayedK/omnigrid --skill adr-index-mohamedsayedk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before starting a new architecture decision, teams often re-litigate choices that were already settled. This Skill answers "did we already decide this?" by reading the project's ADR library, preventing duplicate or conflicting decisions. ## Core Features & Use Cases - Browse and Search ADRs: List all ADRs grouped by category, or run full-text search across titles and bodies to find prior decisions on a topic. - Inspect Individual Records: Print any ADR in full by ID, slug, or filename, and view per-category statistics with an optional JSON output. - Use Case: Before drafting a new authentication design, run a search for "auth" to surface the existing ADR mandating OAuth 2 + PKCE, so the new work builds on the settled decision instead of reopening it. ## Quick Start Ask the assistant to search the project's ADR library for any prior decisions about your topic, for example "search ADRs for authentication".

Frequently Asked Questions about adr-index

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

FAQPage Schema
How do I check if an architecture decision was already made?▼

Run a full-text search across the ADR library with the search subcommand and your topic term. It scans titles and bodies of all ADR files and returns matching paragraphs, so you can see the prior decision before starting new design work.

How do I list all Architecture Decision Records in a project?▼

Use the browse subcommand to list every ADR grouped by category, sorted by ID. It reads Markdown files matching ADR-*.md from the project's adr folder and buckets records without category frontmatter under other.

What happens if the ADR folder does not exist?▼

The skill reports that no prior decisions were found and exits cleanly without errors. The same clean-exit behavior applies when the folder exists but contains no ADR files.

Can this tool create or edit ADR files?▼

No, it is strictly read-only and never modifies any ADR file. To record a new decision, use the companion decide skill, which writes ADRs that this skill then reads.

How are ADRs without frontmatter categorized?▼

ADRs missing frontmatter or with malformed frontmatter are still indexed and bucketed under the other category. The browse output adds a migration nudge suggesting you add category frontmatter to those files.

Related Skills

Explore More Software Engineering Skills→
amak07amak07

create-adr

Generate MADR-format Architecture Decision Records with sequential numbering and YAML frontmatter.

Community
Intermediate
Codagent-AICodagent-AI
30

design

Convert settled software requirements into approved technical design artifacts.

Official
Advanced
juanandresgsjuanandresgs
191

uplevel

Audit repository health across security, documentation, code quality, testing, and standards.

Community
Advanced
cosmoscaliburcosmoscalibur
1

ast-grep

Search codebases structurally using AST patterns via ast-grep.

Community
Advanced