adr-code-traceability

What problem does it solve?

Code often lacks context, making it hard for developers to understand the "why" behind non-obvious implementation choices. This skill ensures that architectural decisions are directly traceable from the code, reducing cognitive load and onboarding time.

Core Features & Use Cases

• Language-Specific Reference Patterns: Provides standardized comment formats for Python, TypeScript, Rust, and Go to link code directly to ADRs.
• Intelligent Placement Guidelines: Guides on when to add references (new files, non-obvious choices) and when to skip them (trivial changes, standard patterns).
• Automated Decision Context: Embeds the rationale for critical code sections, making future maintenance and debugging significantly easier.
• Use Case: When implementing a complex algorithm or a specific architectural pattern, use this skill to add a comment linking to the relevant ADR, allowing any future developer to instantly understand the decision-making process.

Quick Start

Add an ADR reference to the new Python file 'my_feature.py'. The ADR ID is '2025-12-01-my-feature'.