# Align Architecture > Audit the codebase against AGENTS.md architecture rules, identify discrepancies, and fix them. Use when verifying hexagonal architecture compliance, code conventions, test quality, dependency direction, package configuration, or documentation sync after changes. Use when this capability is needed. - Skill: `tomevault-io/align-architecture` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/align-architecture` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/align-architecture/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Security - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/align-architecture --- # Align Architecture Audit the codebase against AGENTS.md and fix all discrepancies. ## Process ### 1. Load Rules Read AGENTS.md (or CLAUDE.md) to extract the full rule set. Parse and categorize every rule into: - Architecture constraints - DO rules - DON'T rules ### 2. Audit For each extracted rule, use the Explore agent to verify compliance across the codebase. Report each rule as PASS or FAIL with specific file paths and line numbers. ### 3. Plan Fixes For each FAIL, create actionable fix items using TodoWrite. ### 4. Implement - Remove violating tests entirely (no commenting out) - Fix import patterns, configuration, or dependency violations - Sync documentation with actual state - Never introduce new violations while fixing ### 5. Verify Run `pnpm test` and `pnpm build` (if available). All tests must pass. ### 6. Summary Report: total rules checked, pass/fail counts, fixes applied, test results. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/jo-minjun) — claim your Tome and manage your conversions.