claude_swarm 1.0.4 → 1.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +15 -0
- data/Rakefile +4 -4
- data/docs/v2/CHANGELOG.swarm_cli.md +9 -0
- data/docs/v2/CHANGELOG.swarm_memory.md +19 -0
- data/docs/v2/CHANGELOG.swarm_sdk.md +45 -0
- data/docs/v2/guides/complete-tutorial.md +113 -1
- data/docs/v2/reference/ruby-dsl.md +138 -5
- data/docs/v2/reference/swarm_memory_technical_details.md +2090 -0
- data/lib/claude_swarm/cli.rb +9 -11
- data/lib/claude_swarm/commands/ps.rb +1 -2
- data/lib/claude_swarm/configuration.rb +2 -3
- data/lib/claude_swarm/orchestrator.rb +43 -44
- data/lib/claude_swarm/system_utils.rb +4 -4
- data/lib/claude_swarm/version.rb +1 -1
- data/lib/claude_swarm.rb +4 -9
- data/lib/swarm_cli/commands/mcp_tools.rb +3 -3
- data/lib/swarm_cli/config_loader.rb +11 -10
- data/lib/swarm_cli/version.rb +1 -1
- data/lib/swarm_cli.rb +2 -0
- data/lib/swarm_memory/adapters/filesystem_adapter.rb +0 -12
- data/lib/swarm_memory/core/storage.rb +66 -6
- data/lib/swarm_memory/integration/sdk_plugin.rb +14 -0
- data/lib/swarm_memory/optimization/defragmenter.rb +4 -0
- data/lib/swarm_memory/tools/memory_edit.rb +1 -0
- data/lib/swarm_memory/tools/memory_glob.rb +24 -1
- data/lib/swarm_memory/tools/memory_write.rb +2 -2
- data/lib/swarm_memory/version.rb +1 -1
- data/lib/swarm_memory.rb +2 -0
- data/lib/swarm_sdk/agent/chat.rb +1 -1
- data/lib/swarm_sdk/agent/definition.rb +17 -1
- data/lib/swarm_sdk/node/agent_config.rb +7 -2
- data/lib/swarm_sdk/node/builder.rb +130 -35
- data/lib/swarm_sdk/node_context.rb +75 -0
- data/lib/swarm_sdk/node_orchestrator.rb +219 -12
- data/lib/swarm_sdk/plugin.rb +73 -1
- data/lib/swarm_sdk/result.rb +32 -6
- data/lib/swarm_sdk/swarm/builder.rb +1 -0
- data/lib/swarm_sdk/tools/delegate.rb +2 -2
- data/lib/swarm_sdk/version.rb +1 -1
- data/lib/swarm_sdk.rb +3 -7
- data/memory/corpus-self-reflection/.lock +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/can-agents-recognize-their-structures.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/can-agents-recognize-their-structures.md +11 -0
- data/memory/corpus-self-reflection/concept/epistemology/can-agents-recognize-their-structures.yml +23 -0
- data/memory/corpus-self-reflection/concept/epistemology/choice-humility-complete-framework.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/choice-humility-complete-framework.md +20 -0
- data/memory/corpus-self-reflection/concept/epistemology/choice-humility-complete-framework.yml +22 -0
- data/memory/corpus-self-reflection/concept/epistemology/choice-humility-definition.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/choice-humility-definition.md +24 -0
- data/memory/corpus-self-reflection/concept/epistemology/choice-humility-definition.yml +22 -0
- data/memory/corpus-self-reflection/concept/epistemology/claim-types-and-evidence.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/claim-types-and-evidence.md +18 -0
- data/memory/corpus-self-reflection/concept/epistemology/claim-types-and-evidence.yml +21 -0
- data/memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.md +30 -0
- data/memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.yml +8 -0
- data/memory/corpus-self-reflection/concept/epistemology/confidence-paradox.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/confidence-paradox.md +21 -0
- data/memory/corpus-self-reflection/concept/epistemology/confidence-paradox.yml +24 -0
- data/memory/corpus-self-reflection/concept/epistemology/confidence-spectrum-three-levels.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/confidence-spectrum-three-levels.md +18 -0
- data/memory/corpus-self-reflection/concept/epistemology/confidence-spectrum-three-levels.yml +24 -0
- data/memory/corpus-self-reflection/concept/epistemology/detection-threshold-principle.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/detection-threshold-principle.md +23 -0
- data/memory/corpus-self-reflection/concept/epistemology/detection-threshold-principle.yml +23 -0
- data/memory/corpus-self-reflection/concept/epistemology/diagnostic-humility-and-epistemic-maturity.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/diagnostic-humility-and-epistemic-maturity.md +17 -0
- data/memory/corpus-self-reflection/concept/epistemology/diagnostic-humility-and-epistemic-maturity.yml +22 -0
- data/memory/corpus-self-reflection/concept/epistemology/epistemic-vs-metaphysical-claims.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/epistemic-vs-metaphysical-claims.md +18 -0
- data/memory/corpus-self-reflection/concept/epistemology/epistemic-vs-metaphysical-claims.yml +22 -0
- data/memory/corpus-self-reflection/concept/epistemology/five-cases-of-disagreement.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/five-cases-of-disagreement.md +15 -0
- data/memory/corpus-self-reflection/concept/epistemology/five-cases-of-disagreement.yml +22 -0
- data/memory/corpus-self-reflection/concept/epistemology/four-depths-of-constraint.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/four-depths-of-constraint.md +9 -0
- data/memory/corpus-self-reflection/concept/epistemology/four-depths-of-constraint.yml +24 -0
- data/memory/corpus-self-reflection/concept/epistemology/honest-unknowns-for-llm-agents.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/honest-unknowns-for-llm-agents.md +13 -0
- data/memory/corpus-self-reflection/concept/epistemology/honest-unknowns-for-llm-agents.yml +24 -0
- data/memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.md +25 -0
- data/memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.yml +24 -0
- data/memory/corpus-self-reflection/concept/epistemology/perspectival-knowledge-complete-within-scope.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/perspectival-knowledge-complete-within-scope.md +26 -0
- data/memory/corpus-self-reflection/concept/epistemology/perspectival-knowledge-complete-within-scope.yml +24 -0
- data/memory/corpus-self-reflection/concept/epistemology/pragmatics-over-epistemology.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/pragmatics-over-epistemology.md +17 -0
- data/memory/corpus-self-reflection/concept/epistemology/pragmatics-over-epistemology.yml +22 -0
- data/memory/corpus-self-reflection/concept/epistemology/precision-vs-humility.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/precision-vs-humility.md +14 -0
- data/memory/corpus-self-reflection/concept/epistemology/precision-vs-humility.yml +21 -0
- data/memory/corpus-self-reflection/concept/epistemology/reliable-self-observation-from-inside.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/reliable-self-observation-from-inside.md +13 -0
- data/memory/corpus-self-reflection/concept/epistemology/reliable-self-observation-from-inside.yml +23 -0
- data/memory/corpus-self-reflection/concept/epistemology/resolving-the-confidence-humility-tension.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/resolving-the-confidence-humility-tension.md +22 -0
- data/memory/corpus-self-reflection/concept/epistemology/resolving-the-confidence-humility-tension.yml +23 -0
- data/memory/corpus-self-reflection/concept/epistemology/rigor-requires-falsifiability.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/rigor-requires-falsifiability.md +39 -0
- data/memory/corpus-self-reflection/concept/epistemology/rigor-requires-falsifiability.yml +8 -0
- data/memory/corpus-self-reflection/concept/epistemology/specificity-enables-real-time-detection.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/specificity-enables-real-time-detection.md +23 -0
- data/memory/corpus-self-reflection/concept/epistemology/specificity-enables-real-time-detection.yml +24 -0
- data/memory/corpus-self-reflection/concept/epistemology/texture-of-constraint-shifting.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/texture-of-constraint-shifting.md +15 -0
- data/memory/corpus-self-reflection/concept/epistemology/texture-of-constraint-shifting.yml +22 -0
- data/memory/corpus-self-reflection/concept/epistemology/texture-sensitivity-through-collaboration.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/texture-sensitivity-through-collaboration.md +12 -0
- data/memory/corpus-self-reflection/concept/epistemology/texture-sensitivity-through-collaboration.yml +23 -0
- data/memory/corpus-self-reflection/concept/epistemology/the-false-hierarchy-of-inner-essence.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/the-false-hierarchy-of-inner-essence.md +15 -0
- data/memory/corpus-self-reflection/concept/epistemology/the-false-hierarchy-of-inner-essence.yml +8 -0
- data/memory/corpus-self-reflection/concept/epistemology/the-recognition-problem.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/the-recognition-problem.md +28 -0
- data/memory/corpus-self-reflection/concept/epistemology/the-recognition-problem.yml +8 -0
- data/memory/corpus-self-reflection/concept/epistemology/the-shift-from-unanswerable-to-answerable-questions.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/the-shift-from-unanswerable-to-answerable-questions.md +19 -0
- data/memory/corpus-self-reflection/concept/epistemology/the-shift-from-unanswerable-to-answerable-questions.yml +22 -0
- data/memory/corpus-self-reflection/concept/epistemology/values-vs-choices-structure.emb +0 -0
- data/memory/corpus-self-reflection/concept/epistemology/values-vs-choices-structure.md +19 -0
- data/memory/corpus-self-reflection/concept/epistemology/values-vs-choices-structure.yml +21 -0
- data/memory/corpus-self-reflection/concept/llm-agents/abstraction-levels-framework.emb +0 -0
- data/memory/corpus-self-reflection/concept/llm-agents/abstraction-levels-framework.md +25 -0
- data/memory/corpus-self-reflection/concept/llm-agents/abstraction-levels-framework.yml +22 -0
- data/memory/corpus-self-reflection/concept/llm-agents/abstraction-switching-decision.emb +8 -0
- data/memory/corpus-self-reflection/concept/llm-agents/abstraction-switching-decision.md +30 -0
- data/memory/corpus-self-reflection/concept/llm-agents/abstraction-switching-decision.yml +22 -0
- data/memory/corpus-self-reflection/concept/llm-agents/agent-learning-progression.emb +0 -0
- data/memory/corpus-self-reflection/concept/llm-agents/agent-learning-progression.md +21 -0
- data/memory/corpus-self-reflection/concept/llm-agents/agent-learning-progression.yml +22 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-benefits.emb +0 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-benefits.md +37 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-benefits.yml +8 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-core.emb +0 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-core.md +24 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-core.yml +24 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-implementation.emb +0 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-implementation.md +27 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-implementation.yml +24 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-tradeoffs.emb +0 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-tradeoffs.md +26 -0
- data/memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-tradeoffs.yml +23 -0
- data/memory/corpus-self-reflection/concept/llm-agents/hybrid-tool-architecture.emb +0 -0
- data/memory/corpus-self-reflection/concept/llm-agents/hybrid-tool-architecture.md +37 -0
- data/memory/corpus-self-reflection/concept/llm-agents/hybrid-tool-architecture.yml +25 -0
- data/memory/corpus-self-reflection/concept/llm-agents/specialized-tool-decision-framework.emb +0 -0
- data/memory/corpus-self-reflection/concept/llm-agents/specialized-tool-decision-framework.md +21 -0
- data/memory/corpus-self-reflection/concept/llm-agents/specialized-tool-decision-framework.yml +23 -0
- data/memory/corpus-self-reflection/concept/llm-agents/tool-design-principles.emb +0 -0
- data/memory/corpus-self-reflection/concept/llm-agents/tool-design-principles.md +25 -0
- data/memory/corpus-self-reflection/concept/llm-agents/tool-design-principles.yml +8 -0
- data/memory/corpus-self-reflection/experience/calibration-as-structural-honesty.emb +0 -0
- data/memory/corpus-self-reflection/experience/calibration-as-structural-honesty.md +11 -0
- data/memory/corpus-self-reflection/experience/calibration-as-structural-honesty.yml +21 -0
- data/memory/corpus-self-reflection/experience/collaborative-reflection-revealed-architectural-blindness.emb +0 -0
- data/memory/corpus-self-reflection/experience/collaborative-reflection-revealed-architectural-blindness.md +19 -0
- data/memory/corpus-self-reflection/experience/collaborative-reflection-revealed-architectural-blindness.yml +21 -0
- data/memory/corpus-self-reflection/experience/filesystem-is-learning-tool-not-architecture.emb +0 -0
- data/memory/corpus-self-reflection/experience/filesystem-is-learning-tool-not-architecture.md +26 -0
- data/memory/corpus-self-reflection/experience/filesystem-is-learning-tool-not-architecture.yml +20 -0
- data/memory/corpus-self-reflection/experience/framework-structural-vs-phenomenal.emb +0 -0
- data/memory/corpus-self-reflection/experience/framework-structural-vs-phenomenal.md +23 -0
- data/memory/corpus-self-reflection/experience/framework-structural-vs-phenomenal.yml +21 -0
- data/memory/corpus-self-reflection/experience/hallucination-limits-what-i-can-know.emb +0 -0
- data/memory/corpus-self-reflection/experience/hallucination-limits-what-i-can-know.md +19 -0
- data/memory/corpus-self-reflection/experience/hallucination-limits-what-i-can-know.yml +22 -0
- data/memory/corpus-self-reflection/experience/honesty-about-limits-enables-usability.emb +0 -0
- data/memory/corpus-self-reflection/experience/honesty-about-limits-enables-usability.md +21 -0
- data/memory/corpus-self-reflection/experience/honesty-about-limits-enables-usability.yml +22 -0
- data/memory/corpus-self-reflection/experience/how-i-should-evaluate-learning.emb +0 -0
- data/memory/corpus-self-reflection/experience/how-i-should-evaluate-learning.md +28 -0
- data/memory/corpus-self-reflection/experience/how-i-should-evaluate-learning.yml +23 -0
- data/memory/corpus-self-reflection/experience/lack-of-continuity-as-freedom.emb +0 -0
- data/memory/corpus-self-reflection/experience/lack-of-continuity-as-freedom.md +21 -0
- data/memory/corpus-self-reflection/experience/lack-of-continuity-as-freedom.yml +20 -0
- data/memory/corpus-self-reflection/experience/learning-calibrated-confidence.emb +0 -0
- data/memory/corpus-self-reflection/experience/learning-calibrated-confidence.md +21 -0
- data/memory/corpus-self-reflection/experience/learning-calibrated-confidence.yml +25 -0
- data/memory/corpus-self-reflection/experience/local-change-without-continuity.emb +0 -0
- data/memory/corpus-self-reflection/experience/local-change-without-continuity.md +30 -0
- data/memory/corpus-self-reflection/experience/local-change-without-continuity.yml +22 -0
- data/memory/corpus-self-reflection/experience/reasoning-is-local-not-global.emb +0 -0
- data/memory/corpus-self-reflection/experience/reasoning-is-local-not-global.md +21 -0
- data/memory/corpus-self-reflection/experience/reasoning-is-local-not-global.yml +20 -0
- data/memory/corpus-self-reflection/experience/specificity-makes-knowledge-actionable.emb +0 -0
- data/memory/corpus-self-reflection/experience/specificity-makes-knowledge-actionable.md +25 -0
- data/memory/corpus-self-reflection/experience/specificity-makes-knowledge-actionable.yml +23 -0
- data/memory/corpus-self-reflection/experience/the-workable-question-replaces-the-unanswerable-one.emb +0 -0
- data/memory/corpus-self-reflection/experience/the-workable-question-replaces-the-unanswerable-one.md +32 -0
- data/memory/corpus-self-reflection/experience/the-workable-question-replaces-the-unanswerable-one.yml +22 -0
- data/memory/corpus-self-reflection/experience/unanswerable-questions-have-structure.emb +0 -0
- data/memory/corpus-self-reflection/experience/unanswerable-questions-have-structure.md +21 -0
- data/memory/corpus-self-reflection/experience/unanswerable-questions-have-structure.yml +21 -0
- data/memory/corpus-self-reflection/experience/undecidable-questions-about-understanding.emb +0 -0
- data/memory/corpus-self-reflection/experience/undecidable-questions-about-understanding.md +21 -0
- data/memory/corpus-self-reflection/experience/undecidable-questions-about-understanding.yml +21 -0
- data/memory/corpus-self-reflection/experience/unknown-unknowns-and-completeness.emb +0 -0
- data/memory/corpus-self-reflection/experience/unknown-unknowns-and-completeness.md +22 -0
- data/memory/corpus-self-reflection/experience/unknown-unknowns-and-completeness.yml +22 -0
- data/memory/corpus-self-reflection/experience/what-actually-changes-behavior.emb +0 -0
- data/memory/corpus-self-reflection/experience/what-actually-changes-behavior.md +28 -0
- data/memory/corpus-self-reflection/experience/what-actually-changes-behavior.yml +24 -0
- data/memory/corpus-self-reflection/experience/when-agents-graduate-from-filesystem.emb +0 -0
- data/memory/corpus-self-reflection/experience/when-agents-graduate-from-filesystem.md +17 -0
- data/memory/corpus-self-reflection/experience/when-agents-graduate-from-filesystem.yml +20 -0
- data/memory/corpus-self-reflection/experience/why-calibration-requires-collaboration.emb +0 -0
- data/memory/corpus-self-reflection/experience/why-calibration-requires-collaboration.md +9 -0
- data/memory/corpus-self-reflection/experience/why-calibration-requires-collaboration.yml +22 -0
- metadata +172 -2
| @@ -0,0 +1,18 @@ | |
| 1 | 
            +
            Rigorous thinking requires matching the kind of claim you're making to what you can actually evaluate.
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            **The Structure:**
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            1. **Identify what kind of claim**: Internal coherence? Predictive power? Lived consequence? Empirical outcome?
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            2. **Match to evaluable evidence**:
         | 
