wolf-adr

Index Architecture Decision Records across development phases for topic-based search.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Nice-Wolf-Studio/wolf-skills-marketplace --skill wolf-adr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wolf-adr
Source: https://github.com/Nice-Wolf-Studio/wolf-skills-marketplace/tree/main/wolf-adr
Command: npx skills add https://github.com/Nice-Wolf-Studio/wolf-skills-marketplace --skill wolf-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Without a centralized, searchable record of architectural decisions, teams risk repeating past debates, making inconsistent choices, or implementing solutions that conflict with established patterns. This Skill provides an indexed and searchable repository of over 120 Architecture Decision Records (ADRs), ensuring historical context and consistent decision-making.

Core Features & Use Cases

  • Searchable ADR Index: Easily find relevant ADRs by topic (e.g., MCP Server Architecture, CI/CD, Security), development phase, or keywords, saving time on research.
  • Comprehensive Decision Context: Each ADR captures the problem, decision, consequences (positive and negative), and alternatives considered, providing full historical context for every critical choice.
  • Mandatory ADR Creation Guidance: Clearly defines when ADRs are REQUIRED (e.g., architectural changes, process changes, tool selections) versus optional, preventing undocumented critical decisions and ensuring governance.
  • Living Architecture Snapshot: Access the most current synthesis of Wolf's architecture, integrating decisions from all phases into a single, up-to-date view for quick understanding.
  • Use Case: Before proposing a new CI/CD workflow, an AI agent can use this Skill to search for "GitHub Actions Workflow Standards" and discover ADR-072, which mandates specific patterns to prevent common failures, saving hours of debugging and rework by leveraging past decisions.

Quick Start

Use the wolf-adr skill to find Architecture Decision Records related to "GitHub Actions Workflow Standards".

Frequently Asked Questions about wolf-adr

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

FAQPage Schema
How do I find architectural decisions related to a specific system design problem?

Architecture Decision Records (ADRs) index critical choices across 120+ documented decisions. Search by topic, development phase, or keywords to retrieve the full context—problem, decision, consequences, and alternatives—for any architectural choice, saving time on research and preventing rework.

When should I create a new Architecture Decision Record?

ADRs are mandatory for architectural changes, process changes, and tool selections. The Skill clarifies when ADR creation is required versus optional, ensuring governance and preventing undocumented critical decisions that could cause inconsistent choices or repeated debates.

Can I access the current state of the system architecture in one place?

The living architecture snapshot synthesizes decisions from all development phases into a single, up-to-date view. This integrated snapshot enables quick understanding of how past architectural decisions shaped the current system design without navigating multiple records.

How do I avoid repeating past architectural mistakes or conflicting decisions?

A searchable, centralized ADR repository captures the context and consequences of each architectural choice made across 50+ development phases. Consulting the indexed records before proposing changes ensures decisions align with established patterns and prevents rework from conflicting implementations.

What information does each Architecture Decision Record contain?

Each ADR exposes metadata including context, the decision made, positive and negative consequences, status, related ADRs, and file locations in the docs/adr paths. This comprehensive metadata provides the historical context needed for efficient retrieval and understanding downstream dependencies.