The Tests Are Green. The Architecture Is Not: Why I Built Archfit

说明与用途

Archfit 提供确定性的架构检查，生成修复任务，并与代理反馈循环集成，防止架构侵蚀。

问题

AI coding agents can make locally correct changes that violate architectural boundaries, leading to gradual architecture erosion.

结果

Archfit provides deterministic CI gates, actionable repair tasks, and modularity-aware coupling scores, enabling agents to respect architectural boundaries while maintaining rapid development.

工作流

• Define architectural boundaries in .archfit.yaml
• Run Archfit analyze to collect dependency facts
• Archfit compares facts to declared rules and outputs decisions
• If violations exist, Archfit generates structured repair tasks
• Agent applies fixes guided by the task
• Run Archfit check to confirm resolution

证据

Archfit reads architectural intent from .archfit.yaml. Language adapters collect dependency facts using ecosystem tools such as go list, dependency-cruiser, ast-grep, and grimp.

来源

Archfit can detect structural problems such as: forbidden dependencies; cross-module access to internal APIs; incorrect layer direction; dependency cycles; configured coupling or score regressions.

来源