Can the skill help me if I'm unsure about the consequences of a decision?

Absolutely. The workflow includes a research step where Claude can use tools to investigate alternatives and synthesize trade-offs before you finalize the document.

What is the difference between an ADR and a DES in this skill?

ADRs (Architecture Decision Records) are for high-impact, hard-to-change choices like technology selections. DES (Design Patterns) are for repeatable coding conventions and cross-cutting concerns used throughout the codebase.

Does this skill automatically update my documentation folder?

Yes, it writes files to docs/architecture/ or docs/design/ and automatically updates the corresponding README indexes to keep your documentation organized.

What is the 'decision-reviewer' mentioned in the process?

It is a specialized subagent that silently validates your draft to ensure the classification is correct and the decision isn't too trivial or redundant compared to existing records.

Katachi Decision Architect

Name: Katachi Decision Architect
Author: asermax

byasermax

•

Aprendizaje y Documentación

Facilitates structured documentation of architectural decisions and design patterns within a codebase.

The Katachi Decision skill provides a rigorous, guided workflow for capturing and managing Architecture Decision Records (ADRs) and Design Patterns (DES). It assists developers in distinguishing between high-impact architectural choices and repeatable design patterns, ensuring every decision is backed by context, rationale, and a consideration of alternatives. By automatically updating central indexes and cross-referencing affected feature documentation, it helps maintain a clear, searchable history of technical evolution within a project.

Características Principales

01Centralized management of decision IDs and project READMEs

02Guided ADR and DES template generation and drafting

031 GitHub stars

04Research assistance for weighing technical alternatives and trade-offs

05Automatic indexing and cross-referencing with feature specifications

06Intelligent classification validation via specialized subagents

Casos de Uso

01Formally documenting the selection of a new framework or system architecture

02Maintaining a historical record of technical trade-offs for future auditability

03Establishing and enforcing repeatable coding patterns across a repository

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add asermax/claude-plugins decision

For use in Claude.ai and ChatGPT

Download Skill