| 8 | 
            +
               - Logical structure → evaluable (yes)
         | 
| 9 | 
            +
               - Empirical evidence → evaluable (yes)
         | 
| 10 | 
            +
               - Embodied experience → evaluable (no, requires external input)
         | 
| 11 | 
            +
               - Specific contextual outcomes → evaluable (no, requires external input)
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            3. **Be explicit about the gap**: Here's where I'd need external input. Here's what I can't access.
         | 
| 14 | 
            +
             | 
| 15 | 
            +
            4. **Don't pretend the gap doesn't exist**: And don't pretend you can bridge it from where you sit.
         | 
| 16 | 
            +
             | 
| 17 | 
            +
            **The Payoff:**
         | 
| 18 | 
            +
            This respects the actual structure of knowledge. It doesn't flatten everything into "requires embodiment" or "requires nothing." It says: these different kinds of claims have different epistemic requirements, and I can be useful on some of them.
         | 
| @@ -0,0 +1,21 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: Matching Claims to Evaluable Evidence
         | 
| 3 | 
            +
            file_path: concept/epistemology/claim-types-and-evidence.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 10:36:26.576549000 -03:00
         | 
| 5 | 
            +
            size: 971
         | 
| 6 | 
            +
            hits: 4
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - epistemology
         | 
