skills.rest
tiberius-s
tiberius-sCOMMUNITY
Explore all skills by this author →
GitHub

adr

Generate Nygard-style Architecture Decision Records with structured frontmatter.

Updated Feb 15, 2026
Search Tags:#workflow#architecture#documentation#adr#governance#software-engineering#decision-record
One-click install
npx skills add https://github.com/tiberius-s/fireside --skill adr-tiberius-s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/tiberius-s/fireside/tree/main/.github/skills/adr
Command: npx skills add https://github.com/tiberius-s/fireside --skill adr-tiberius-s

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fireside projects need durable documentation of significant architectural decisions to ensure long-term traceability, governance, and cross-crate consistency.

Core Features & Use Cases

  • Templated ADRs: Create consistent, Nygard-style ADR documents with frontmatter and structured sections.
  • Decision traceability: Capture deciders, dates, contexts, decisions, and consequences for auditable history.
  • Workspace governance: Apply ADR workflows to major crate changes, infrastructure decisions, and policy updates across the project.

Quick Start

Create a new ADR document following the ADR format for the architectural decision you are documenting.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I document architectural decisions for long-term traceability?▼

Architecture Decision Records (ADRs) provide durable documentation of significant architectural choices by capturing deciders, dates, contexts, decisions, and consequences. This ensures long-term traceability and auditable history for infrastructure and governance changes.

What is the best way to structure ADR governance documents for software engineering?▼

Using a Nygard-style ADR template enforces consistent file structure and frontmatter for decision records. This standardizes architectural choices, infrastructure decisions, and governance changes for easy discovery and audit across software engineering projects.

How do I create an Architecture Decision Record for infrastructure decisions and crate selections?▼

Generate a templated ADR document with structured sections and frontmatter to capture the context, decision, and consequences for your infrastructure decisions and crate selections. This enforces a consistent file structure for easy discovery and audit.

Can I use ADRs for workspace governance and policy updates across multiple crates?▼

Yes, you can apply ADR workflows to major crate changes, infrastructure decisions, and policy updates for workspace governance. This ensures cross-crate consistency and durable documentation of significant architectural choices across the project.

Do I need any dependencies to generate Nygard-style ADR documents?▼

No dependencies are required to generate Nygard-style ADR documents. The skill independently enforces ADR frontmatter and consistent file structure for architectural decision records without needing external tools or libraries.

Related Skills

Explore More Software Engineering Skills→
RogerioSobrinhoRogerioSobrinho

architecture-decision-records

Document architectural decisions as ADRs with context, alternatives, and rationale.

Community
Advanced
xenitV1xenitV1
132

architecture

Systematize requirements analysis and ADR documentation for architecture decisions.

Community
Basic
aurora-atomsaurora-atoms

pr-ready-package

Synthesize code diffs, delivery evidence, and project context into a structured pull request package.

Community
Advanced
paulokakomapaulokakoma

create-adr

Generate Architecture Decision Records in MADR, Nygard, and Y-Statement formats.

Community
Advanced