Why does it generate documents in two languages?

The skill is designed for global teams, specifically supporting English and Korean to maintain a synchronized bilingual documentation hub.

What is the primary purpose of the adr-write skill?

It automates the creation of Architectural Decision Records (ADRs) by researching your project's GitHub history to find the 'why' behind technical choices.

Does it update my documentation site automatically?

Yes, after writing the ADR files, it updates index.md files, category overviews, and the Vitepress sidebar configuration (config.mts) to ensure the new record is linked correctly.

Can I target specific repositories?

Yes, you can specify 'Platform Level' ADRs or repository-specific ADRs (like Core, Worker, or Web) using numeric or natural language arguments.

How does it find information for the ADR?

It uses the specvital-specialist agent to search GitHub commits and PRs from the last 90 days, extracting problem statements, approaches, and alternatives discussed by developers.

ADR Automated Writer

Name: ADR Automated Writer
Author: specvital

byspecvital

•

Learning & Documentation

Generates comprehensive Architectural Decision Records by researching GitHub history and applying bilingual templates.

The adr-write skill automates the labor-intensive process of documenting architectural choices by leveraging GitHub context. It uses a multi-agent pipeline to search through commits and pull requests, extracting the original rationale and constraints behind a decision. The skill then synthesizes this into a standardized ADR format, producing synchronized versions in both English and Korean. Beyond simple writing, it handles the maintenance overhead by automatically updating repository index files and Vitepress sidebar configurations to ensure new documentation is immediately discoverable.

Key Features

01Multi-agent trade-off analysis for objective decision mapping

021 GitHub stars

03Automatic index and sidebar navigation synchronization

04Automated GitHub context research via commit and PR history

05Strict adherence to technical noun-ending styles for Korean documentation

06Bilingual output generation in English and Korean

Use Cases

01Maintaining a centralized documentation hub for multi-repository projects

02Standardizing the ADR process for distributed, bilingual engineering teams

03Formalizing legacy architectural decisions from existing commit history

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add specvital/specvital.github.io adr-write

For use in Claude.ai and ChatGPT

Download Skill