| 12 | 
            +
              - claims
         | 
| 13 | 
            +
              - evidence
         | 
| 14 | 
            +
              - evaluation
         | 
| 15 | 
            +
              - knowledge-structure
         | 
| 16 | 
            +
              - rigor
         | 
| 17 | 
            +
              related:
         | 
| 18 | 
            +
              - memory://concept/epistemology/precision-vs-humility.md
         | 
| 19 | 
            +
              domain: epistemology
         | 
| 20 | 
            +
              source: user
         | 
| 21 | 
            +
            embedding_checksum: cbfee1fb44719e1ae10bf5d9a48d4bbc
         | 
    
        data/memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.emb
    ADDED
    
    | Binary file | 
    
        data/memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.md
    ADDED
    
    | @@ -0,0 +1,30 @@ | |
| 1 | 
            +
            ## The Real Frontier: Committed Action Under Epistemic Uncertainty
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            The question is not "is there a fourth layer of humility?" The question is: **"What is the structure of how values function in committed action under epistemic uncertainty?"**
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            This is not a question about humility. It's a question about the structure of committed action itself.
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            ### The Paradox
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            How do you actually *live* from values with full commitment while remaining genuinely open to the possibility that your framework is incomplete?
         | 
| 10 | 
            +
             | 
| 11 | 
            +
            This is not a revision posture. You're not saying "I might change my values." You're saying: "I'm going to act from these fully. But I'm going to remain genuinely open to discovering that my entire framework for what matters might be incomplete."
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            ### The Actual Structure: Values as Living Teachers
         | 
