ql-review

Community

Spec-first two-stage code review

Authorandyzengmath
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Prevents wasted review effort and unsafe merges by enforcing spec compliance before any code quality evaluation, ensuring that only implementation-accurate changes consume reviewer time and CI gates.

Core Features & Use Cases

  • Two-stage review pipeline: Stage 1 validates code against PRD acceptance criteria and Stage 2 assesses code quality only if Stage 1 passes.
  • Standalone and automated modes: Can be invoked manually against a branch or run automatically as part of the quantum-loop execution using quantum.json context.
  • Integration checks: Performs cross-story call-chain tracing, type consistency checks, dead-code detection, and import resolution using LSP when available, with grep/fallbacks as needed.
  • Clear gating and remediation: Emits structured reports, records results to quantum.json when present, enforces fix-and-retry semantics, and provides exact wiring fixes for integration failures.

Quick Start

Run ql-review against the current story or branch to perform a spec compliance review followed by a code quality review.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: ql-review
Download link: https://github.com/andyzengmath/quantum-loop/archive/main.zip#ql-review

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.