Skip to content

mindicator/invAIriant

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

invAIriant — evidence-based architecture audits for AI-era codebases


CI pip Apache-2.0

invAIriant keeps architectural invariants from drifting under AI-assisted change.

Your coding agent runs the audit and gates the merge on real findings. Claude Code · Codex · Cursor.

No evidence. No finding.

Real terminal recording: invairiant collect, then validate-report (OK), then ci-gate — FAILED, RFP-001 [S1], exit 1 blocking the merge

An LLM can propose anything; only cited, verified findings count. invAIriant runs a named set of review lenses over a bounded change, then makes every candidate survive adversarial evidence checks before it becomes a finding. Lenses discover, evidence verifies, severity gates.

Status: early. Usable now as an agent skill; the CLI and CI support are intentionally small and deterministic.

Start

1. Add the skill to your agent — this is the audit:

mkdir -p .claude/skills && ln -s "$PWD/skill" .claude/skills/invairiant
# Codex / Cursor: see skill/README.md

2. Run it in the agent: /invairiant audit-pr → a paste-ready PR comment.

3. Gate CI (optional — the deterministic CLI seatbelt):

pip install invairiant
invairiant ci-gate report.json      # exits 1 on an open S0/S1 finding

Worked examples

The low-latency-runtime example shows the core rule: a passing summary does not erase a verified finding. Five more worked audits in case-studies/, and a runnable demo in examples/refundpilot-demo/.

Learn more

Not this

Not a linter, scanner, or proof of correctness; it turns their output into evidence and gates on verified findings. Not "AI, wander the repo and tell me what you think": it audits a bounded scope (a PR, a range, a module, an ADR) and refuses one it can't bound.


Apache-2.0 · © 2026 mindicator · Contributing · Roadmap

About

AI-assisted architecture-audit skill + CLI for systems where invariants must survive change (Claude Code · Codex · Cursor)

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages