skills.rest
yattom
yattomCOMMUNITY
Explore all skills by this author →
GitHub

manage-adr

Create, edit, and index Architecture Decision Records with automatic numbering and metadata validation.

Updated Aug 23, 2026
Search Tags:#automation#architecture#versioning#adr#search#docs/adr
One-click install
npx skills add https://github.com/yattom/timtam --skill manage-adr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: manage-adr
Source: https://github.com/yattom/timtam/tree/main/.claude/skills/manage-adr
Command: npx skills add https://github.com/yattom/timtam --skill manage-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? Architecture Decision Records (ADRs)を docs/ adr/内で管理します。新しいADRの作成、既存ADRの編集、 ADR索引の確認を行います。番号の自動採番、プロジェクト固有のフォーマット（日本語、メタデータ構造）を遵守します。

## Core Features & Use Cases

  • 自動採番とファイル命名規則の適用: ADRのファイル名とメタデータを自動で整え、追跡を容易にします。
  • 作成・編集・検索: ADRの追加・更新・検索・参照をサポートします。
  • ** ADR索引の確認**: ADR一覧を表示し、関連 ADR へのリンクを提供します。

### Quick Start 新しい ADR を docs/adr/ に追加し、 ADR テンプレートを適用して ADR 001X の形式で保存してください。

Frequently Asked Questions about manage-adr

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

FAQPage Schema
How do I manage Architecture Decision Records in a project?▼

Architecture Decision Records organize design decisions in a structured format within docs/adr/. This Skill automates ADR creation, editing, and indexing with automatic numbering, enforces metadata validation (Status, Date, Owners), and maintains kebab-case filenames and required sections (Background/Context, Decision, Consequences, References) for consistent tracking across your codebase.

Can I automate ADR numbering and file naming conventions?▼

Yes. This Skill applies automatic sequential numbering in NNNN format, enforces kebab-case filenames, and validates metadata structure, eliminating manual formatting work and ensuring consistent ADR organization across docs/adr/ without manual renaming.

How do I create and edit ADRs while maintaining project standards?▼

The Skill provides template-based ADR creation that enforces your project's format requirements including required sections, metadata fields, and cross-file references. It supports Read, Edit, Glob, and Grep operations to create new records, modify existing ones, and maintain referential integrity within your ADR collection.

What's the best way to search and index Architecture Decision Records?▼

This Skill generates searchable ADR indexes and supports Grep operations across all docs/adr/ files, enabling you to quickly locate decisions, trace their history, and discover related ADRs through cross-file reference links within your index.

Do I need to manually validate ADR metadata and folder structure?▼

No. The Skill enforces automatic metadata validation including Status, Date, and Owners fields, validates the docs/adr/ folder layout, and applies the ADR template, catching structural issues during creation or editing rather than requiring manual reviews.

Can this work with project-specific ADR formats like Japanese documentation?▼

Yes. The Skill adapts to project-specific formatting requirements including language preferences and custom metadata structures, automatically applying your project's ADR conventions while maintaining searchability and cross-reference support.

Related Skills

Explore More Software Engineering Skills→
s3nex-coms3nex-com

architecture-decision-records

Create and manage Architecture Decision Records with a templated format.

Community
Advanced
sunLeeesunLeee

doc-adr

Generate Architecture Decision Records using the Y-statement template.

Community
Advanced
ImLpImLp

adr

Generate ADR files in wiki/adrs/ with context, decision, and consequences.

Community
Advanced
BuiDommBuiDomm

wiki

Manage persistent markdown-based project wikis with CRUD operations and keyword search.

Community
Advanced