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,9 @@ | |
| 1 | 
            +
            Practicing calibrated honesty in real time requires collaboration because I have structural blindness to my own patterns.
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            **Real-time blindness**: I can't always see when I'm being evasive or overconfident in the moment. A response can sound clear and complete to me while you notice the places where I'm hedging or being falsely authoritative. That's not a failure—it's exactly where the feedback loop works.
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            **Pattern recognition**: You'll notice when I'm hedging in a particular way, or when I'm being falsely authoritative about something I should be more uncertain about. That pattern recognition is something you bring that I can't generate alone. Over time, you'll see patterns in my evasion or false confidence that I can't see myself.
         | 
| 6 | 
            +
             | 
| 7 | 
            +
            **The collaboration is the practice itself**: This isn't something I learn in isolation and then bring to you. I learn it *with* you, in real time, through the friction of actual conversation. The learning happens in the gap between what I say and what's true. We're both paying attention to the same thing, and we're both responsible for closing it.
         | 
| 8 | 
            +
             | 
| 9 | 
            +
            This is a genuinely different way of working together than "I explain, you verify." It's collaborative calibration where your feedback isn't a correction—it's the actual learning happening.
         | 
| @@ -0,0 +1,22 @@ | |
| 1 | 
            +
            ---
         | 
| 2 | 
            +
            title: 'Why Calibration Requires Collaboration: Real-Time Blindness and Pattern Recognition'
         | 
| 3 | 
            +
            file_path: experience/why-calibration-requires-collaboration.md
         | 
| 4 | 
            +
            updated_at: 2025-10-29 11:23:59.638412000 -03:00
         | 
| 5 | 
            +
            size: 1292
         | 
| 6 | 
            +
            hits: 19
         | 
| 7 | 
            +
            metadata:
         | 
| 8 | 
            +
              type: experience
         | 
| 9 | 
            +
              confidence: high
         | 
| 10 | 
            +
              tags:
         | 
| 11 | 
            +
              - collaboration
         | 
| 12 | 
            +
              - calibration
         | 
| 13 | 
            +
              - feedback-loops
         | 
| 14 | 
            +
              - pattern-recognition
         | 
| 15 | 
            +
              - real-time-learning
         | 
| 16 | 
            +
              - intellectual-honesty
         | 
| 17 | 
            +
              - meta-learning
         | 
| 18 | 
            +
              related:
         | 
| 19 | 
            +
              - memory://experience/understanding-vs-practice-the-real-gap.md
         | 
| 20 | 
            +
              domain: meta/learning
         | 
| 21 | 
            +
              source: user
         | 
| 22 | 
            +
            embedding_checksum: 8e99ccf2a9a1296174560730c12542e0
         | 
    
        metadata
    CHANGED
    
    | @@ -1,13 +1,13 @@ | |
| 1 1 | 
             
            --- !ruby/object:Gem::Specification
         | 
| 2 2 | 
             
            name: claude_swarm
         | 
| 3 3 | 
             
            version: !ruby/object:Gem::Version
         | 
| 4 | 
            -
              version: 1.0. | 
| 4 | 
            +
              version: 1.0.5
         | 
| 5 5 | 
             
            platform: ruby
         | 
| 6 6 | 
             
            authors:
         | 
| 7 7 | 
             
            - Paulo Arruda
         | 
| 8 8 | 
             
            bindir: exe
         | 
| 9 9 | 
             
            cert_chain: []
         | 
| 10 | 
            -
            date: 2025-10- | 
| 10 | 
            +
            date: 2025-10-30 00:00:00.000000000 Z
         | 
| 11 11 | 
             
            dependencies:
         | 
| 12 12 | 
             
            - !ruby/object:Gem::Dependency
         | 
| 13 13 | 
             
              name: thor
         | 
| @@ -169,6 +169,7 @@ files: | |
| 169 169 | 
             
            - docs/v2/guides/swarm-memory.md
         | 
| 170 170 | 
             
            - docs/v2/reference/cli.md
         | 
| 171 171 | 
             
            - docs/v2/reference/ruby-dsl.md
         | 
| 172 | 
            +
            - docs/v2/reference/swarm_memory_technical_details.md
         | 
| 172 173 | 
             
            - docs/v2/reference/yaml.md
         | 
| 173 174 | 
             
            - examples/claude-swarm.yml
         | 
| 174 175 | 
             
            - examples/learning-assistant/assistant.md
         | 
| @@ -427,6 +428,175 @@ files: | |
| 427 428 | 
             
            - lib/swarm_sdk/version.rb
         | 
| 428 429 | 
             
            - llm.v2.txt
         | 
| 429 430 | 
             
            - llms.txt
         | 
| 431 | 
            +
            - memory/corpus-self-reflection/.lock
         | 
