arch-check

Validates feature code against charter architecture rules for layering, cycles, and forbidden patterns.

150|10|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/swingerman/engineer --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/engineer/tree/main/engineer/skills/arch-check
Command: npx skills add https://github.com/swingerman/engineer --skill arch-check-swingerman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Architecture rules written in a project charter often stay as prose that nobody enforces, so layering violations, dependency cycles, and forbidden patterns creep into the codebase unnoticed. This Skill turns the charter's architecture section into an objective, tool-verified gate at Checkpoint 7 of the DAE pipeline. ## Core Features & Use Cases - Architecture fitness check: Runs dae_arch.py against the manifest's architecture rules to detect layering violations, dependency cycles, forbidden patterns, file naming issues, and oversized files. - Pipeline gating: Verifies prior checkpoints and branch hygiene before running, and blocks Checkpoint 7 completion until violations are resolved. - Runbook verification: Cross-checks runbook.md blocking steps against deploy-related acceptance criteria to surface verification gaps. - Use Case: After implementing a feature, run the check to confirm the new code respects the charter's dependency layering before handing off, then triage each violation with the human as either a code fix or a charter amendment. ## Quick Start Ask the agent to run an architecture check on the current feature to verify the code follows the charter's layering and dependency rules.

Frequently Asked Questions about arch-check

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

FAQPage Schema
How do I check if my code follows the project architecture rules?▼

Run the architecture check, which executes dae_arch.py against the manifest's architecture section. It reports layering violations, dependency cycles, forbidden patterns, and file naming or size issues with file and line references, without modifying any code.

How to enforce dependency layering rules in a codebase?▼

Define the layering rules in the manifest's architecture section, then run dae_arch.py to detect violations objectively. Each violation is triaged with a human decision: fix the code or amend the charter rules.

Does the architecture check fix violations automatically?▼

No, the check is read-only on the codebase. It reports violations grouped by kind, and a human decides per violation whether to fix the code or amend the manifest architecture rules and charter prose.

Why does the architecture check stop before running?▼

The check stops if the prior checkpoint handoff verification fails or if branch hygiene validation fails. Both gates must pass first; the tool surfaces the gap so you can switch branches or complete the earlier checkpoint.

What happens when the charter has no architecture section?▼

If dae_arch.py reports no architecture section, the check stops and informs you that the charter has no machine-readable architecture rules yet. You must add rules to the manifest before the fitness gate can run.

When should I use arch-check versus a change-risk analyzer?▼

Use arch-check for architecture fitness against charter rules at Checkpoint 7. Use a change-risk analyzer for risk scoring of code changes; the two run alongside each other but answer different questions.