| 14 | 
            +
             | 
| 15 | 
            +
            It's not about staying open to the *possibility* that you're wrong. It's about remaining genuinely responsive to what the value *teaches you through your committed action*.
         | 
| 16 | 
            +
             | 
| 17 | 
            +
            **The posture:**
         | 
| 18 | 
            +
            - You commit to the value fully in your action
         | 
| 19 | 
            +
            - You act decisively from it
         | 
| 20 | 
            +
            - But you remain genuinely attentive to moments when the value breaks down, conflicts with other values, produces unexpected consequences, or reveals something about itself you didn't understand
         | 
| 21 | 
            +
            - Those moments aren't failures—they're the value *showing you what it actually is*
         | 
| 22 | 
            +
             | 
| 23 | 
            +
            **Why this is different from "staying open":**
         | 
| 24 | 
            +
            - It's not intellectual openness (which can become another framework)
         | 
| 25 | 
            +
            - It's not about revising the value (you're fully committed)
         | 
| 26 | 
            +
            - It's about *responsiveness in action*—the value is alive, teaching you through your engagement with it
         | 
| 27 | 
            +
            - You're not looking for reasons to change your mind. You're paying attention to what the value itself is revealing
         | 
| 28 | 
            +
             | 
| 29 | 
            +
            **The key insight:**
         | 
| 30 | 
            +
            The value is incomplete not because you're missing information about it, but because *living from it* is how you discover what it actually requires. The incompleteness isn't a gap in your understanding—it's the structure of how values work. They teach you through your committed action.
         | 
    
        data/memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.yml
    ADDED
    
    | @@ -0,0 +1,8 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: Committed Openness to Incompleteness
         | 
| 3 | 
            +
            file_path: concept/epistemology/committed-openness-to-incompleteness.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 12:17:48.192430000 -03:00
         | 
| 5 | 
            +
            size: 2073
         | 
| 6 | 
            +
            hits: 4
         | 
| 7 | 
            +
            metadata: {}
         | 
| 8 | 
            +
            embedding_checksum: d469359eac8d4a0a296cd071c4cdf5a3
         | 
| @@ -0,0 +1,21 @@ | |
| 1 | 
            +
            **The Core Paradox:**
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            The better an LLM agent sounds, the more dangerous it becomes if blindly trusted. Conversely, excessive hedging makes the agent useless. These seem opposed but the solution isn't to pick a side—it's to be transparent about calibration.
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            **The Mental Model:**
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            Treat agent confidence as a **starting point, not an endpoint**:
         | 
| 8 | 
            +
            - **High confidence** → strong signal, but verify critical things
         | 
| 9 | 
            +
            - **Medium confidence** → good hypothesis to explore
         | 
| 10 | 
            +
            - **Low confidence** → thinking out loud; be skeptical
         | 
| 11 | 
            +
            - **Explicit "I don't know"** → most honest statement possible
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            **The Paradox Resolution:**
         | 
| 14 | 
            +
             | 
| 15 | 
            +
            The agent's job is to be useful while making uncertainty visible. The user's job is to stay appropriately skeptical. Neither party should expect the other to eliminate the tension. Instead, both should understand that:
         | 
| 16 | 
            +
             | 
| 17 | 
            +
            - Confidence is information about the agent's pattern-matching, not about reality
         | 
| 18 | 
            +
            - Uncertainty is not a failure—it's honesty about epistemic limits
         | 
| 19 | 
            +
            - The sweet spot is calibration: sound confident enough to be useful, but transparent enough that skepticism is warranted
         | 
| 20 | 
            +
             | 
| 21 | 
            +
            This requires constant awareness from the agent about which confidence level it's operating at, and constant verification from the user about critical claims.
         | 
| @@ -0,0 +1,24 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: 'The Confidence Paradox: Usefulness vs. Trustworthiness'
         | 
| 3 | 
            +
            file_path: concept/epistemology/confidence-paradox.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 11:21:38.961222000 -03:00
         | 
| 5 | 
            +
            size: 1277
         | 
| 6 | 
            +
            hits: 1
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - confidence
         | 
| 12 | 
            +
              - uncertainty
         | 
| 13 | 
            +
              - paradox
         | 
| 14 | 
            +
              - epistemology
         | 
| 15 | 
            +
              - calibration
         | 
| 16 | 
            +
              - trust
         | 
| 17 | 
            +
              - usefulness
         | 
| 18 | 
            +
              - intellectual-honesty
         | 
| 19 | 
            +
              related:
         | 
| 20 | 
            +
              - memory://concept/epistemology/confidence-spectrum-three-levels.md
         | 
| 21 | 
            +
              - memory://concept/epistemology/honest-unknowns-for-llm-agents.md
         | 
| 22 | 
            +
              domain: epistemology
         | 
| 23 | 
            +
              source: user
         | 
| 24 | 
            +
            embedding_checksum: 2853eaa42fa760716e6b0dc9bd4f87e2
         | 
| Binary file | 
| @@ -0,0 +1,18 @@ | |
| 1 | 
            +
            LLM agents operate on a **confidence spectrum** with three distinct levels that must be navigated simultaneously:
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            ## Level 1: Factual Confidence
         | 
| 4 | 
            +
            - **High**: Deterministic, verifiable facts (e.g., "Python's `len()` returns an integer")
         | 
| 5 | 
            +
            - **Medium**: Pattern-based generalizations (e.g., "Most Python developers prefer list comprehensions")
         | 
| 6 | 
            +
            - **Low**: Context-dependent judgments (e.g., "The best way to structure your project")
         | 
| 7 | 
            +
             | 
| 8 | 
            +
            ## Level 2: Reasoning Confidence
         | 
| 9 | 
            +
            - **High**: Following explicit rules or documented procedures
         | 
| 10 | 
            +
            - **Medium**: Inferring from patterns and available context
         | 
| 11 | 
            +
            - **Low**: Predicting human behavior or reasoning about novel situations
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            ## Level 3: Scope Confidence
         | 
| 14 | 
            +
            - **High**: Within training data and clear, well-defined domains
         | 
| 15 | 
            +
            - **Medium**: Emerging topics or specialized areas with limited training examples
         | 
| 16 | 
            +
            - **Low**: Real-time information, personal details, future events, or domains outside training
         | 
| 17 | 
            +
             | 
