record-quality-baseline

What problem does it solve?

Without a clear baseline, it's impossible to objectively measure the impact of refactoring or major code changes on overall quality. This Skill captures a snapshot of key metrics before any modifications are made.

Core Features & Use Cases

• Comprehensive Metric Capture: Runs tests with coverage, extracts coverage metrics, executes code quality audits, checks TypeScript errors, and optionally analyzes code complexity.
• Persistent Baseline: Saves all captured metrics to a JSON file (.claude/baseline/quality-baseline.json) for easy comparison after changes.
• Pre-Refactor Validation: Ensures that the codebase is in a stable state (e.g., all tests passing) before allowing refactoring to begin.
• Use Case: Before embarking on a major refactoring effort, use this Skill to establish a quality baseline, then compare against it post-refactor to prove improvements or prevent regressions.

Quick Start

Record the current quality baseline for your project

This will run npm test --coverage, npm run audit:code, tsc --noEmit

and save results to .claude/baseline/quality-baseline.json.

record-quality-baseline

Output:

{

"status": "success",

"baseline": {

"tests": {"status": "passing", "total": 45},

"coverage": {"overall": 87.5},

"audit": {"score": 7.5},

"typescript": {"errors": 0}

},

"canProceed": true

}