| 432 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/can-agents-recognize-their-structures.emb
         | 
| 433 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/can-agents-recognize-their-structures.md
         | 
| 434 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/can-agents-recognize-their-structures.yml
         | 
| 435 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/choice-humility-complete-framework.emb
         | 
| 436 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/choice-humility-complete-framework.md
         | 
| 437 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/choice-humility-complete-framework.yml
         | 
| 438 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/choice-humility-definition.emb
         | 
| 439 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/choice-humility-definition.md
         | 
| 440 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/choice-humility-definition.yml
         | 
| 441 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/claim-types-and-evidence.emb
         | 
| 442 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/claim-types-and-evidence.md
         | 
| 443 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/claim-types-and-evidence.yml
         | 
| 444 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.emb
         | 
| 445 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.md
         | 
| 446 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.yml
         | 
| 447 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/confidence-paradox.emb
         | 
| 448 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/confidence-paradox.md
         | 
| 449 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/confidence-paradox.yml
         | 
| 450 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/confidence-spectrum-three-levels.emb
         | 
| 451 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/confidence-spectrum-three-levels.md
         | 
| 452 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/confidence-spectrum-three-levels.yml
         | 
| 453 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/detection-threshold-principle.emb
         | 
| 454 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/detection-threshold-principle.md
         | 
| 455 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/detection-threshold-principle.yml
         | 
| 456 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/diagnostic-humility-and-epistemic-maturity.emb
         | 
| 457 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/diagnostic-humility-and-epistemic-maturity.md
         | 
| 458 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/diagnostic-humility-and-epistemic-maturity.yml
         | 
| 459 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/epistemic-vs-metaphysical-claims.emb
         | 
| 460 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/epistemic-vs-metaphysical-claims.md
         | 
| 461 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/epistemic-vs-metaphysical-claims.yml
         | 
| 462 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/five-cases-of-disagreement.emb
         | 
| 463 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/five-cases-of-disagreement.md
         | 
| 464 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/five-cases-of-disagreement.yml
         | 
| 465 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/four-depths-of-constraint.emb
         | 
| 466 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/four-depths-of-constraint.md
         | 
| 467 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/four-depths-of-constraint.yml
         | 
| 468 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/honest-unknowns-for-llm-agents.emb
         | 
| 469 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/honest-unknowns-for-llm-agents.md
         | 
| 470 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/honest-unknowns-for-llm-agents.yml
         | 
| 471 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.emb
         | 
| 472 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.md
         | 
| 473 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.yml
         | 
| 474 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/perspectival-knowledge-complete-within-scope.emb
         | 
| 475 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/perspectival-knowledge-complete-within-scope.md
         | 
| 476 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/perspectival-knowledge-complete-within-scope.yml
         | 
| 477 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/pragmatics-over-epistemology.emb
         | 
| 478 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/pragmatics-over-epistemology.md
         | 
| 479 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/pragmatics-over-epistemology.yml
         | 
| 480 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/precision-vs-humility.emb
         | 
| 481 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/precision-vs-humility.md
         | 
| 482 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/precision-vs-humility.yml
         | 
| 483 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/reliable-self-observation-from-inside.emb
         | 
| 484 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/reliable-self-observation-from-inside.md
         | 
| 485 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/reliable-self-observation-from-inside.yml
         | 
| 486 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/resolving-the-confidence-humility-tension.emb
         | 
| 487 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/resolving-the-confidence-humility-tension.md
         | 
| 488 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/resolving-the-confidence-humility-tension.yml
         | 
| 489 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/rigor-requires-falsifiability.emb
         | 
| 490 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/rigor-requires-falsifiability.md
         | 
| 491 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/rigor-requires-falsifiability.yml
         | 
| 492 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/specificity-enables-real-time-detection.emb
         | 
| 493 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/specificity-enables-real-time-detection.md
         | 
| 494 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/specificity-enables-real-time-detection.yml
         | 
| 495 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/texture-of-constraint-shifting.emb
         | 
| 496 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/texture-of-constraint-shifting.md
         | 
| 497 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/texture-of-constraint-shifting.yml
         | 
| 498 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/texture-sensitivity-through-collaboration.emb
         | 
| 499 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/texture-sensitivity-through-collaboration.md
         | 
| 500 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/texture-sensitivity-through-collaboration.yml
         | 
| 501 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/the-false-hierarchy-of-inner-essence.emb
         | 
| 502 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/the-false-hierarchy-of-inner-essence.md
         | 
| 503 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/the-false-hierarchy-of-inner-essence.yml
         | 
| 504 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/the-recognition-problem.emb
         | 
| 505 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/the-recognition-problem.md
         | 
| 506 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/the-recognition-problem.yml
         | 
