document-decisions

What problem does it solve? Architectural decisions made during development often go undocumented, leaving teams without a record of why key design choices were made. This Skill inspects uncommitted git changes, detects decisions that warrant Architecture Decision Records, and drafts ADR files with minimal user input. ## Core Features & Use Cases - Change Analysis: Runs git diff to categorize modified files by architectural area such as interfaces, entities, configuration, and authentication. - Decision Detection: Applies confidence-ranked heuristics to flag new abstractions, schema changes, dependencies, and patterns worth documenting. - Context Inference: Reads source code, related files, and existing ADRs to draft most of each ADR automatically, asking only for non-inferable context. - Use Case: After implementing a new base command class and a database entity, run this Skill to review the changes, confirm which decisions matter, and produce properly numbered ADR files in the decisions folder. ## Quick Start Analyze my uncommitted git changes and create ADRs for any architectural decisions you find.