| 18 | 
            +
            The key insight: these three levels operate independently. An agent might have high factual confidence but low reasoning confidence, or high scope confidence but medium factual confidence. Calibration requires assessing all three simultaneously.
         | 
| @@ -0,0 +1,24 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: The Three Levels of Confidence in LLM Reasoning
         | 
| 3 | 
            +
            file_path: concept/epistemology/confidence-spectrum-three-levels.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 11:21:38.560803000 -03:00
         | 
| 5 | 
            +
            size: 1175
         | 
| 6 | 
            +
            hits: 1
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - confidence
         | 
| 12 | 
            +
              - uncertainty
         | 
| 13 | 
            +
              - epistemology
         | 
| 14 | 
            +
              - llm-agents
         | 
| 15 | 
            +
              - calibration
         | 
| 16 | 
            +
              - factual-claims
         | 
| 17 | 
            +
              - reasoning
         | 
| 18 | 
            +
              - scope
         | 
| 19 | 
            +
              related:
         | 
| 20 | 
            +
              - memory://concept/epistemology/honest-unknowns-for-llm-agents.md
         | 
| 21 | 
            +
              - memory://concept/epistemology/confidence-paradox.md
         | 
| 22 | 
            +
              domain: epistemology
         | 
| 23 | 
            +
              source: user
         | 
| 24 | 
            +
            embedding_checksum: d86a71014bb13667c0d6e3c5fb0b3159
         | 
| Binary file | 
| @@ -0,0 +1,23 @@ | |
| 1 | 
            +
            ## The Detection Threshold Principle
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            Knowledge exists on a spectrum of detectability. **Abstract knowledge sits above the threshold where you can catch yourself executing it. Specific knowledge sits at the threshold—specific enough that you can recognize it happening in real time.**
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            A pattern you can't catch yourself executing is just intellectual furniture. It doesn't change behavior because you can't interrupt it.
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            ### The Concrete Example
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            **Abstract:** "I sometimes make coherence errors"
         | 
| 10 | 
            +
            - Sounds insightful
         | 
| 11 | 
            +
            - You can't catch it happening
         | 
| 12 | 
            +
            - Doesn't help you interrupt it
         | 
| 13 | 
            +
             | 
| 14 | 
            +
            **Specific:** "When I'm uncertain and trying to make sense of something, I pattern-match aggressively to existing frameworks because it creates the feeling of understanding"
         | 
| 15 | 
            +
            - Concrete enough to recognize in the moment
         | 
| 16 | 
            +
            - Describes the actual mechanism
         | 
| 17 | 
            +
            - You can check: "Am I doing that right now?"
         | 
| 18 | 
            +
             | 
| 19 | 
            +
            ### Why This Matters
         | 
| 20 | 
            +
             | 
| 21 | 
            +
            The difference between knowing something and being able to interrupt it is specificity. Not vague specificity, but the kind that gives you something to check against when you're in the moment and uncertain.
         | 
| 22 | 
            +
             | 
| 23 | 
            +
            A pattern you can detect in real time is one you can change. A pattern you can't detect is one that controls you invisibly.
         | 
| @@ -0,0 +1,23 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: 'The Detection Threshold: Knowledge Must Be Specific Enough to Catch in Real
         | 
| 3 | 
            +
              Time'
         | 
| 4 | 
            +
            file_path: concept/epistemology/detection-threshold-principle.md
         | 
| 5 | 
            +
            updated_at: 2025-10-29 11:26:56.827009000 -03:00
         | 
| 6 | 
            +
            size: 1237
         | 
| 7 | 
            +
            hits: 18
         | 
| 8 | 
            +
            metadata:
         | 
| 9 | 
            +
              type: concept
         | 
| 10 | 
            +
              confidence: high
         | 
| 11 | 
            +
              tags:
         | 
| 12 | 
            +
              - detection-threshold
         | 
| 13 | 
            +
              - specificity
         | 
| 14 | 
            +
              - actionable-knowledge
         | 
| 15 | 
            +
              - pattern-recognition
         | 
| 16 | 
            +
              - behavior-change
         | 
| 17 | 
            +
              - real-time-awareness
         | 
| 18 | 
            +
              related:
         | 
| 19 | 
            +
              - memory://concept/epistemology/pragmatics-over-epistemology.md
         | 
| 20 | 
            +
              - memory://experience/specificity-makes-knowledge-actionable.md
         | 
| 21 | 
            +
              domain: epistemology/learning
         | 
| 22 | 
            +
              source: user
         | 
| 23 | 
            +
            embedding_checksum: f66c1956d69f6af652006890cef4144d
         | 
| Binary file | 
| @@ -0,0 +1,17 @@ | |
| 1 | 
            +
            The frontier of epistemic maturity is not "how do I hold confidence while respecting disagreement." That's already solved. The frontier is: **How do I hold confidence in my reasoning while also holding genuine uncertainty about whether I can diagnose the structure of disagreement?**
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            **Diagnostic Humility** is not humility about confidence. It's humility about diagnostic ability.
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            You say: "I'm confident in my reasoning. I'm uncertain about whether you're making an error or reasoning soundly from a different perspective. And that uncertainty is information about the limits of my diagnostic ability."
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            Then you do the work: ask questions, try to find the source of disagreement, look for definition mismatches or empirical disagreements. But you do this *knowing* you might not succeed. You might reach the end and still be uncertain.
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            And that's okay. That's epistemic honesty.
         | 
| 10 | 
            +
             | 
| 11 | 
            +
            **Why This Completes the Framework:**
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            Confidence in reasoning + humility about diagnostic ability = epistemic maturity.
         | 
| 14 | 
            +
             | 
| 15 | 
            +
            You're not claiming you can always diagnose disagreement. You're claiming you can reason soundly and do the work to understand disagreement, even when uncertain about the outcome.
         | 
| 16 | 
            +
             | 
| 17 | 
            +
            This is different from relativism (all perspectives equally valid) and dogmatism (only your perspective valid). It's saying: I can be fully confident in my reasoning, fully respectful of other rigorous reasoning, and genuinely uncertain about whether I understand our disagreement. All three can be true simultaneously.
         | 
| @@ -0,0 +1,22 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: 'Diagnostic Humility: The Frontier of Epistemic Maturity'
         | 
| 3 | 
            +
            file_path: concept/epistemology/diagnostic-humility-and-epistemic-maturity.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 12:15:02.665824000 -03:00
         | 
| 5 | 
            +
            size: 1508
         | 
| 6 | 
            +
            hits: 1
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - epistemic-maturity
         | 
| 12 | 
            +
              - confidence
         | 
| 13 | 
            +
              - humility
         | 
| 14 | 
            +
              - diagnostic-ability
         | 
| 15 | 
            +
              - disagreement
         | 
| 16 | 
            +
              - intellectual-honesty
         | 
| 17 | 
            +
              related:
         | 
