complexity-budget
Assess ownership, coupling, and value before a substantial design change when explicitly requested. Use code-review for completed changes.
How do I install this agent skill?
npx skills add https://github.com/wilbeibi/wilbeibi-skills --skill complexity-budgetIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a set of conceptual guidelines designed to help an AI agent avoid code complexity and architectural rot. It functions entirely as high-level decision-making logic and contains no code, executable scripts, or external network operations.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
complexity-budget
Identify the layer that owns the behavior, then assess whether the proposed complexity earns its cost. Use this lens for contested design choices; it is not a ceremony before routine edits.
Decision criteria
- Locate where the invariant is established. A fix repeated across callers may belong beneath them.
- Try composing existing functions, types, or configuration before adding a new mechanism.
- Compare extending existing behavior with a separate implementation. Folding in can reduce duplication, but coupling across ownership or trust boundaries may cost more than a small copy.
- Judge coupling and admitted invalid states, not line count. A larger change at the correct layer can be simpler.
- Use the project's idioms. Prefer types or constructors that prevent invalid states where practical.
Review the proposed change
Look for new cross-module dependencies, duplicated concepts, shared mutable state, and branches that defend invalid combinations. Resolve relevant concerns by moving behavior to its owner, reusing a primitive, simplifying the state model, or explaining the concrete outcome that justifies the addition.
Report only material tradeoffs or unresolved choices. Do not require spoken answers to every criterion, a fixed output template, or unrelated refactoring.
For deeper analysis of a contested decision, read REFERENCE.md.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/wilbeibi/wilbeibi-skills/complexity-budget">View complexity-budget on skillZs</a>