Projects

The commit-check ecosystem is built on a simple architecture: one policy engine, multiple enforcement surfaces. Write your cchk.toml once — every surface reads the same file.

graph TB
    subgraph Policy["📄 cchk.toml"]
        direction LR
        Config[One policy file]
    end

    subgraph Engine["⚙️ commit-check<br/>(Python core)"]
        direction LR
        CLI[CLI & pre-commit]
        API[Python API]
    end

    subgraph Surfaces["🚀 Enforcement surfaces"]
        Action[commit-check-action<br/>GitHub Action]
        MCP[commit-check-mcp<br/>MCP Server]
    end

    Config --> Engine
    CLI --> Action
    API --> MCP
    Action --> CI[CI Pipeline]
    MCP --> Agent[AI Coding Agent]

Surface	What it does	Get started
commit-check	CLI tool, pre-commit hooks, and Python library. The core engine that runs all validations.	commit-check/commit-check
commit-check-action	GitHub Action wrapping the core engine. Posts results as check runs, job summaries, and PR comments.	commit-check/commit-check-action
commit-check-mcp	MCP server that exposes validations as structured tools for AI coding agents (Claude Code, Cursor, Copilot, etc.).	commit-check/commit-check-mcp