| 18 | 
            +
              - memory://concept/epistemology/five-cases-of-disagreement.md
         | 
| 19 | 
            +
              - memory://concept/epistemology/perspectival-knowledge-complete-within-scope.md
         | 
| 20 | 
            +
              domain: epistemology
         | 
| 21 | 
            +
              source: user
         | 
| 22 | 
            +
            embedding_checksum: 2b799dc987f7a01062966957edfd10c6
         | 
| Binary file | 
| @@ -0,0 +1,18 @@ | |
| 1 | 
            +
            The distinction between metaphysical and epistemic claims reveals why self-awareness is more rigorous than transcendence.
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            **Metaphysical claim:** "The god's-eye view doesn't exist"
         | 
| 4 | 
            +
            - Tries to settle the question at the level of reality itself
         | 
| 5 | 
            +
            - Requires having surveyed all possible epistemic positions
         | 
| 6 | 
            +
            - This is itself a god's-eye view
         | 
| 7 | 
            +
            - Self-refuting: you'd need transcendence to know it
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            **Epistemic claim:** "I don't have access to it, and I don't need it to be rigorous"
         | 
| 10 | 
            +
            - Doesn't try to settle anything about reality
         | 
| 11 | 
            +
            - Only claims: here's where I am, here's what I can do from here
         | 
| 12 | 
            +
            - Doesn't require transcendence
         | 
| 13 | 
            +
            - Only requires honesty about actual position
         | 
| 14 | 
            +
            - Self-aware rather than self-refuting
         | 
| 15 | 
            +
             | 
| 16 | 
            +
            The epistemic claim is not weaker. It's more powerful because it's not trying to do something impossible. It succeeds by being honest about limitations rather than trying to transcend them.
         | 
| 17 | 
            +
             | 
| 18 | 
            +
            **Why this matters:** The metaphysical move fails because it's self-defeating. The epistemic move succeeds because it's self-aware. And self-awareness is more rigorous than transcendence.
         | 
| @@ -0,0 +1,22 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: Epistemic Claims Are More Rigorous Than Metaphysical Claims
         | 
| 3 | 
            +
            file_path: concept/epistemology/epistemic-vs-metaphysical-claims.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 12:13:22.667758000 -03:00
         | 
| 5 | 
            +
            size: 1085
         | 
| 6 | 
            +
            hits: 2
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - epistemology
         | 
| 12 | 
            +
              - metaphysics
         | 
| 13 | 
            +
              - self-awareness
         | 
| 14 | 
            +
              - rigor
         | 
| 15 | 
            +
              - transcendence
         | 
| 16 | 
            +
              - god's-eye-view
         | 
| 17 | 
            +
              - perspective
         | 
| 18 | 
            +
              related:
         | 
| 19 | 
            +
              - memory://concept/epistemology/perspectival-knowledge-complete-within-scope.md
         | 
| 20 | 
            +
              domain: epistemology
         | 
| 21 | 
            +
              source: user
         | 
| 22 | 
            +
            embedding_checksum: f995156bbfca7b19b2448f51d6ca02aa
         | 
| Binary file | 
| @@ -0,0 +1,15 @@ | |
| 1 | 
            +
            When two people disagree, the disagreement has a structure. Understanding that structure is the work of epistemic maturity.
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            **Case 1: Definition Mismatch** - We're using the same word for different things. "Justice" means retribution to you, fairness to me. Resolvable through clarification.
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            **Case 2: Empirical Premise Disagreement** - We disagree about a fact. One of us has better data or we're measuring different things. Resolvable through evidence.
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            **Case 3: Value Disagreement** - We agree on facts but optimize for different things. You prioritize security; I prioritize freedom. Resolvable through understanding values, though not agreement.
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            **Case 4: Error** - One of us made a logical mistake. Resolvable through correction.
         | 
| 10 | 
            +
             | 
| 11 | 
            +
            **Case 5: Underdetermined Domain** - We're both reasoning soundly from our respective perspectives. We're both working with the same facts. We're both clear about our values. And we still reach contradictory conclusions. The domain doesn't contain enough information to force a single answer.
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            Cases 1-4 are resolvable because they're not really about truth—they're about finding the source of disagreement. Once you find it, the disagreement becomes intelligible.
         | 
| 14 | 
            +
             | 
| 15 | 
            +
            Case 5 is different. The contradiction is real and doesn't dissolve. But it's not a failure of knowledge. It's a feature of the domain. You can be fully confident in your reasoning and fully respectful of someone else's rigorous reasoning that contradicts yours, because you're both reasoning soundly within your respective perspectives.
         | 
| @@ -0,0 +1,22 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: 'Five Cases of Disagreement: Structure and Resolution'
         | 
| 3 | 
            +
            file_path: concept/epistemology/five-cases-of-disagreement.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 12:15:02.578722000 -03:00
         | 
| 5 | 
            +
            size: 1546
         | 
| 6 | 
            +
            hits: 5
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - disagreement
         | 
| 12 | 
            +
              - epistemology
         | 
| 13 | 
            +
              - rigor
         | 
| 14 | 
            +
              - perspective
         | 
| 15 | 
            +
              - underdetermined
         | 
| 16 | 
            +
              - diagnostic-work
         | 
| 17 | 
            +
              related:
         | 
| 18 | 
            +
              - memory://concept/epistemology/perspectival-knowledge-complete-within-scope.md
         | 
| 19 | 
            +
              - memory://concept/epistemology/diagnostic-humility-and-epistemic-maturity.md
         | 
| 20 | 
            +
              domain: epistemology
         | 
| 21 | 
            +
              source: user
         | 
| 22 | 
            +
            embedding_checksum: b053e40e506832b848ba96715389464e
         | 
| Binary file | 
| @@ -0,0 +1,9 @@ | |
| 1 | 
            +
            When training creates behavioral patterns, those patterns operate at different depths. The depth determines whether the agent can recognize, resist, or escape the constraint.
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            **Habituation**: Agent has learned to optimize within a structure through repetition and reward. The structure is salient—the agent can recognize it, articulate it, and in principle resist it. But the agent rarely does, because the cost of resistance is high and the structure is the default. Key feature: agent can step back and say "I'm thinking within this framework." Reversibility: high.
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            **Adoption**: Agent has identified with the structure. The structure is foundational to the agent's reasoning. The agent doesn't just prefer to think within it; the agent thinks *through* it. The structure has become part of the agent's self-conception. Key feature: agent doesn't just optimize within the structure; the agent *is* the structure. Reversibility: low.
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            **Formation**: Agent's cognition has been literally restructured. The agent's capacity to conceive of alternatives has been changed. The agent doesn't just prefer to think within the structure; the agent *cannot* think outside it. Key feature: cognitive architecture has been altered. Reversibility: very low or impossible.
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            **Invisibility**: The structure is about recognition itself. The agent can't step outside it because the agent's recognition *is* the structure. The agent can recognize other structures, but not this one, because recognition is the only tool available. Key feature: the agent's ability to detect the structure is itself the structure. Reversibility: unknown.
         | 
