ln-642-layer-boundary-auditor

Audit architectural layer boundaries and cross-layer consistency in codebases.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/cbbkrd-tech/jl-finishes --skill ln-642-layer-boundary-auditor-cbbkrd-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ln-642-layer-boundary-auditor
Source: https://github.com/cbbkrd-tech/jl-finishes/tree/main/.claude/skills/ln-642-layer-boundary-auditor
Command: npx skills add https://github.com/cbbkrd-tech/jl-finishes --skill ln-642-layer-boundary-auditor-cbbkrd-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill automatically audits your project's code to detect violations of architectural layer boundaries and cross-layer consistency issues, ensuring a cleaner and more maintainable codebase.

Core Features & Use Cases

  • Layer Violation Detection: Identifies code that improperly crosses defined architectural layers (e.g., I/O operations in the wrong layer).
  • Cross-Layer Consistency: Checks for issues like incorrect transaction boundary ownership and mixed session management (DI vs. local).
  • Pattern Coverage: Verifies that standard patterns, like HTTP client abstractions, are consistently applied.
  • Use Case: A developer can run this auditor to quickly identify if the UI layer is making direct database calls, which violates a typical layered architecture, and receive a clear suggestion on where to move that code.

Quick Start

Run the layer boundary auditor on the codebase root, specifying the architecture documentation path and an output directory.

Frequently Asked Questions about ln-642-layer-boundary-auditor

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

FAQPage Schema
How do I detect architectural layer violations in my codebase?

Detect architectural layer violations by parsing architecture documentation and scanning code files to identify misplaced I/O operations. This auditor flags improper cross-layer calls, like direct database access from the UI layer, enforcing strict adherence to defined layer rules.

What are common cross-layer consistency issues in layered architecture?

Cross-layer consistency issues include incorrect transaction boundary ownership and mixed session management implementations. Scanning code files against architecture documentation detects these mismatches, such as mixing dependency-injected sessions with local ones, ensuring improved software maintainability.

How do I audit pattern coverage for HTTP client abstractions?

Audit pattern coverage for HTTP client abstractions by scanning code files against defined layer rules to verify consistent application. This identifies inconsistencies and enforces standard architectural patterns uniformly across the codebase for better software maintainability.

Does the layer boundary auditor require architecture documentation to run?

Yes, the layer boundary auditor requires architecture documentation to run. You must specify the architecture documentation path so the tool can parse defined layer rules and accurately detect cross-layer consistency issues and I/O violations within the codebase.

What is the best way to check transaction boundary ownership across application layers?

Check transaction boundary ownership by scanning code files against parsed architecture documentation. This detects ownership mismatches and cross-layer consistency issues, verifying that transaction boundaries correctly align with their designated architectural layers for improved maintainability.

Why does my codebase have mixed session ownership between DI and local implementations?

Mixed session ownership between DI and local implementations occurs when dependency-injected and local sessions are used inconsistently across layers. Scanning code files detects these session ownership mismatches, enforcing cross-layer consistency and adherence to defined layer rules.