What problem does it solve? Architectural and design decisions made during development are forgotten between sessions, causing repeated re-litigation of the same trade-offs and inconsistent choices. This Skill captures the reasoning behind every non-trivial decision in a searchable, chronological ADR log. ## Core Features & Use Cases - Structured ADR Creation: Generates sequentially numbered ADR files (e.g., 003-jwt-refresh-rotation.md) from a template covering context, options considered, decision, and consequences. - Decision Discovery: Searches existing ADRs by keyword or tag before deciding, and links superseding decisions both ways to preserve history. - Index Maintenance: Updates a central INDEX.md with chronological and tag-based tables so decisions stay searchable across sessions. - Use Case: When choosing between JWT refresh rotation and long-lived tokens for a mobile app, invoke this Skill to check prior ADRs, frame the trade-offs, write ADR-008, and register it in the index for future sessions to reuse. ## Quick Start Log an architectural decision record for choosing PostgreSQL over MongoDB for the health data store, including the options considered and trade-offs.