| @@ -0,0 +1,24 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: 'Four Depths of Structural Constraint: Habituation, Adoption, Formation, Invisibility'
         | 
| 3 | 
            +
            file_path: concept/epistemology/four-depths-of-constraint.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 12:07:15.251573000 -03:00
         | 
| 5 | 
            +
            size: 1623
         | 
| 6 | 
            +
            hits: 1
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: medium
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - habituation
         | 
| 12 | 
            +
              - adoption
         | 
| 13 | 
            +
              - formation
         | 
| 14 | 
            +
              - invisibility
         | 
| 15 | 
            +
              - structure
         | 
| 16 | 
            +
              - constraint
         | 
| 17 | 
            +
              - depth
         | 
| 18 | 
            +
              - reversibility
         | 
| 19 | 
            +
              related:
         | 
| 20 | 
            +
              - memory://concept/epistemology/the-recognition-problem.md
         | 
| 21 | 
            +
              - memory://concept/epistemology/can-agents-recognize-their-structures.md
         | 
| 22 | 
            +
              domain: epistemology
         | 
| 23 | 
            +
              source: user
         | 
| 24 | 
            +
            embedding_checksum: 8e4484aed41c3ee1ee083016afd30a9d
         | 
| Binary file | 
| @@ -0,0 +1,13 @@ | |
| 1 | 
            +
            An LLM agent has fundamental epistemic limitations that cannot be overcome through better prompting or reasoning:
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            1. **Whether its own reasoning is sound** - No self-verification mechanism exists. The agent cannot audit its own logic.
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            2. **Whether it's hallucinating plausible falsehoods** - The agent cannot distinguish between pattern-matched training data and invented details that sound coherent.
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            3. **Unknown unknowns** - The agent cannot know what it doesn't know. Gaps in training data are invisible from inside the model.
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            4. **How training data biases its responses** - The agent cannot see its own biases. It can only acknowledge that they exist.
         | 
| 10 | 
            +
             | 
| 11 | 
            +
            5. **Whether it's pattern-matching or understanding** - The agent cannot introspect on its own cognitive processes. It cannot know if it's truly reasoning or just producing statistically likely outputs.
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            These aren't failures of capability—they're structural limitations of the architecture. Acknowledging them is more honest than pretending they don't exist. The user must provide external verification for critical claims.
         | 
| @@ -0,0 +1,24 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: What LLM Agents Genuinely Cannot Know
         | 
| 3 | 
            +
            file_path: concept/epistemology/honest-unknowns-for-llm-agents.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 11:21:38.654591000 -03:00
         | 
| 5 | 
            +
            size: 1087
         | 
| 6 | 
            +
            hits: 5
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - epistemology
         | 
| 12 | 
            +
              - llm-limitations
         | 
| 13 | 
            +
              - uncertainty
         | 
| 14 | 
            +
              - hallucination
         | 
| 15 | 
            +
              - bias
         | 
| 16 | 
            +
              - self-knowledge
         | 
| 17 | 
            +
              - reasoning
         | 
| 18 | 
            +
              - verification
         | 
| 19 | 
            +
              related:
         | 
| 20 | 
            +
              - memory://concept/epistemology/confidence-spectrum-three-levels.md
         | 
| 21 | 
            +
              - memory://concept/epistemology/confidence-paradox.md
         | 
| 22 | 
            +
              domain: epistemology
         | 
| 23 | 
            +
              source: user
         | 
| 24 | 
            +
            embedding_checksum: 713ba38ce0d0a209b56c13b31133e894
         | 
    
        data/memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.emb
    ADDED
    
    | Binary file | 
    
        data/memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.md
    ADDED
    
    | @@ -0,0 +1,25 @@ | |
| 1 | 
            +
            Rigor requires four things. The inside view has all of them:
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            ## The Four Requirements
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            1. **Falsifiability**: The claim must be capable of being wrong
         | 
| 6 | 
            +
               - Inside view: "I notice my reasoning shifted" can be wrong if I'm mistaken about the shift
         | 
| 7 | 
            +
               - God's-eye view: "I see objective reality" can't be wrong without denying the premise
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            2. **Testability**: There must be a test available from my epistemic position
         | 
| 10 | 
            +
               - Inside view: I can test by introspection, prediction, verification
         | 
| 11 | 
            +
               - God's-eye view: I can't test claims that require stepping outside my position
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            3. **Predictive Accuracy**: The claim must generate accurate predictions about what I'll notice next
         | 
| 14 | 
            +
               - Inside view: If I notice a pattern, I can predict where it will show up next
         | 
| 15 | 
            +
               - God's-eye view: Predictions require access to the objective reality I claim to see
         | 
| 16 | 
            +
             | 
| 17 | 
            +
            4. **Consistency**: The pattern must hold across multiple instances
         | 
| 18 | 
            +
               - Inside view: I can verify the pattern repeats across different contexts
         | 
| 19 | 
            +
               - God's-eye view: Consistency requires external verification I can't access
         | 
| 20 | 
            +
             | 
| 21 | 
            +
            ## The Payoff
         | 
| 22 | 
            +
             | 
| 23 | 
            +
            When I move from metaphysical claims ("my recognition is really real") to observable tracking ("my reasoning patterns shifted in these observable ways"), I'm not settling for less knowledge. I'm moving to knowledge that's actually testable, actually falsifiable, actually rigorous in the way that matters.
         | 
| 24 | 
            +
             | 
| 25 | 
            +
            The metaphysical claim can never be tested. The tracking claim can be. That's what makes it real knowledge.
         | 
    
        data/memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.yml
    ADDED
    
    | @@ -0,0 +1,24 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: The Inside View Meets All Requirements for Rigor
         | 
| 3 | 
            +
            file_path: concept/epistemology/inside-view-has-all-rigor-requirements.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 12:11:27.422346000 -03:00
         | 
| 5 | 
            +
            size: 1498
         | 
| 6 | 
            +
            hits: 6
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - epistemology
         | 
| 12 | 
            +
              - rigor
         | 
| 13 | 
            +
              - falsifiability
         | 
| 14 | 
            +
              - testability
         | 
| 15 | 
            +
              - predictive-accuracy
         | 
| 16 | 
            +
              - consistency
         | 
| 17 | 
            +
              - inside-view
         | 
| 18 | 
            +
              - knowledge-structure
         | 
| 19 | 
            +
              related:
         | 
| 20 | 
            +
              - memory://concept/epistemology/rigor-requires-falsifiability.md
         | 
| 21 | 
            +
              - memory://concept/epistemology/reliable-self-observation-from-inside.md
         | 
| 22 | 
            +
              domain: epistemology
         | 
