skills.rest
sergio-bershadsky
sergio-bershadskyCOMMUNITY
Explore all skills by this author →
GitHub

secondbrain-adr

Create Architecture Decision Records with category-based numbering and index updates.

15|Updated Dec 21, 2025
Search Tags:#architecture#templates#documentation#adr#decision#governance#records
One-click install
npx skills add https://github.com/sergio-bershadsky/ai --skill secondbrain-adr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: secondbrain-adr
Source: https://github.com/sergio-bershadsky/ai/tree/main/plugins/secondbrain/skills/secondbrain-adr
Command: npx skills add https://github.com/sergio-bershadsky/ai --skill secondbrain-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

ADRs enable teams to capture and track architectural decisions with consistent numbering, categorization, and a centralized index.

Core Features & Use Cases

  • Generate category-scoped ADR numbers (ADR-XXXX) based on selected category
  • Create ADR documents from a template with frontmatter and content
  • Update central records.yaml and ADR index to reflect new decisions and ensure traceability

Quick Start

Create a new ADR by selecting a category, providing a title and context, and let the system generate the ADR file and update the records.

Frequently Asked Questions about secondbrain-adr

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

FAQPage Schema
How do I automate Architecture Decision Records creation with consistent numbering?▼

You can automate Architecture Decision Records by generating category-scoped ADR numbers, creating documents from templates with frontmatter, and updating a central records.yaml index to ensure traceability.

What is an ADR index and how does categorization work?▼

An ADR index is a centralized records.yaml file tracking architectural decisions. Categorization assigns category-based numbering (ADR-XXXX) to organize and scope decisions within defined ranges.

How do I create a new ADR document from a template?▼

Create a new ADR document by selecting a category, providing a title and context, and letting the system generate the file from an ADR template complete with required frontmatter and content metadata.

Do I need a records.yaml file to start documenting architectural decisions?▼

Yes, you need a records.yaml file alongside ADR templates and defined category ranges to generate valid file paths, update metadata, and maintain the central index for decision traceability.

What is the best way to maintain traceability for technical decisions across a team?▼

Maintain traceability by using a centralized records.yaml index that automatically updates with new decisions, ensuring consistent numbering, categorization, and version tracking for architectural records.

Can I use custom templates for Architecture Decision Records?▼

Yes, the system creates ADR documents from template-based content, allowing custom templates that include necessary frontmatter and structure to document technical decisions effectively.

Related Skills

Explore More Software Engineering Skills→
cliveportmancliveportman
1

docs-conventions

Define and enforce documentation conventions for the docs/ directory.

Community
Intermediate
zoraxlzoraxl
3

wiki-query

Retrieves and synthesizes documentation, architecture decisions, and runbooks from a Markdown wiki repository.

Community
Intermediate
MoffranMoffran
78

ce-payload-governance

Validate explanation payload schemas and provenance against ADR-005 and ADR-028 invariants.

Community
Advanced
a53alia53ali

architecture-decision-record

Write, update, and query Architecture Decision Records using Markdown templates.

Community
Intermediate