Agentic Linter Skill

Goal

Enforce the architectural layer rules defined in AGENTS.md Section 3. Act as a semantic linter that detects boundary violations and proposes concrete fixes using the Dependency Inversion Principle.

Steps

1. Load architecture rules from AGENTS.md

   • Read AGENTS.md Section 3 (Architecture Rules / Layer Definitions)
   • Map each layer to its allowed imports
   • Note any project-specific forbidden patterns

2. Run import graph analysis

   For TypeScript/JavaScript (Node.js):

   # Check circular dependencies
   npx madge --circular --extensions ts,js src/