What is the role of the create-adr-agent?

Once triggered, the skill dispatches to this sub-agent to handle the full interactive workflow, including prompts, template population, and file indexing.

How does the ADR Guide know when to suggest a record?

The skill monitors for specific trigger phrases like 'should we use' or 'decision between' and analyzes the context of your architectural discussions.

Does this skill work with Git?

Yes, the creation workflow includes handling git metadata to ensure your documentation is properly versioned alongside your code.

Can I customize the ADR template used?

The guide follows a standardized 7-phase workflow to ensure institutional memory is captured consistently across all project decisions.

ADR Architecture Guide

Name: ADR Architecture Guide
Author: technomensch

bytechnomensch

•

学習とドキュメンテーション

Automates the creation of Architecture Decision Records (ADRs) by detecting technical decision points within conversations.

The ADR Architecture Guide helps teams maintain institutional memory by proactively identifying moments when critical technical decisions are being made. By monitoring for keywords related to architectural choices, it suggests creating an Architecture Decision Record (ADR) and dispatches a specialized agent to lead you through a structured 7-phase creation process. This ensures that every major design choice is documented with consistent templates, numbering, and git metadata, preventing documentation debt and keeping your team aligned on the reasoning behind your codebase's evolution.

主な機能

01Automated detection of architectural decision points in chat

02Smart title pre-filling based on discussion context

03Automatic git metadata and index management

04Interactive 7-phase ADR creation wizard

05Standardized documentation templates for technical choices

064 GitHub stars

ユースケース

01Tracking technical tradeoffs when selecting new libraries or frameworks

02Documenting the rationale behind switching database engines

03Capturing design patterns chosen during a system redesign

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add technomensch/knowledge-graph adr-guide

For use in Claude.ai and ChatGPT

主な機能

01Automated detection of architectural decision points in chat

02Smart title pre-filling based on discussion context

03Automatic git metadata and index management

04Interactive 7-phase ADR creation wizard

05Standardized documentation templates for technical choices

064 GitHub stars

ユースケース

01Tracking technical tradeoffs when selecting new libraries or frameworks

02Documenting the rationale behind switching database engines

03Capturing design patterns chosen during a system redesign

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add technomensch/knowledge-graph adr-guide

For use in Claude.ai and ChatGPT