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