Can I customize the ADR template used by this skill?

Yes, the skill utilizes a template located in the project's plugin directory, allowing you to modify the structure to fit your specific organizational standards.

An Architecture Decision Record (ADR) is a document that captures an important architectural decision made along with its context and consequences, helping teams understand the 'why' behind the current state of a system.

How does this skill handle ADR numbering?

The skill uses specific ranges to organize decisions: 0001-0999 for infrastructure, 2000-2999 for features, and 3000-3999 for processes, automatically incrementing the ID based on existing files.

Does it integrate with documentation websites?

Yes, the skill automatically updates the VitePress configuration file to ensure new ADRs are immediately visible in your project's documentation sidebar.

What lifecycle statuses are supported?

It tracks decisions through a complete workflow: draft, proposed, admitted, applied, implemented, tested, rejected, and canceled.

SecondBrain ADR Manager

Name: SecondBrain ADR Manager
Author: sergio-bershadsky

bysergio-bershadsky

•

学习与文档

Automates the creation and management of Architecture Decision Records (ADRs) with standardized numbering, templates, and status tracking.

The SecondBrain ADR skill streamlines technical documentation by enabling developers to generate and organize Architecture Decision Records directly within the Claude Code environment. It implements a structured workflow for gathering context, assigning category-based numbering (infrastructure, feature, or process), and managing the lifecycle of decisions from draft to implementation. By integrating with VitePress and YAML-based tracking, it ensures that project decisions are searchable, version-controlled, and consistently formatted according to industry best practices.

主要功能

01Category-based automated numbering for infrastructure, features, and processes

02Centralized YAML record tracking for decision metadata

033 GitHub stars

04Standardized Markdown templates for consistent technical documentation

05Automatic VitePress sidebar integration for documentation sites

06Comprehensive status workflow from draft to production-tested

使用场景

01Documenting the rationale behind migrating to new database architectures or frameworks

02Tracking internal process changes and architectural standards across a development team

03Maintaining a historical log of feature implementation decisions for future audits and onboarding

主要功能

01Category-based automated numbering for infrastructure, features, and processes

02Centralized YAML record tracking for decision metadata

033 GitHub stars

04Standardized Markdown templates for consistent technical documentation

05Automatic VitePress sidebar integration for documentation sites

06Comprehensive status workflow from draft to production-tested

使用场景

01Documenting the rationale behind migrating to new database architectures or frameworks

02Tracking internal process changes and architectural standards across a development team

03Maintaining a historical log of feature implementation decisions for future audits and onboarding