cross-layer-consistency

Detect cross-layer inconsistencies across Clean Architecture layers in a repository.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/jrmatherly/shipit --skill cross-layer-consistency-jrmatherly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cross-layer-consistency
Source: https://github.com/jrmatherly/shipit/tree/main/.claude/skills/cross-layer-consistency
Command: npx skills add https://github.com/jrmatherly/shipit --skill cross-layer-consistency-jrmatherly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates a comprehensive audit that detects architectural drift and inconsistencies across Clean Architecture layers so teams can catch breaking changes, stale generated code, missing implementations, DI miswiring, and test mismatches before they impact releases.

Core Features & Use Cases

  • Parallel verification: Deploys five concurrent subagents to check TypeSpec↔Domain, Ports↔Infrastructure, Use Cases↔Ports, Presentation↔Use Cases, and Tests↔Implementation.
  • Concrete checks: Verifies generated code freshness, searches for duplicate or hand-written types, confirms implementations and DI bindings for port interfaces, flags infrastructure leaks into presentation, and validates test existence and mock shapes.
  • When to use: Run after wide refactors, before releases, during onboarding to assess health, after complex merges, or as a scheduled monthly audit.

Quick Start

Run the cross-layer-consistency skill to deploy five parallel verification subagents and produce a unified Cross-Layer Consistency Report.

Frequently Asked Questions about cross-layer-consistency

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect Clean Architecture inconsistencies across layers after a refactor?

Detect Clean Architecture inconsistencies by running an automated cross-layer audit that uses parallel subagents to verify TypeSpec freshness, DI container bindings, import boundaries, and test coverage conformance across all layers.

How do I verify dependency injection bindings for port interfaces?

Verify dependency injection bindings by applying a consistency check that searches for implementations and confirms DI container wiring for port interfaces. It flags missing bindings to catch infrastructure and presentation layer miswiring.

What is the best way to check TypeSpec generated output freshness?

The best way to check TypeSpec generated output freshness is an automated consistency audit that verifies generated code is current and searches for duplicate or hand-written types indicating architectural drift.

Can I automate pre-release verification for Clean Architecture repositories?

Yes, you can automate pre-release verification by running a cross-layer consistency check that validates use-case wiring, presentation layer imports, and test mock shapes to catch breaking changes before release.

Does a cross-layer audit validate test coverage conformance for use cases?

Yes, a cross-layer audit validates test coverage conformance by checking Tests↔Implementation alignment, confirming test existence, and verifying mock shapes against actual use-case and port interfaces.

Why does infrastructure code leak into the presentation layer?

Infrastructure code leaks into the presentation layer due to incorrect import boundaries. A cross-layer consistency audit detects these leaks by verifying presentation↔use case wiring and flagging unauthorized infrastructure dependencies.