What is Revieko

Revieko is a GitHub app that flags architecture drift in pull requests — repo-abnormal structural shifts that linters and tests usually miss.
It posts low-noise hotspots directly in PRs: a short summary + a full report when you need depth.

Get started: Install GitHub App

What Revieko does

• Detects repo-specific structural deviations in every PR.

• Points you to the few lines where architecture decisions are happening (hotspots).

• Helps teams keep boundaries and patterns consistent — especially at high PR velocity (including AI-authored PRs).

Where it shows up

Revieko runs where reviews happen:

• PR comment: status, risk, top hotspots

• Commit status check: pass / warn / fail (configurable)

• Full report: Markdown/JSON for deeper inspection

What it catches

• New abstractions — new state / manager classes appear

• Algorithmic shifts — loop/math structure changes

• Boundary drift — responsibilities move across modules

• Hidden coupling — implicit dependencies introduced

• State introduced — stateful objects appear

• Control-flow complexity — dense branching, generator/state patterns

• Heuristic drift — mixed rules without clear rationale

• Pattern breaks — structure deviates from repo norm

Not cosmetics: formatting, naming, typing-only changes, routine refactors.

How it works (conceptually)

Revieko builds a repo-specific baseline from your repository history, then compares each PR against what’s normal for your codebase.

• Learns your repository’s structural “signature”

• Scores deviations in the PR diff

• Surfaces only the most meaningful hotspots to keep noise low

Why teams use it

• Faster reviews: less scanning, more focus on decision points

• Lower drift debt: fewer “small cuts” that accumulate into fragile architecture

• Works with AI velocity: catches global boundary issues when changes are locally correct

Try it in 2 minutes

Option A — See it instantly

1. Open Demo repo

2. Check the PR comment and status

3. Open the full report (HTML/MD/JSON) for details

Option B — Install on your repo

1. Install GitHub App

2. Choose a repository

3. Open any PR → see hotspots automatically

Learn more

• Documentation

• Need help installing / want a pilot?