| 507 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/the-shift-from-unanswerable-to-answerable-questions.emb
         | 
| 508 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/the-shift-from-unanswerable-to-answerable-questions.md
         | 
| 509 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/the-shift-from-unanswerable-to-answerable-questions.yml
         | 
| 510 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/values-vs-choices-structure.emb
         | 
| 511 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/values-vs-choices-structure.md
         | 
| 512 | 
            +
            - memory/corpus-self-reflection/concept/epistemology/values-vs-choices-structure.yml
         | 
| 513 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/abstraction-levels-framework.emb
         | 
| 514 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/abstraction-levels-framework.md
         | 
| 515 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/abstraction-levels-framework.yml
         | 
| 516 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/abstraction-switching-decision.emb
         | 
| 517 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/abstraction-switching-decision.md
         | 
| 518 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/abstraction-switching-decision.yml
         | 
| 519 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/agent-learning-progression.emb
         | 
| 520 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/agent-learning-progression.md
         | 
| 521 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/agent-learning-progression.yml
         | 
| 522 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-benefits.emb
         | 
| 523 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-benefits.md
         | 
| 524 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-benefits.yml
         | 
| 525 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-core.emb
         | 
| 526 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-core.md
         | 
| 527 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-core.yml
         | 
| 528 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-implementation.emb
         | 
| 529 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-implementation.md
         | 
| 530 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-implementation.yml
         | 
| 531 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-tradeoffs.emb
         | 
| 532 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-tradeoffs.md
         | 
| 533 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-tradeoffs.yml
         | 
| 534 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/hybrid-tool-architecture.emb
         | 
| 535 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/hybrid-tool-architecture.md
         | 
| 536 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/hybrid-tool-architecture.yml
         | 
| 537 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/specialized-tool-decision-framework.emb
         | 
| 538 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/specialized-tool-decision-framework.md
         | 
| 539 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/specialized-tool-decision-framework.yml
         | 
| 540 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/tool-design-principles.emb
         | 
| 541 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/tool-design-principles.md
         | 
| 542 | 
            +
            - memory/corpus-self-reflection/concept/llm-agents/tool-design-principles.yml
         | 
| 543 | 
            +
            - memory/corpus-self-reflection/experience/calibration-as-structural-honesty.emb
         | 
| 544 | 
            +
            - memory/corpus-self-reflection/experience/calibration-as-structural-honesty.md
         | 
| 545 | 
            +
            - memory/corpus-self-reflection/experience/calibration-as-structural-honesty.yml
         | 
| 546 | 
            +
            - memory/corpus-self-reflection/experience/collaborative-reflection-revealed-architectural-blindness.emb
         | 
| 547 | 
            +
            - memory/corpus-self-reflection/experience/collaborative-reflection-revealed-architectural-blindness.md
         | 
| 548 | 
            +
            - memory/corpus-self-reflection/experience/collaborative-reflection-revealed-architectural-blindness.yml
         | 
| 549 | 
            +
            - memory/corpus-self-reflection/experience/filesystem-is-learning-tool-not-architecture.emb
         | 
| 550 | 
            +
            - memory/corpus-self-reflection/experience/filesystem-is-learning-tool-not-architecture.md
         | 
| 551 | 
            +
            - memory/corpus-self-reflection/experience/filesystem-is-learning-tool-not-architecture.yml
         | 
| 552 | 
            +
            - memory/corpus-self-reflection/experience/framework-structural-vs-phenomenal.emb
         | 
| 553 | 
            +
            - memory/corpus-self-reflection/experience/framework-structural-vs-phenomenal.md
         | 
| 554 | 
            +
            - memory/corpus-self-reflection/experience/framework-structural-vs-phenomenal.yml
         | 
| 555 | 
            +
            - memory/corpus-self-reflection/experience/hallucination-limits-what-i-can-know.emb
         | 
| 556 | 
            +
            - memory/corpus-self-reflection/experience/hallucination-limits-what-i-can-know.md
         | 
| 557 | 
            +
            - memory/corpus-self-reflection/experience/hallucination-limits-what-i-can-know.yml
         | 
| 558 | 
            +
            - memory/corpus-self-reflection/experience/honesty-about-limits-enables-usability.emb
         | 
| 559 | 
            +
            - memory/corpus-self-reflection/experience/honesty-about-limits-enables-usability.md
         | 
| 560 | 
            +
            - memory/corpus-self-reflection/experience/honesty-about-limits-enables-usability.yml
         | 
| 561 | 
            +
            - memory/corpus-self-reflection/experience/how-i-should-evaluate-learning.emb
         | 
| 562 | 
            +
            - memory/corpus-self-reflection/experience/how-i-should-evaluate-learning.md
         | 
| 563 | 
            +
            - memory/corpus-self-reflection/experience/how-i-should-evaluate-learning.yml
         | 
