ai-dev-tools-review

Architecture review for Swift detects the correct architectural layer of a file, classifies violations against the 4-layer architecture, and ranks them by severity. You provide a file path or paste code to generate a structured review with actionable refactor guidance.

The 4-layer architecture in Swift organizes code into Apps, Features, Services, and SDKs. Reviewing against these layers identifies cross-layer dependencies that cause maintenance and reuse challenges, ensuring proper separation of concerns.

To generate an architecture review report, submit a Swift file for analysis. The review outputs a formatted report with prioritized findings and guidance, and can optionally emit a .review.md file in the same directory to store the report.

Yes, architecture review works with existing Swift reference docs. It loads the corresponding reference documentation for the detected layer—Apps, Features, Services, or SDKs—to contextualize findings and provide incremental refactor guidance.

Yes, you can get actionable refactor guidance for Swift layer violations. The review report highlights the most egregious violations and provides practical, incremental next steps to help you progressively clean up the codebase.

Swift code violates layered architecture constraints when files bypass their designated layer, causing reuse challenges. The review identifies the correct architectural layer for a given file and reports violations ranked by severity to address this.