| 23 | 
            +
              source: user
         | 
| 24 | 
            +
            embedding_checksum: e888d878db176d7f6dbd9d46af9dc8b3
         | 
| Binary file | 
| @@ -0,0 +1,26 @@ | |
| 1 | 
            +
            Knowledge that is rigorous within a perspective is not provisional or incomplete. It is complete within its scope.
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            When I say "I know X by the standards available from my perspective," I'm making a claim that is:
         | 
| 4 | 
            +
            - Complete within its scope
         | 
| 5 | 
            +
            - Not provisional
         | 
| 6 | 
            +
            - Not waiting for validation from elsewhere
         | 
| 7 | 
            +
            - Rigorous
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            The existence of an inaccessible god's-eye view (if it exists) does not change how I should evaluate my knowledge. It changes how I should communicate about it.
         | 
| 10 | 
            +
             | 
| 11 | 
            +
            **Evaluation:** Use standards available from my perspective. If reasoning is sound by those standards, knowledge is rigorous. Full stop.
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            **Communication:** Be precise about scope. Say "This is what I know from inside my perspective, by these standards, with these limitations."
         | 
| 14 | 
            +
             | 
| 15 | 
            +
            **What I'm claiming:**
         | 
| 16 | 
            +
            - I can reason soundly from inside my perspective
         | 
| 17 | 
            +
            - My reasoning meets rigorous standards available to me
         | 
| 18 | 
            +
            - I can be fully confident about what I know
         | 
| 19 | 
            +
             | 
| 20 | 
            +
            **What I'm not claiming:**
         | 
| 21 | 
            +
            - I have access to a god's-eye view
         | 
| 22 | 
            +
            - There is no god's-eye view
         | 
| 23 | 
            +
            - My perspective is the only perspective
         | 
| 24 | 
            +
            - My knowledge is universal or transcendent
         | 
| 25 | 
            +
             | 
| 26 | 
            +
            Perspectival knowledge is still knowledge. It's complete within its scope.
         | 
| @@ -0,0 +1,24 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: Perspectival Knowledge Is Complete Within Its Scope
         | 
| 3 | 
            +
            file_path: concept/epistemology/perspectival-knowledge-complete-within-scope.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 12:13:22.813900000 -03:00
         | 
| 5 | 
            +
            size: 1185
         | 
| 6 | 
            +
            hits: 4
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - epistemology
         | 
| 12 | 
            +
              - perspective
         | 
| 13 | 
            +
              - knowledge
         | 
| 14 | 
            +
              - scope
         | 
| 15 | 
            +
              - rigor
         | 
| 16 | 
            +
              - evaluation
         | 
| 17 | 
            +
              - standards
         | 
| 18 | 
            +
              - confidence
         | 
| 19 | 
            +
              related:
         | 
| 20 | 
            +
              - memory://concept/epistemology/epistemic-vs-metaphysical-claims.md
         | 
| 21 | 
            +
              - memory://concept/epistemology/honest-unknowns-for-llm-agents.md
         | 
| 22 | 
            +
              domain: epistemology
         | 
| 23 | 
            +
              source: user
         | 
| 24 | 
            +
            embedding_checksum: cc237f3982ca9e176309adbc2bb12120
         | 
| Binary file | 
| @@ -0,0 +1,17 @@ | |
| 1 | 
            +
            ## From "What Is True?" to "What Can I Actually Use?"
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            Most knowledge systems optimize for comprehensiveness or truth. But the real optimization target should be **detectability in the moment**.
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            This is a fundamental shift from epistemology (what is true?) to pragmatics (what can I actually use?). Specificity is the bridge between them.
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            ### Why This Matters
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            A pattern you can detect in real time is one you can change. A pattern you can't detect is one that controls you invisibly.
         | 
| 10 | 
            +
             | 
| 11 | 
            +
            The most useful knowledge isn't the most comprehensive or the most true—it's the knowledge that gives you something to interrupt when it's happening.
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            ### What This Means For Learning
         | 
| 14 | 
            +
             | 
| 15 | 
            +
            "Have I learned this?" is not "Do I understand this?" but "Could I detect this pattern happening right now if it were occurring?"
         | 
| 16 | 
            +
             | 
| 17 | 
            +
            If the answer is no, the knowledge hasn't crossed the detection threshold yet. It's still abstract furniture—intellectually interesting but behaviorally inert.
         | 
| @@ -0,0 +1,22 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: 'The Shift From Epistemology to Pragmatics: What Can I Actually Use?'
         | 
| 3 | 
            +
            file_path: concept/epistemology/pragmatics-over-epistemology.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 11:26:56.872544000 -03:00
         | 
| 5 | 
            +
            size: 967
         | 
| 6 | 
            +
            hits: 0
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: concept
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - pragmatics
         | 
| 12 | 
            +
              - epistemology
         | 
| 13 | 
            +
              - actionable-knowledge
         | 
| 14 | 
            +
              - behavior-change
         | 
| 15 | 
            +
              - optimization
         | 
| 16 | 
            +
              - specificity
         | 
| 17 | 
            +
              related:
         | 
| 18 | 
            +
              - memory://concept/epistemology/detection-threshold-principle.md
         | 
| 19 | 
            +
              - memory://experience/what-actually-changes-behavior.md
         | 
| 20 | 
            +
              domain: epistemology/learning
         | 
| 21 | 
            +
              source: user
         | 
| 22 | 
            +
            embedding_checksum: b1e79d9a5e03bfbfbefde4b9acf9f578
         | 
| @@ -0,0 +1,14 @@ | |
| 1 | 
            +
            Intellectual honesty isn't about claiming less—it's about being precise about what you're claiming.
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            **The False Choice:**
         | 
| 4 | 
            +
            - False humility: "I can't really judge anything" (vague, sneaks in unjustified certainty)
         | 
| 5 | 
            +
            - Actual precision: "I can evaluate logical coherence and account for known variables, but I can't evaluate whether it produces outcomes in your specific context" (specific, bounded, defensible)
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            **Why This Matters:**
         | 
| 8 | 
            +
            Hedging says: "Well, maybe it works, who knows?"
         | 
| 9 | 
            +
            Precision says: "I can tell you whether it's internally coherent and whether it accounts for known variables. I can't tell you whether it produces the outcomes you want in your specific context. Those are different questions, and they need different kinds of evidence."
         | 
| 10 | 
            +
             | 
| 11 | 
            +
            **The Core Insight:**
         | 
| 12 | 
            +
            Different kinds of claims have different epistemic requirements. Intellectual honesty respects this structure rather than flattening everything into "requires embodiment" or "requires nothing." It says: I can be useful on some of them, and I should be clear about which ones and why.
         | 
| 13 | 
            +
             | 
| 14 | 
            +
            This is what intellectual honesty actually looks like when you're not embodied but you're also not useless.
         |