loopx-change-quality

Reviews exact final diffs and records quality receipts for LoopX-managed goals.

4.0k|479|Updated Apr 16, 2020
One-click install
npx skills add https://github.com/huangrt01/CS-Notes --skill loopx-change-quality
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: loopx-change-quality
Source: https://github.com/huangrt01/CS-Notes/tree/main/.agents/skills/loopx-change-quality
Command: npx skills add https://github.com/huangrt01/CS-Notes --skill loopx-change-quality

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It ensures that a non-trivial code change in a LoopX-managed project is reviewed against an exact, fingerprinted diff before delivery or merge, producing a verifiable quality receipt instead of an informal sign-off.

Core Features & Use Cases

  • Exact-Scope Review: Prepares a change-quality packet via the LoopX CLI that pins the final diff to a fingerprint, so only the intended files are reviewed.
  • Simplify-First Guardrails: Guides the reviewer through reuse and simplification conclusions plus sparse, evidence-backed risks across lenses like type boundaries, error handling, and security.
  • Bounded Safe Fix: Permits at most one policy-authorized repair pass, then requires re-preparation so the receipt always matches the latest diff.
  • Receipt and Premerge Enforcement: Records a structured result, verifies it, and runs the canary premerge gate that blocks delivery on unresolved blockers or failed validation.
  • Use Case: Before merging a feature branch in a LoopX-managed repository, run the prepare command, review the packet's exact scope, record the receipt, and let the premerge gate confirm the change qualifies.

Quick Start

Ask the agent to run the LoopX change-quality prepare command for your goal against origin/main, review the exact diff, and record the quality receipt before merging.

Frequently Asked Questions about loopx-change-quality

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a final diff before merging with LoopX?

Run `loopx change-quality prepare` with your goal ID and base ref to get an exact-scope packet, review only the fingerprinted files, then record and verify the receipt. Finish by running `loopx canary premerge` as the authoritative merge gate.

What is a change quality receipt in LoopX?

A receipt is a structured result conforming to the change_quality_agent_result_v2 schema, containing reuse and simplification conclusions, sparse risks, and validation records. It is tied to an exact diff fingerprint and is invalid for any later diff.

Can the skill fix issues it finds during review?

Only when the goal policy sets safe_fix=true, and then at most one bounded repair pass is allowed inside the goal boundary. After any edit, the prepare step must be rerun because the old fingerprint becomes invalid.

Does this skill work with languages other than Python?

Yes, the workflow is language-neutral. It discovers validation tasks from repository-native declarations such as Poe, Hatch, Cargo, or package tasks, and relies on the project's own linters, type checkers, and tests as quality oracles.

When does the change quality review block a merge?

Delivery stops when strict policy requires a receipt that is missing, invalid, stale, or contains an unresolved blocker. Failed validation or skipped required validation also makes the receipt non-passing.

Does the skill grant merge or repository permissions?

No. The skill never grants merge or repository authority; the `canary premerge` command remains the enforcement authority, and the review workflow only produces evidence and receipts.