How do I change the status of a decision?

The workflow allows you to update the status field in the ADR markdown file from Proposed to Accepted, Deprecated, or Superseded as the project evolves.

An Architecture Decision Record (ADR) is a document that captures a significant architectural decision, including the context in which it was made and the consequences it has for the project.

Where are the ADR files stored?

This skill follows a standard convention of storing ADR files in the docs/adr/ directory of your repository.

Why should I use this skill instead of manual documentation?

The ADR Generator ensures consistency in format, forces the consideration of alternatives and consequences, and automates the boilerplate creation process, making documentation a natural part of the dev workflow.

ADR Generator

Name: ADR Generator
Author: HomericIntelligence

byHomericIntelligence

•

Learning & Documentation

Generates and manages Architecture Decision Records (ADRs) to document significant technical choices and their rationale.

The doc-generate-adr skill streamlines the process of capturing critical architectural decisions within a project's repository. By providing a standardized template and automated creation workflow, it ensures that technical trade-offs, rationale, and consequences are consistently recorded for future reference. This skill is essential for engineering teams looking to maintain a historical record of system design evolutions, facilitate smoother developer onboarding, and ensure that every major technical choice is backed by evidence and documented alternatives.

Key Features

01Automated ADR file generation using a standardized markdown template

02Lifecycle management for decision statuses including Proposed and Accepted

0314 GitHub stars

04Structured capture of context, rationale, and positive/negative consequences

05Comparison framework for documenting and justifying technical alternatives

06Centralized documentation management within the project's directory structure

Use Cases

01Documenting the rationale for selecting specific programming languages or frameworks

02Maintaining a searchable history of architectural pivots for stakeholders and new hires

03Recording trade-offs and consequences during major system migrations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add homericintelligence/projectodyssey doc-generate-adr

For use in Claude.ai and ChatGPT

Download Skill