Complexity Budgeting¶
Limit added complexity so refinements do not exceed the system's ability to understand, maintain, validate, or use them.
The Diagnostic Story¶
Symptom: Features, rules, edge-case handlers, and configuration options accumulate. Each addition looks locally reasonable, but the total cost — interpretability, maintenance, testing, coordination — is never charged to the decision that created it. The model or design has become fragile to change, nobody fully owns the emergent complexity, and reviewers face overload. The core purpose is obscured behind sophistication that may not be earning its keep.
Pivot: Define what counts as complexity cost, set an explicit budget for the current purpose and lifecycle stage, require each addition to justify its value against that budget, and prune or defer details that exceed the budget without sufficient benefit.
Resolution: Signal-to-complexity ratio rises and designs become more maintainable because additions must earn their place. Progressive refinement becomes more disciplined. Tradeoff conversations shift from implicit accumulation to explicit comparison of value against complexity cost.
Reach for this when you hear…¶
[machine learning] “The ensemble has fourteen models and the lift over a simple baseline is two percent — I need to know if that is worth the maintenance before we ship it.”
[tax law] “Every exception we added to the rule was justified at the time, but now practitioners need a decision tree just to figure out which clause applies.”
[product management] “We said yes to every edge case the enterprise customers asked for and now nobody can explain the product to a new user in under ten minutes.”
Mechanisms / Implementations¶
- Feature Budget (
feature_budget): This procedure implements the archetype by limits how many features, options, screens, customizations, or workflow branches a product or service may add during a planning cycle. - Model Complexity Penalty (
model_complexity_penalty): This method implements the archetype by penalizes additional variables, parameters, interactions, or degrees of freedom unless they improve predictive, explanatory, or decision value enough to justify the burden. - Design Complexity Review (
design_complexity_review): This ritual implements the archetype by creates a recurring forum or checklist where proposed additions are evaluated for complexity cost, value, maintainability, and alternatives. - Architecture Decision Record (
architecture_decision_record): This document implements the archetype by records why a complexity-increasing architectural choice was accepted, what alternatives were rejected, and what future review or rollback conditions apply. - Scope Budget (
scope_budget): This workflow implements the archetype by caps the total scope of a release, project, policy package, research plan, or process redesign so additions must displace lower-value items or wait. - Assumption Budget (
assumption_budget): This checklist implements the archetype by limits or scores the assumptions a model, plan, forecast, or strategy is allowed to rely on before stronger evidence or simplification is required. - Maintainability Threshold (
maintainability_threshold): This metric_or_dashboard implements the archetype by defines a measurable or reviewable threshold for support burden, dependency count, change risk, documentation load, or operator workload. - Complexity Ledger (
complexity_ledger): This document implements the archetype by tracks complexity additions, budget use, exceptions, owners, review dates, and promised value so that decisions remain revisitable. - Minimum Description Length Penalty (
minimum_description_length_penalty): This method implements the archetype by uses description length or model simplicity as a penalty so added explanatory machinery must improve fit enough to compensate for extra complexity. - Change Control Gate (
change_control_gate): This workflow implements the archetype by requires proposed changes to pass a structured review of complexity impact, value, risk, and maintainability before entering the system.
- Architecture Decision Record: Records why a complexity-adding placement choice was accepted — the criterion applied, the host-dependency it commits to, and the conditions that would reopen it — so the decision is revisited on evidence, not relitigated from memory.
- Assumption Budget
- Change Control Gate
- Complexity Ledger
- Design Complexity Review
- Feature Budget
- Maintainability Threshold
- Minimum Description Length Penalty
- Model Complexity Penalty
- Scope Budget
Related Abstractions¶
Abstractions this archetype builds on — directly (a source ingredient) or as a related pattern. Links follow the typed catalog namespace.
Built directly on (3)
- Complexity: Measures system intricacy.
- Parsimony (Occam's Razor): Prefer simplicity.
- Progressive Refinement from Core Model: Incremental refinement.
Also references 6 related abstractions
- Diminishing Returns (Law of): Reduced output gains.
- Overfitting: Poor generalization.
- Resource Management: Allocation of finite assets.
- Threshold: Safe vs harmful levels.
- Trade-offs: Balancing competing priorities.
- Uncertainty: Incomplete knowledge.
Variants¶
Narrower or domain-specific specializations that share this archetype's core structure. Recognized variants are established; candidate variants are provisional.
Feature Budgeting · subtype · recognized
Limit product, service, release, or workflow features so added capability must justify user, support, and maintenance complexity.
Model Complexity Budgeting · subtype · recognized
Limit variables, parameters, interactions, assumptions, or segments in a model unless they improve validated decision value enough to justify complexity.
Assumption Budgeting · subtype · candidate
Limit the number, strength, or fragility of assumptions a model, plan, policy, or strategy may rely on before evidence, simplification, or review is required.
Validation Load Budgeting · risk or failure variant · candidate
Limit refinements by the amount of testing, monitoring, evidence, or review capacity required to keep the system trustworthy.
Interface Complexity Budgeting · implementation variant · candidate
Limit the number of states, options, dependencies, messages, or coordination requirements exposed through an interface.