skills.rest
bbolek-ap
bbolek-apCOMMUNITY
Explore all skills by this author →
GitHub

create-adr

Record and manage Architecture Decision Records in .project/adr with deterministic numbering.

Updated Apr 29, 2026
Search Tags:#architecture#versioning#documentation#adr#lifecycle#project-management
One-click install
npx skills add https://github.com/bbolek-ap/new-ai-native --skill create-adr-bbolek-ap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-adr
Source: https://github.com/bbolek-ap/new-ai-native/tree/main/.claude/skills/create-adr
Command: npx skills add https://github.com/bbolek-ap/new-ai-native --skill create-adr-bbolek-ap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Record and manage Architecture Decision Records (ADRs) in .project/adr with deterministic numbering.

Core Features & Use Cases

  • Create ADRs with standardized structure in the correct folder
  • Update statuses and move ADRs between accepted/proposed/conflict/gap/deprecated/superseded
  • Maintain an index file at .project/adr/_index.md to enable fast search and traceability.

Quick Start

Log a new ADR with the decision details and let the system store it in the correct .project/adr location and update the index.

Frequently Asked Questions about create-adr

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

FAQPage Schema
How do I create Architecture Decision Records with standardized numbering?▼

Architecture Decision Records are created in the `.project/adr` directory with deterministic numbering. The system applies a standardized structure and stores records in status-specific folders like accepted, proposed, or conflict.

What is the ADR lifecycle and how are statuses managed?▼

The ADR lifecycle enforces rules for moving records between accepted, proposed, conflict, gap, deprecated, and superseded statuses. Updating a status moves the ADR file to the corresponding folder and updates the central index.

How do I maintain an ADR index for fast search and traceability?▼

An ADR index is maintained automatically at `.project/adr/_index.md`. It updates whenever a new Architecture Decision Record is created or an existing record's status changes, enabling fast search and traceability.

What types of project decisions should be tracked as ADRs?▼

ADRs should track architectural decisions including technology choices, integration approaches, scope boundaries, and vendor selections. These decisions are recorded across active projects to maintain a clear historical context.

Can I use this ADR system for any active software project?▼

Yes, the ADR system applies to decisions across active projects. It requires no external dependencies and organizes records directly within the project's local `.project/adr` directory structure.

Related Skills

Explore More Software Engineering Skills→
peelpeel
3

adr

Generate numbered Architecture Decision Records as Markdown files.

Community
Basic
aifuunaifuun

manage-adr

Create, list, show, and validate ADR files with TL;DR format and YAML metadata.

Community
Advanced
JaveedIshaqJaveedIshaq
1

wip-lifecycle-manager

Create, track, review, and archive work-in-progress documentation with a standardized template.

Community
Intermediate
AgentientAgentient
2

architectural-decision-records

Automate architectural decision documentation with standard ADR templates and lifecycle statuses.

Official
Intermediate