code-governance

code-governance is a Python tool for enforcing module boundaries and catching architectural violations in CI. It focuses on keeping dependencies between modules explicit through a governance.toml file, so codebases do not drift into broad, uncontrolled coupling. The page describes it as a kind of architecture linter for Python projects.

Its workflow starts by scanning source code, detecting modules, and mapping real imports before generating a governance.toml configuration. That file can then be reviewed and adjusted to match the intended structure of the codebase. The tool enforces several named rules: forbidden dependencies, circular dependencies, layer violations where lower architectural layers import from higher ones, limits on the public surface exposed by a module, and a cohesion check that flags modules importing more from outside than from within. Violations can be checked locally or in CI, and they fail the build when enforced there.

The same tool can also be used with CI integration. The page shows a GitHub Action that reports violations as pull request comments, and it says LLM-powered fix suggestions can be included. It can run with advice mode powered by OpenAI or Anthropic, and the interface shown on the page includes a reply command to apply a fix and update governance.toml. For existing codebases, it supports saving a baseline so only new violations fail.

code-governance is built for Python open source projects and is available as a terminal tool installable with pip. It can be run locally, in CI, or with LLM advice. The page lists MIT license and identifies Paradigm as the maker.