Quality Engineering Demo

Automated Code Review Agent

A QE review agent that triages PR files, attaches team standards, routes review depth, and emits gated comments.

Runnable demo · Repo path: workshops/workshop1-code-review

Structure Blueprint

Automated Code Review Agent blueprint

Clickable pattern simulator

Interactive Browser Demo

This simulator does not replace the CLI run, but it makes each step, state, log, gate and final output visible in the browser.

Live pipeline

State inspector

Execution log

Current output

Step-by-step Design

01

Load PR object

Classify changed files by quality impact before reasoning.

Context Triage
02

Attach standards

Pin team coding rules and project conventions.

Hierarchical Retention
03

Route depth

Fast path for lint-like issues, deeper path for risk-bearing changes.

Complexity Routing
04

Generate comments

Emit concise review comments with file, severity and rationale.

Prompt Chaining
05

Apply gate

Block only when quality or release risk crosses the threshold.

Approval Gate
06

Expose trace

Show file route, rule source, score and gate reason.

Observability Harness

Screenshots

Terminal output: PR triage, review routing, comments, and release gate.
Terminal output: PR triage, review routing, comments, and release gate.

Pattern Mapping

PatternDesign role
Context TriageLarge PRs need file priority before review judgment.
Hierarchical RetentionTeam standards should be stable context, not repeated prompt text.
Complexity RoutingDifferent review questions deserve different model depth.
Approval GateThe system comments freely but blocks cautiously.

Design Insights

Attention is the first quality control

Most bad code review agents fail before reasoning, because the wrong files enter the context.

Memory turns style into policy

A team style guide should behave like pinned memory, otherwise every PR starts from zero.

The gate defines autonomy

A review agent can be useful without owning merge authority.

Run Path

cd workshops/workshop1-code-review python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt python src/main.py open visual/index.html
READMEworkshops/workshop1-code-review/README.md
Blueprintimages/training/visual/workshop1-code-review-blueprint.png