module-grades-gate

Detect module grade score regressions and unapproved new modules during PR checks.

Updated May 14, 2024
One-click install
npx skills add https://github.com/wagnerra23/oimpresso.com --skill module-grades-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: module-grades-gate
Source: https://github.com/wagnerra23/oimpresso.com/tree/main/.claude/skills/module-grades-gate
Command: npx skills add https://github.com/wagnerra23/oimpresso.com --skill module-grades-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents unwanted score regressions in the module-grade rubric and blocks risky merges by enforcing rubric baselines, including protection against newly introduced modules entering without explicit approval.

Core Features & Use Cases

  • Module Grades Anti-Regression: Compares head module scores against governance/module-grades-baseline.json and blocks merge on any dimension score decrease.
  • New Module Governance (Wave 2): Detects previously unseen modules in Modules/<X>/ and requires the module-grades-new-module-allowed label to approve their entry.
  • Local Reproduction & Baseline Reconciliation: Guides running composer module-grades-check / php artisan module:grade locally, updating baselines intentionally, and handling drift from renames (e.g., PontoWr2Ponto).

Quick Start

Ask the skill to run the module grades gate locally for the module you suspect and explain exactly which rubric dimensions caused the failure and what to do next.

Frequently Asked Questions about module-grades-gate

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

FAQPage Schema
How do I prevent module grade regressions in pull requests?

You can prevent module grade regressions by enforcing a rubric baseline that compares head module scores against a baseline JSON file, blocking merges when any rubric v3 dimension score decreases.

How do I block unapproved new modules from entering a codebase during CI?

To block unapproved new modules during CI, detect previously unseen module directories and require a specific PR label like module-grades-new-module-allowed to authorize their entry before merge.

How do I reconcile baseline drift after renaming a module directory?

Reconcile baseline drift after renaming a module directory by running local grade checks, identifying the score transfer from the old name to the new name, and intentionally updating the baseline JSON.

How do I run a local module grades check before opening a pull request?

Run a local module grades check before opening a pull request by executing composer module-grades-check or php artisan module:grade locally to compare scores against the baseline and identify failing rubric dimensions.

Can I override a CI gate failure caused by a module grade regression?

You can override a CI gate failure caused by a module grade regression by applying authorized PR labels, specifically using the module-grades-new-module-allowed label to approve entry for new modules.

What is a module grades rubric baseline and when do I need it?

A module grades rubric baseline is a JSON file storing v3 dimension scores used to detect regressions, needed when module directories change, grade outcomes differ, or CI reports anti-regression gate failures.