Does it add a reference to every code change?

No, it is designed to avoid noise. It skips trivial changes like formatting or standard patterns, focusing only on areas where traceability adds genuine value to the developer.

What languages does ADR Code Traceability support?

The skill provides optimized comment patterns and placement guidelines specifically for Python, TypeScript, Rust, and Go.

How does the skill decide where to place ADR references?

It uses a logical decision tree: for new files, it adds references to the file header; for existing files, it adds inline comments only for non-obvious changes that require architectural context.

Can this skill help with ADR-driven development?

Yes, it is specifically designed to support ADR-driven workflows, helping teams maintain a single source of truth between their documentation and their implementation.

ADR Code Traceability

Name: ADR Code Traceability
Author: terrylica

byterrylica

•

Learning & Documentation

Bridges the gap between architectural decisions and source code by embedding traceable ADR references into your implementation.

ADR Code Traceability is a specialized Claude Code skill designed to maintain a clear connection between high-level architectural decisions and their technical implementation. By providing standardized, language-specific patterns for Python, TypeScript, Rust, and Go, it helps developers document the 'why' behind complex code choices directly in the repository. The skill intelligently identifies when to add file headers for new components or inline comments for non-obvious logic, ensuring that your codebase remains navigable, auditable, and aligned with your Architecture Decision Records (ADRs) without creating comment bloat.

Key Features

01Context-aware documentation for non-obvious implementation choices

02Intelligent placement decision tree for headers vs. inline comments

03Integration with ADR-driven development workflows and /itp:go phases

042 GitHub stars

05Language-specific reference patterns for Python, TypeScript, Rust, and Go

06Automated ADR path derivation and document mapping

Use Cases

01Ensuring compliance with team-wide documentation and traceability standards

02Documenting the rationale for complex performance optimizations or edge-case handling

03Linking new file creation to specific architectural design records

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrylica/cc-skills adr-code-traceability

For use in Claude.ai and ChatGPT

Download Skill