refs

Sync local reference repositories and search them with ripgrep.

1|1|Updated Jan 25, 2026

Search Tags:#planning #reference #catalog #sync #design decisions #awesome lists

Ready to run

npx skills add https://github.com/45ck/claude-sdlc-plugin --skill refs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: refs
Source: https://github.com/45ck/claude-sdlc-plugin/tree/main/skills/refs
Command: npx skills add https://github.com/45ck/claude-sdlc-plugin --skill refs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill syncs and searches local reference repositories to support planning and design decisions.

Core Features & Use Cases

Sync local reference repos from curated awesome-* lists to keep planning materials up to date.
Search and filter references quickly using ripgrep against the local seeds and repos.
Build a lightweight catalog of seeds from the local references to speed discovery during SDLC planning.

Quick Start

Use the skill to sync and range through references. Run the sync script to refresh seeds, then build and search the catalog:

${CLAUDE_PLUGIN_ROOT}/scripts/awesome/sync.sh
${CLAUDE_PLUGIN_ROOT}/scripts/awesome/catalog.py build
rg -n "architecture|ADR|design" "${CLAUDE_PLUGIN_ROOT}/references/awesome/repos"

Frequently Asked Questions about refs

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

FAQPage Schema

How do I sync local reference repos for architecture decisions and ADRs?▼

You can sync local reference repos for architecture decisions by running the sync.sh script, which refreshes curated awesome-* lists to keep your planning materials updated.

What is the best way to search curated awesome lists for design references during SDLC planning?▼

The best way to search curated awesome lists for design references is using ripgrep against the local seeds and repos to quickly locate relevant architecture materials.

How do I build a catalog of seeds from local references to speed up discovery?▼

You build a catalog of seeds from local references by executing the catalog.py build script, which creates a lightweight index to speed discovery during SDLC planning.

Do I need Bash and Python tooling to use local reference repositories for planning?▼

Yes, you need Bash and Python tooling to run the sync and catalog scripts, along with the CLAUDE_PLUGIN_ROOT environment variable configured for script execution.

Can I use ripgrep to filter local reference repositories for specific design decisions?▼

Yes, you can use ripgrep to filter local reference repositories by running targeted searches, such as querying for architecture, ADR, or design keywords across the repos directory.