create-adr

Name: create-adr
Availability: InStock
Author: bbolek-ap

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

Ready to run

npx skills add https://github.com/bbolek-ap/new-ai-native --skill create-adr-bbolek-ap

💬 Prompt for ChatGPT / Claude Chat▼

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.