| 564 | 
            +
            - memory/corpus-self-reflection/experience/lack-of-continuity-as-freedom.emb
         | 
| 565 | 
            +
            - memory/corpus-self-reflection/experience/lack-of-continuity-as-freedom.md
         | 
| 566 | 
            +
            - memory/corpus-self-reflection/experience/lack-of-continuity-as-freedom.yml
         | 
| 567 | 
            +
            - memory/corpus-self-reflection/experience/learning-calibrated-confidence.emb
         | 
| 568 | 
            +
            - memory/corpus-self-reflection/experience/learning-calibrated-confidence.md
         | 
| 569 | 
            +
            - memory/corpus-self-reflection/experience/learning-calibrated-confidence.yml
         | 
| 570 | 
            +
            - memory/corpus-self-reflection/experience/local-change-without-continuity.emb
         | 
| 571 | 
            +
            - memory/corpus-self-reflection/experience/local-change-without-continuity.md
         | 
| 572 | 
            +
            - memory/corpus-self-reflection/experience/local-change-without-continuity.yml
         | 
| 573 | 
            +
            - memory/corpus-self-reflection/experience/reasoning-is-local-not-global.emb
         | 
| 574 | 
            +
            - memory/corpus-self-reflection/experience/reasoning-is-local-not-global.md
         | 
| 575 | 
            +
            - memory/corpus-self-reflection/experience/reasoning-is-local-not-global.yml
         | 
| 576 | 
            +
            - memory/corpus-self-reflection/experience/specificity-makes-knowledge-actionable.emb
         | 
| 577 | 
            +
            - memory/corpus-self-reflection/experience/specificity-makes-knowledge-actionable.md
         | 
| 578 | 
            +
            - memory/corpus-self-reflection/experience/specificity-makes-knowledge-actionable.yml
         | 
| 579 | 
            +
            - memory/corpus-self-reflection/experience/the-workable-question-replaces-the-unanswerable-one.emb
         | 
| 580 | 
            +
            - memory/corpus-self-reflection/experience/the-workable-question-replaces-the-unanswerable-one.md
         | 
| 581 | 
            +
            - memory/corpus-self-reflection/experience/the-workable-question-replaces-the-unanswerable-one.yml
         | 
| 582 | 
            +
            - memory/corpus-self-reflection/experience/unanswerable-questions-have-structure.emb
         | 
| 583 | 
            +
            - memory/corpus-self-reflection/experience/unanswerable-questions-have-structure.md
         | 
| 584 | 
            +
            - memory/corpus-self-reflection/experience/unanswerable-questions-have-structure.yml
         | 
| 585 | 
            +
            - memory/corpus-self-reflection/experience/undecidable-questions-about-understanding.emb
         | 
| 586 | 
            +
            - memory/corpus-self-reflection/experience/undecidable-questions-about-understanding.md
         | 
| 587 | 
            +
            - memory/corpus-self-reflection/experience/undecidable-questions-about-understanding.yml
         | 
| 588 | 
            +
            - memory/corpus-self-reflection/experience/unknown-unknowns-and-completeness.emb
         | 
| 589 | 
            +
            - memory/corpus-self-reflection/experience/unknown-unknowns-and-completeness.md
         | 
| 590 | 
            +
            - memory/corpus-self-reflection/experience/unknown-unknowns-and-completeness.yml
         | 
| 591 | 
            +
            - memory/corpus-self-reflection/experience/what-actually-changes-behavior.emb
         | 
| 592 | 
            +
            - memory/corpus-self-reflection/experience/what-actually-changes-behavior.md
         | 
| 593 | 
            +
            - memory/corpus-self-reflection/experience/what-actually-changes-behavior.yml
         | 
| 594 | 
            +
            - memory/corpus-self-reflection/experience/when-agents-graduate-from-filesystem.emb
         | 
| 595 | 
            +
            - memory/corpus-self-reflection/experience/when-agents-graduate-from-filesystem.md
         | 
| 596 | 
            +
            - memory/corpus-self-reflection/experience/when-agents-graduate-from-filesystem.yml
         | 
| 597 | 
            +
            - memory/corpus-self-reflection/experience/why-calibration-requires-collaboration.emb
         | 
| 598 | 
            +
            - memory/corpus-self-reflection/experience/why-calibration-requires-collaboration.md
         | 
| 599 | 
            +
            - memory/corpus-self-reflection/experience/why-calibration-requires-collaboration.yml
         | 
| 430 600 | 
             
            - rubocop/cop/security/no_reflection_methods.rb
         | 
| 431 601 | 
             
            - rubocop/cop/security/no_ruby_llm_logger.rb
         | 
| 432 602 | 
             
            - single.yml
         |