Does this skill support automated code fixes?

This skill is focused on detection and analysis. It provides actionable suggestions and identifies specific line numbers where drift occurs, but the developer must apply the fixes.

What documentation standards does this skill look for?

It is designed to work with Architecture Decision Records (ADRs) located in 'docs/adrs/' and OpenSpec technical specifications located in 'docs/openspec/specs/'.

How are findings categorized by severity?

Contradictions of 'MUST' or 'SHALL' requirements and rejected ADR alternatives are marked as CRITICAL. Violations of 'SHOULD' or 'RECOMMENDED' guidelines are marked as WARNING.

Is this the same as a full architecture audit?

No, this is a 'quick-check' skill designed for speed. For a comprehensive analysis covering all six categories of architectural health, use the '/design:audit' command instead.

What does this skill mean by 'drift'?

Drift refers to the divergence between the actual code implementation and the established architectural decisions or technical specifications governing that code.

Architectural Drift Check

Name: Architectural Drift Check
Author: joestump

byjoestump

•

学習とドキュメンテーション

Performs rapid alignment analysis to ensure code implementation remains consistent with Architecture Decision Records (ADRs) and design specifications.

The Architectural Drift Check skill automates the validation process between your codebase and its governing design artifacts. By scanning ADRs and OpenSpec documentation, it identifies critical contradictions, missing requirements, and architectural deviations in specific files or directories. It provides a structured findings table with severity levels, helping developers maintain system integrity and documentation accuracy during active development or refactoring phases without needing a full system audit.

主な機能

01Detects contradictions between code and Architecture Decision Records (ADRs)

02Validates implementation against OpenSpec MUST/SHALL/SHOULD requirements

03Identifies internal inconsistencies between ADR decisions and technical specs

04Generates structured reports with Critical, Warning, and Info severity levels

05Verifies documentation completeness, including required spec and design artifact pairings

064 GitHub stars

ユースケース

01Verifying that a new feature implementation adheres to established architectural constraints before a pull request

02Scanning for technical drift after a large refactor to ensure compliance with existing design specs

03Auditing documentation consistency to ensure ADRs and technical specifications do not contradict each other

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joestump/claude-plugin-design check

For use in Claude.ai and ChatGPT

Download Skill