ArchSpec

ArchSpec is a linter designed for Ruby and Rails projects that focuses on enforcing architectural conventions and boundaries within codebases. It enables teams to specify architecture rules, such as allowed and forbidden dependencies between components, method protocols, and boundaries between layers like controllers, models, and services. These specifications are written in a Ruby configuration file, allowing users to declare which components can or cannot interact, reference certain constants, or implement specific methods.

The tool integrates with continuous integration (CI) systems and can run checks automatically on every commit, as well as through git hooks. ArchSpec analyzes code using Prism, without requiring the application to boot or access a database, which makes the checks fast and suitable for frequent use during development. It supports executable architecture specifications, ensuring that both human developers and automated agents adhere to defined conventions.

ArchSpec comes with built-in support for several architectural patterns, including Rails, vanilla Rails, layered, hexagonal, clean, modular monolith, CQRS, and event-driven architectures. Users can start from these predefined architectures or compose custom rules in plain Ruby to fit their specific needs. The tool is intended for development teams working with Ruby or Rails who want to maintain clear component boundaries and enforce dependency directions within their projects.