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.

tomevault-io 8657a72 2 files · 2.0 KB Updated

File contents

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 — claim your Tome and manage your conversions.

tomevault-io/skills-registry/tree/main/jo-minjun--petrify--align-architecture commit 8657a72e4b

Frequently asked questions

npx skillmds@latest add tomevault-io/align-architecture