What documents does the skill use to verify decisions?

The skill scans for accepted Architecture Decision Records (ADRs) located in the docs/decisions/ directory and extracts constraints to compare against the source code.

How does arch-drift determine module restrictions?

It utilizes a hierarchical rule set where 'app' can depend on 'lib' and 'core', 'lib' can only depend on 'core', and 'core' cannot have internal dependencies. Exceptions can be manually declared in the project's CLAUDE.md file.

What is the difference between an Error and a Warning in the report?

An Error is a clear violation of core dependency direction (e.g., core importing from app), while a Warning indicates a probable violation or an undeclared lib-to-lib dependency.

Can I use this skill in my CI/CD pipeline?

Yes, by using the --strict flag, the skill will return a non-zero exit code if any error-level violations are found, allowing you to fail builds that drift from the architecture.

Does it support cross-library dependencies?

By default, lib-to-lib dependencies are flagged as warnings unless they are explicitly declared in the ## Dependencies section of your module's CLAUDE.md file.

Architecture Drift Detector

Name: Architecture Drift Detector
Author: alexnodeland

byalexnodeland

•

開発者ツール

Audits codebase structure to identify and prevent violations of documented architectural decisions and module dependency rules.

The arch-drift skill ensures your codebase adheres to its intended design by mapping actual code dependencies against documented Architecture Decision Records (ADRs). It automatically identifies illegal imports between app, library, and core modules, flags unauthorized cross-library dependencies, and provides actionable reports linked directly to governing ADRs. By automating the detection of boundary violations, this skill prevents technical debt and architectural erosion, making it an essential tool for maintaining large-scale software systems and ensuring long-term code health.

主な機能

01Direct synchronization between code implementation and Architecture Decision Records (ADRs)

02Heuristic analysis of module boundaries and import violations

03Customizable dependency exceptions via CLAUDE.md configuration

04Automated dependency direction checking between module types (App, Lib, Core)

053 GitHub stars

06Strict mode integration for CI/CD pipelines to prevent architectural regressions

ユースケース

01Auditing legacy codebases to identify and map existing architectural technical debt

02Enforcing strict design patterns in monorepo environments via CI/CD integration

03Automating code reviews to catch architectural violations before they reach production

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled arch-drift

For use in Claude.ai and ChatGPT

Download Skill