Deferential Realism: Documentation Suite

A philosophical framework for classifying constraints and conserving finite energy

---

Start Here

foundations/core_v4.2.md (~5,000 words) - Compressed introduction to the framework

• Seven constraint categories (Mountain, Rope, Tangled Rope, Snare, Scaffold, Piton, Naturalized)
• Four indexical parameters (WHO, WHEN, WHERE, HOW_MUCH)
• Power-scaling mechanism
• Containment logic for structural paradoxes
• Lifecycle understanding (genesis, maturation, degradation, terminal states)
• Strategic response patterns
• Navigation to full suite

Read this first. Everything else builds on these foundations.

Also at root level:

• application/quick_reference.md (~1,000 words) - One-page decision trees and heuristics for practitioners
• application/glossary.md - Definitions of all framework terminology (constraint types, indices, metrics, errors)
• application/faq.md (~8,000 words) - Objections, clarifications, comparisons to other frameworks (Marxism, libertarianism, relativism, etc.)
• docs/core_concepts/deferential_realism.md - Earlier gateway document (v2.0) introducing the framework

At some point, this repository will also be available as a GitBook for easier reading. See SUMMARY.md for the proposed navigation structure. I'll work on it if there is enough interest.

---

Philosophical Foundations

Located in foundations/

See the foundations README for the full navigational guide, including the debugging philosophy origin story and the Litany of the Real.

epistemology.md (~9,000 words)

The complete epistemological foundation:

• Intellectual lineage (Stoicism → Existentialism → Pragmatism → Critical Theory → Debugging Philosophy)
• Six-Test Battery methodology
• Hybrid Decomposition Protocol (with purity assessment)
• FNL/FCR formal verification tests
• Classifications as routing decisions (thermostat, not thermometer)
• Power-scaling mechanism
• Constraint illusions (substrate limits, coordination failures, legacy conceptual debt, epistemic attacks)
• Honest limitations, parser vulnerability findings, and epistemic positioning

logic.md (~4,000 words)

Formal operators for indexed constraint reasoning:

• Modal logic for constraint-types
• Inference rules and transformations
• Contradiction resolution through indexing
• Executable specification in Prolog

logic_extensions.md (v4.1 structural physics)

Extensions to the formal logic introducing structural analysis:

• Boltzmann compliance (natural law factorization test)
• Purity scoring (structural health within type)
• FNL/FCR detection signatures (physics-washing and coordination-washing)
• Network contamination (neighbor effects on constraint health)
• Drift types 8–11 (coupling, Boltzmann floor, purity, network)

metaphysics.md (~6,500 words)

Constraint-space ontology:

• Core claim: constraints constitute entities, not vice versa
• Structural realism and Boltzmann compliance as Mountain test
• Purity as structural health (entities degrade before type classification changes)
• Network porosity of entity boundaries
• 1,023-constraint corpus grounding

ethics.md (~16,000 words)

Six conditional virtues of constraint-alignment:

• Acceptance — Navigating genuine Mountains
• Resistance — Cutting Snares strategically
• Reform — Surgical Tangled Rope intervention (preserve coordination, excise extraction)
• Construction — Building functional Ropes
• Maintenance — Resource stewardship, purity monitoring, network responsibility
• Containment — Holding structural paradoxes without forced resolution
• Ethics of classification accuracy (False Mountains, Snare naturalization, epistemic warfare)

aesthetics.md (~7,200 words)

A field manual for creativity as the strategic engagement with constraint-structures:

• Creative Limits — Categorizes constraints to reduce extraction
• Aesthetic Strategies — Discusses creative choices
• Institutional Navigation — Provides techniques for art market reform and resistance
• Historical Analysis — Maps art movements as specific philosophies of constraint-relationship
• Paradox Containment — Offers practical methods for navigating unresolvable creative tensions

constraint_lifecycles.md (~12,000 words)

Temporal dynamics of constraints across all domains:

• Genesis patterns (how constraints emerge)
• Maturation and stabilization
• Degradation paths (Rope → Tangled Rope → Snare → Piton)
• Drift event taxonomy (Types 1–11)
• Terminal states and graceful dissolution

Applied Domains

• psychology.md (~15,000 words) — Internal constraint navigation
• sociology.md (~19,000 words) — Social constraint dynamics
• politics.md (~9,500 words) — Institutional constraint navigation

---

Applied Practice

Located in application/

application/applied_guide.md (~6,700 words)

Practical classification manual:

• Decision trees for real-world classification
• Common misclassifications and corrections
• Energy conservation strategies
• Case studies from multiple domains
• When to act vs. investigate vs. observe

tools/uke_suite/claims_evaluator.md (UKE_DR Protocol)

Reality-check for recommendations and proposals:

• Post-generation audit tool
• Detects fantasy recommendations ignoring constraints
• Prevents advocacy disguised as analysis
• Pipeline: Draft → Claims Evaluation → Revision

tools/uke_suite/diagnostic_evaluator.md (Constraint Evaluator v2.0)

Mathematical stress testing:

• Force narratives to survive numerical confrontation
• Expose rationalization, hallucination, miracles
• Gauge stance: math as resistance, not scenery
• τ_fail boundary testing protocols

application/beliefs/individual_belief_battery.md (~7,500 words)

Practical epistemology for finite agents:

• Tier 0 (Theory): Universal truths independent of position
• Tier 1 (Practice): Indexed beliefs for individuals
  • Default context: moderate power, biographical timescale, mobile, national scope
  • 50+ practical questions with Prolog specifications
• Extensible to organizational/institutional contexts
• Executable Prolog implementation: foundations/structural_dynamics_model/prolog/belief_battery/

---

Application: Narrative Transform

Located in application/narrative_transform/

A 6-stage AI pipeline for extracting constraint structures from existing stories and generating new narratives in completely different settings that preserve the underlying dynamics.

Purpose: Demonstrate that constraint structures are transferable across contexts—the same pattern of Mountains, Ropes, and Snares can manifest in radically different worlds.

Architecture:

• Stage 0: Constraint extraction (Gemini) - Identify structural dynamics in source story
• Stage 1: Operational specification (Copilot) - Formalize invariants and transformation rules
• Stage 2: Context design (Claude) - Create new world that naturalizes the constraints
• Stage 3: Editorial decisions (ChatGPT) - POV, tense, length, model selection
• Stage 4: Narrative generation (selected model) - Generate story with NO access to source
• Stage 5: Phenomenological deepening (optional) - Sensory grounding for publication quality

Key Innovation: Stage 4 receives only the formalized constraint structure, never the original story. The resulting narrative must be unrecognizable from the source while preserving its constraint dynamics.

Example workflow: narrative_transform_example.md

Generated stories: stories/

• blood_silver.md - Constraint structure transplanted to new setting
• faint_blue.md (+ variants) - Multiple perspective explorations
• rotation_seven.md, the_calm.md - Additional transformations

Full protocol: uke_narrative_v1.1.md (~100KB)

---

Application: Structural Dynamics Model

Located in foundations/structural_dynamics_model/

A reproducible constraint analysis compiler that transforms domain descriptions into formal structural classifications and falsifiable predictions.

Purpose: Apply Deferential Realism operationally across any domain using a 4-layer AI pipeline with formal specifications.

Architecture:

• Layer 0: Framework design - DR theory + executable specifications
• Layer 1: Structural extraction (Gemini) - Domain description → Prolog constraint model
• Layer 2: Logical validation (SWI-Prolog) - Auto-repair, integrity check, gradient computation, ontological audit
• Layer 3: Narrative synthesis (Claude) - Audit output → Evidence-backed essay with falsifiable predictions

Key Innovation: Every stage executes published specifications. Reproducible reasoning, not black-box prompting.

Components:

• prolog/ - Symbolic reasoning engine (76 Prolog modules)
  • drl_core.pl - Context-indexed constraint classification
  • validation_suite.pl - 7-step audit protocol (primary entry point)
  • structural_signatures.pl - Natural law vs. constructed constraint detection
  • testsets/ - 993 formalized domain analyses
  • belief_battery/ - Personal belief audit system (40 questions)
• prompts/ - Layer 1 generation spec (60 pages)
• protocols/ - Layer 3 synthesis spec (UKE_W v2.1)
• python/ - Orchestration and analysis tools
• examples/ - Compiled essays and audit outputs

Domains tested: Finance (Lehman, Blackstone), governance (elections, HOA, tax code), protocols (Ergo, RFC), history (medieval church, KJV), algorithms (TSP, Gale-Shapley), organizational dynamics, mathematics, and more.

Quick start:

cd foundations/structural_dynamics_model/prolog
swipl -g "[stack], [validation_suite]"

Documentation: README.md, quick_start.md

---

Validation

Located in validation/

validation_report.md

Complete empirical analysis of 1,023 constraint scenarios:

• 0% collision rate - Index sufficiency confirmed
• 79% observer-dependent - Only 21% classify identically across all positions
• 36% Tangled Rope prevalence - Hybrid category necessary
• 44% institutional dissenter - Beneficiary is lone voice classifying extraction as coordination
• Domain patterns (social/economic vs. technical/biological)
• Power modifier calibration
• Parser vulnerability findings (Mountain naturalization, WHO assignment, cultural narrative embedding)
• Confidence levels and limitations

data/

Raw validation corpus:

• corpus_data.json - 1,023 classified constraints
• structured_analysis.json - Processed analysis
• output.txt - Full classification outputs
• gap_report.json - Coverage gaps and missing domains

analysis/

Supporting validation analysis:

• index_sufficiency.md - 0% collision rate across 35 domains
• variance_analysis.md - Observer-dependence distribution
• pattern_mining.md - Tangled Rope discovery and prevalence
• corpus_analysis.txt - Domain-level statistics
• meta_report.txt - Meta-analysis of framework performance
• signature_matches.txt - Structural pattern detection

---

Archived & Legacy Documents

Located in docs/

These reference documents show where Deferential Realism originated, and are kept for historical purposes.

docs/core_concepts/omega_variables.md (~1,200 words)

Framework for identifying reasoning blockers:

• Three types: Empirical (Ω_E), Conceptual (Ω_C), Preference (Ω_P)
• Distinguishes data needs from definitional needs from value judgments
• Protocol for routing blockers to appropriate resolution
• Structural convergence principle

docs/core_concepts/indexical_relativity.md (~100 words)

Core innovation origin:

• Classifications relative to WHO/WHEN/WHERE/HOW_MUCH
• Not relativism: each indexed claim is objectively true/false
• Medieval Church example (Mountain for serf, Snare for historian, Rope for Pope)

docs/archive/mck_v1.6.md (~750 words)

Verified Kernel protocol:

• Grounding protocol (distinguish observable from constructed)
• Multi-perspective mandate
• Confidence calibration
• Omega variable marking
• Dignity and reality invariants

docs/uke/uke_protocol_framing_guide.md (~900 words)

Routing vs. truth clarification:

• UKE metrics are routing mechanisms, not truth measurements
• Decision interfaces for consistent comparison
• Protocol triggering based on confidence thresholds

docs/technical/debugging_philosophy.md (~40KB)

Predecessor framework for identifying reasoning error types:

• Systematic approach to philosophical debugging
• Error taxonomy and correction protocols

---

Quick Reference

Decision Tree

1. Does violation produce system collapse from REALITY (not punishment)?
   YES → Mountain (accept, navigate)
   NO → Constructed (continue to 2)

2. Does this solve a genuine coordination problem with reciprocal benefit?
   YES → Continue to 3
   NO → Continue to 4

3. Does it ALSO extract asymmetrically?
   NO → Rope (maintain, refine)
   YES → Tangled Rope (reform: preserve coordination, excise extraction)

4. Is it power-maintained with alternatives suppressed?
   YES → Snare (resist, exit, expose)
   NO → Continue to 5

5. Is it time-limited with explicit sunset?
   YES → Scaffold (use temporarily, dismantle when done)
   NO → Continue to 6

6. Has it lost function? Maintenance cost > benefit?
   YES → Piton (eliminate ruthlessly)
   NO → UNCLASSIFIED (gather more information)

Strategic Responses

• Mountain: Accept immediately, conserve energy, navigate creatively
• Rope: Maintain, improve efficiency, monitor for degradation
• Tangled Rope: Reform surgically — preserve coordination, excise extraction
• Snare: Expose beneficiaries, resist strategically, exit when possible
• Scaffold: Use temporarily, dismantle when purpose served, watch for permanence drift
• Piton: Eliminate ruthlessly, redirect freed energy to living constraints

Common Errors

• False fatalism: Calling Snares "Mountains" (unwarranted surrender)
• Dangerous hubris: Calling Mountains "Ropes" (catastrophic failure)
• Coordination-washing: Calling Snares "Ropes" (hiding extraction behind coordination rhetoric)
• Physics-washing: Calling Snares "Mountains" (hiding extraction behind natural-law rhetoric)
• Hybrid mishandling: Treating Tangled Ropes as pure types (either defend extraction or destroy coordination)
• Energy waste: Fighting unchangeable reality or maintaining obsolete Pitons

---

Framework Principles

Unifying invariants across all domains:

