skills.rest
specvital
specvitalOFFICIAL
Explore all skills by this author →
GitHub

adr-write

Mine GitHub commits and PRs to draft bilingual ADR documents.

1|Updated Dec 17, 2025
Search Tags:#templates#documentation#research#github#communication#adr
One-click install
npx skills add https://github.com/specvital/specvital.github.io --skill adr-write
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-write
Source: https://github.com/specvital/specvital.github.io/tree/main/.claude/skills/adr-write
Command: npx skills add https://github.com/specvital/specvital.github.io --skill adr-write

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADR writing and context research are manual, time-consuming tasks that slow down documenting architectural decisions. This skill automates the end-to-end ADR workflow by researching GitHub commits/PRs, drafting structured ADRs, and updating index files so teams capture decisions consistently.

Core Features & Use Cases

  • End-to-end ADR drafting: Research context, compare options, and generate both English and Korean ADR documents following the standard template.
  • Multi-Agent Collaboration: Orchestrates specialist input (context research) and product strategy analysis to produce well-justified decisions.
  • Automated Documentation Updates: Bakes ADRs into the repository's docs structure and refreshes navigation indices.

Quick Start

Provide a target ADR candidate (e.g., '1', 'core/1', or a natural-language title) to generate complete ADR documents.

Frequently Asked Questions about adr-write

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

FAQPage Schema
How do I automate ADR drafting from GitHub commit and PR discussions?▼

Automate ADR drafting by mining GitHub commits and PR discussions to identify architectural decisions, compare options, evaluate consequences, and generate bilingual ADR documents following a strict template while updating all index files.

What is the best way to document architectural decisions consistently across platform, core, and worker candidates?▼

Documenting architectural decisions consistently requires researching repository context, performing structured option analysis, and generating standardized bilingual ADR documents that automatically update repository navigation indices.

How do I generate bilingual ADR documents following a standard template?▼

Generate bilingual ADR documents by providing a target ADR candidate like a natural-language title or identifier, which triggers context research and structured option analysis to produce both English and Korean ADR files per template rules.

Can I use GitHub commit history and PR discussions to research context for architectural decision records?▼

GitHub commit history and PR discussions serve as the primary context source for researching architectural decision records, enabling automated mining of related discussions to justify platform, core, and worker ADR candidates.

Does automated ADR generation update repository documentation indices and navigation files?▼

Automated ADR generation updates repository documentation indices and navigation files by baking newly drafted ADRs into the existing docs structure and refreshing all related index files per repository rules.

What are the limitations of automating architectural decision record workflows from repository context?▼

Automating architectural decision record workflows depends on the quality of GitHub commit messages and PR discussions for context, requiring clear repository rules to ensure generated bilingual documents and index updates align with existing documentation structures.

Related Skills

Explore More Content & Communication Skills→
wfvuewfvue
3

configuring-tauri-permissions

Configure Tauri v2 permission controls with allow/deny rules and capability mappings.

Community
Advanced
liuminxin45liuminxin45
95

speckit-knowledge-bootstrap

Bootstrap a workspace knowledge base from repository inventory and review artifacts.

Community
Advanced
CharGrnmnCharGrnmn
1

gpd-explain

Explain physics concepts with project-specific context and citations.

Community
Advanced
yoshihiko555yoshihiko555

decision-log

Create and update ADR/DECISIONS entries from conversation history and code diffs.

Community
Intermediate