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

•

学习与文档

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.

主要功能

Context-aware documentation for non-obvious implementation choices
Intelligent placement decision tree for headers vs. inline comments
Integration with ADR-driven development workflows and /itp:go phases
2 GitHub stars
Language-specific reference patterns for Python, TypeScript, Rust, and Go
Automated ADR path derivation and document mapping

使用场景

Ensuring compliance with team-wide documentation and traceability standards
Documenting the rationale for complex performance optimizations or edge-case handling
Linking new file creation to specific architectural design records

关于

主要功能

Context-aware documentation for non-obvious implementation choices
Intelligent placement decision tree for headers vs. inline comments
Integration with ADR-driven development workflows and /itp:go phases
2 GitHub stars
Language-specific reference patterns for Python, TypeScript, Rust, and Go
Automated ADR path derivation and document mapping

使用场景

Ensuring compliance with team-wide documentation and traceability standards
Documenting the rationale for complex performance optimizations or edge-case handling
Linking new file creation to specific architectural design records