1. Accuracy commitment - Classify constraints according to actual structure, not desired narrative. Acknowledge uncertainty when present. Distinguish genuine confusion from motivated reasoning from deliberate misrepresentation.

2. Energy conservation - Finite resources demand strategic allocation. Don't waste energy fighting gravity. Don't surrender to changeable injustice.

3. Indexical relativity - Truth is relative to position but objective within index. Same constraint can be Mountain from one index, Snare from another—both are true. 79% of constraints classify differently by position.

4. Reality-alignment - Deference to what actually constrains. Honesty-in-practice about power, extraction, coordination, and natural limits.

5. Classifications as routing - Framework outputs are routing decisions (thermostats), not truth claims (thermometers). Thresholds are governance stands about when to change response behavior, not ontological boundaries.

---

How to Engage

If the framework makes sense:

1. Start with foundations/core_v4.2.md for compression
2. Read foundations/epistemology.md for depth
3. Apply application/applied_guide.md to your domain
4. Check validation/validation_report.md for empirical grounding
5. Explore domain-specific foundations (logic, logic_extensions, metaphysics, ethics, aesthetics)

If you have critiques:

1. Test framework against specific constraint you care about
2. Distinguish "I disagree with classification" from "classification method is flawed"
3. Note whether objection applies to epistemology or to other domains
4. Check if critique assumes universality claims the framework doesn't make
5. See foundations/epistemology.md Section VII (Known Limitations) and Section IX (Epistemic Position)

If you want to apply it:

1. Use application/applied_guide.md decision trees
2. Run the Structural Dynamics Model for formal analysis
3. Try Narrative Transform for creative constraint transposition
4. Run tools/uke_suite/claims_evaluator.md on recommendations to detect constraint-blindness
5. Use tools/uke_suite/diagnostic_evaluator.md to stress-test narratives with math
6. Adapt application/beliefs/individual_belief_battery.md to your context

---

Status

Framework version: 4.2 (March 2026)

Corpus validation:

• 1,023 constraints analyzed across 35+ domains
• 0% collision rate within formal system
• 79% observer-dependent (indexical specification mandatory)
• 36% Tangled Rope prevalence
• 44% institutional dissenter pattern
• Domain patterns confirmed (social vs. technical extraction rates)

v4.1 → v4.2 additions:

• Structural physics layer (Boltzmann compliance, purity scoring, network contamination)
• Drift types 8–11 (coupling, Boltzmann floor, purity, network)
• FNL/FCR formal detection signatures
• Metrics-as-routing epistemological reframe
• 1,023-constraint corpus (expanded from 467)
• Institutional dissenter finding (44%)
• Observer-dependence finding (79%)
• 993 formalized testsets in the Structural Dynamics Model
• All domain files updated with structural physics integration

Framework stability: Core structure (7 categories + 4 indices + power-scaling) is internally coherent and empirically grounded within the analyzed corpus.

External validation: Peer review and independent replication ongoing.

Known limitations: Corpus is exploratory (not statistically representative), classification assumes accurate information access, power modifiers may need contextual adjustment, timing predictions untested, framework provides disambiguation (not normative guidance).

See validation/validation_report.md for complete methodology, findings, and confidence levels.

---

Installation

For Reading/Study

No installation required. Start with foundations/core_v4.2.md.

For Running the Validation Suite

# Requirements: Python 3.8+, SWI-Prolog
sudo apt install python3 swi-prolog  # Ubuntu/Debian
brew install python3 swi-prolog       # macOS

# Run validation
cd foundations/structural_dynamics_model/prolog
swipl -g "[stack], [validation_suite], run_dynamic_suite, halt" -t "halt(1)"

For Full LLM Pipeline (Optional)

pip install -r tools/streamlit/requirements.txt
export ANTHROPIC_API_KEY="your-key"
export GOOGLE_API_KEY="your-key"

See tools/streamlit/requirements.txt for details.

---

Contributing

See CONTRIBUTING.md for guidelines on:

• Adding domain constraint analyses
• Reporting issues
• Improving documentation
• Extending the framework

---

Citation

See CITATION.md for BibTeX and text citation formats.

Quick citation:

cafebedouin. (2026). Deferential Realism: An Indexed Epistemology for Constraint Classification (Version 4.2). https://github.com/cafebedouin/deferential_realism

---

The Goal

Don't waste finite energy fighting gravity. Don't surrender to changeable injustice. Know the difference.

---

Deferential Realism v4.2 Empirically Grounded March 2026