complexity-budget-check

Measures PATTERN.md section growth and applies the N:1 complexity budget rule per release.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/soli92/soli-projects --skill complexity-budget-check-soli92
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: complexity-budget-check
Source: https://github.com/soli92/soli-projects/tree/main/.cursor/skills/complexity-budget-check
Command: npx skills add https://github.com/soli92/soli-projects --skill complexity-budget-check-soli92

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents uncontrolled growth of a pattern specification document (PATTERN.md) by measuring how many top-level sections are added versus removed in each release, enforcing a documented N:1 budget rule with semantic verdicts instead of hard blocking. ## Core Features & Use Cases - Section Counting: Counts top-level ## sections in PATTERN.md with a whitelist that excludes TOC, examples, and self-referential sections. - N:1 Rule Evaluation: Parses CHANGELOG.md for target and previous versions, computes net additions versus archived removals, and emits pass, warn, fail, or skipped verdicts (patch releases are skipped automatically). - Report and Telemetry: Writes a versioned complexity/budget-report-<version>.md audit report and logs an EP-013 complexity_budget_check telemetry event. - Use Case: Before tagging a minor release of the pattern, run the check to verify that added sections stay within the N:1 ratio against archived sections, and get recommendations to deprecate sections or add a skip marker when the ratio is exceeded. ## Quick Start Ask the assistant to run the complexity budget check for the current PATTERN.md and CHANGELOG.md and show the verdict report for the target version.

Frequently Asked Questions about complexity-budget-check

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

FAQPage Schema
How do I check the complexity budget of PATTERN.md before a release?▼

Run the complexity-budget check via the lint Check 4v or the /complexity-budget check meta-command. It counts top-level sections, compares them against the previous version from CHANGELOG.md, and returns a pass, warn, fail, or skipped verdict with a written report.

What is the N:1 rule in complexity budget checking?▼

The N:1 rule limits net section additions to N times the number of archived or removed sections per release, with N defaulting to 3. If additions exceed the ratio the verdict becomes warn or fail, but it never blocks the release since enforcement is informational only.

Does the complexity budget check run on patch releases?▼

No, the check returns early with a skipped verdict on patch releases. The SemVer parsing of the CHANGELOG heading detects patch versions and skips the N:1 evaluation, which only applies to minor and major release cadence.

Can I skip the complexity budget check for a specific release?▼

Yes, add the marker [skip-complexity-budget --reason="<reason>"] to the CHANGELOG entry for that version. The check detects the marker, captures the skip reason, and returns a skipped verdict while still writing the audit report.

Why does the complexity budget check report a fail verdict?▼

A fail verdict occurs when net section additions exceed N+1 times the removals, or when sections are added with zero removals above the N threshold. It is only a severity signal; the recommended fix is deprecating sections or adding a skip marker before tagging.