Suggests documenting significant architectural decisions as ADRs to capture technical context and reasoning.
The ADR Suggestion Skill helps developers maintain a high-quality documentation trail by identifying when significant architectural changes occur in a project. It monitors for events such as framework migrations, the introduction of new design patterns, or major refactors, and prompts the user to record the decision-making process. By capturing the 'why' behind complex technical choices, this skill ensures that future maintainers understand the trade-offs and constraints involved in the system's evolution.
主な機能
01Identifies significant framework or dependency additions
02Supports infrastructure decision tracking for databases and queues
030 GitHub stars
04Detects high-impact architectural shifts and pattern changes
05Prompts for documentation after major API or interface breaking changes
06Integrates with ADR creation commands to streamline the documentation process
ユースケース
01Recording trade-offs when selecting a specific ORM or authentication library
02Capturing the context behind major database schema migrations or caching strategies
03Documenting the rationale for switching from a monolithic to a microservices architecture
