One-click install
npx skills add https://github.com/swingerman/disciplined-agentic-engineering --skill arch-check-swingerman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-check
Source: https://github.com/swingerman/disciplined-agentic-engineering/tree/main/engineer/skills/arch-check
Command: npx skills add https://github.com/swingerman/disciplined-agentic-engineering --skill arch-check-swingerman

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

It prevents AI-written feature code from drifting away from the charter’s intended architecture by turning the charter’s architecture rules into an objective, checkable gate before the work is considered complete.

Core Features & Use Cases

  • Architecture fitness validation: Checks dependency layering, cycles, forbidden patterns, file naming, and file size against the charter’s machine-readable architecture rules.
  • Read-only reporting: Surfaces violations with file and line context without attempting to auto-fix code.
  • Checkpoint workflow enforcement: Runs the required “handoff/branch hygiene/progress breadcrumb” steps so the check is executed at the right stage in the DAE pipeline.

Quick Start

Run the skill to check the feature’s code against the charter architecture rules and report any violations without modifying the code.

Frequently Asked Questions about arch-check

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

FAQPage Schema
How do I validate code against architecture rules to prevent structural drift?

Architecture validation checks feature code against charter-defined rules for dependency layering, cycles, forbidden patterns, and file size. It reports structural drift as fitness violations with file and line context for human triage.

What is architecture fitness validation for AI coding guardrails?

Architecture fitness validation enforces static analysis constraints to prevent AI-written feature code from drifting away from the charter's intended architecture. It turns machine-readable architecture rules into an objective, checkable gate before work is considered complete.

How do I check for dependency layering and cycle detection in a feature branch?

Run a post-implementation checkpoint audit using the charter's architecture manifest to check dependency layering and cycle detection. The audit enforces naming and size constraints, failing with fitness violations for human triage.

Does architecture validation auto-fix code when it detects forbidden patterns?

Architecture validation provides read-only reporting and does not auto-fix code. It surfaces forbidden patterns, dependency cycles, and layering violations with file and line context so developers can manually triage and resolve the issues.

Can I run a full-project architecture review instead of a targeted feature check?

Yes, architecture validation supports both targeted feature checks and full-project reviews using the charter's architecture manifest. Both modes enforce layering, cycle, forbidden pattern, naming, and size constraints through static analysis.

When should I run charter compliance checks in the development pipeline?

Run charter compliance checks during post-implementation checkpoint audits after completing feature code. The workflow enforces required handoff, branch hygiene, and progress breadcrumb steps so the architecture validation executes at the right pipeline stage.