agdr

Browse, search, show, and aggregate Architecture Decision Records across multiple projects.

489|254|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/me2resh/apexyard --skill agdr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agdr
Source: https://github.com/me2resh/apexyard/tree/main/.claude/skills/agdr
Command: npx skills add https://github.com/me2resh/apexyard --skill agdr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AgDRs are often spread across many projects, making it hard to answer the question Have we decided this before? quickly and consistently.

Core Features & Use Cases

  • Portfolio-wide AgDR discovery: browse, search, show, and get category stats across the entire registered portfolio.
  • Category-aware indexing: reads optional AgDR frontmatter to support stable taxonomy and accurate grouping.
  • Fast onboarding and decision reuse: use category and full-text search to find prior decisions before writing new ones.

Quick Start

Run /agdr search "rate limiting" to find matching AgDRs across all projects and read the relevant passages.

Frequently Asked Questions about agdr

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

FAQPage Schema
How do I search architecture decision records across multiple projects in a portfolio?

To search architecture decision records across a portfolio, use full-text search queries to find matching AgDR markdown content, retrieving grep-style snippets from local directories or via the GitHub API when local files are unavailable.

What is the best way to find previous technical decisions before writing a new software design document?

Finding previous technical decisions before writing a new design document involves querying category-grouped AgDR indices or running full-text searches across registered projects to validate if specific security or architectural choices were already decided.

Can I browse architecture decision records by category across my entire project portfolio?

You can browse architecture decision records by category across a portfolio by parsing optional markdown frontmatter, which provides stable taxonomy and accurate grouping for portfolio-wide category analytics.

How do I retrieve a specific decision record by its exact ID from a multi-project repository?

Retrieving a specific decision record by exact ID from a multi-project repository utilizes the show command, resolving the specific AgDR markdown file from local managed project doc directories or GitHub API endpoints.

Does portfolio-wide decision retrieval work with markdown files stored in remote GitHub repositories?

Portfolio-wide decision retrieval works with remote GitHub repositories by resolving managed project doc directories via the GitHub API when local files are unavailable, ensuring seamless indexing of frontmatter metadata and markdown content.

How do I generate aggregate statistics on architectural decisions across a software portfolio?

Generating aggregate statistics on architectural decisions across a software portfolio uses the stats command to provide category analytics and aggregate counts, with optional JSON output for integration into downstream reporting tools.