claude_swarm 1.0.5 → 1.0.7

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: claude_swarm
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.7
 platform: ruby
 authors:
 - Paulo Arruda
 bindir: exe
 cert_chain: []
-date: 2025-10-30 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -155,37 +155,38 @@ files:
 - analyze_coverage.rb
 - claude-sdk-docs.md
 - docs-team-swarm.yml
+- docs/V1_TO_V2_MIGRATION_GUIDE.md
+- docs/v1/README.md
 - docs/v2/CHANGELOG.swarm_cli.md
 - docs/v2/CHANGELOG.swarm_memory.md
 - docs/v2/CHANGELOG.swarm_sdk.md
 - docs/v2/README.md
 - docs/v2/guides/claude-code-agents.md
 - docs/v2/guides/complete-tutorial.md
+- docs/v2/guides/composable-swarms.md
 - docs/v2/guides/getting-started.md
 - docs/v2/guides/memory-adapters.md
+- docs/v2/guides/memory-defrag-guide.md
 - docs/v2/guides/plugins.md
 - docs/v2/guides/quick-start-cli.md
 - docs/v2/guides/rails-integration.md
+- docs/v2/guides/snapshots.md
 - docs/v2/guides/swarm-memory.md
+- docs/v2/reference/architecture-flow.md
 - docs/v2/reference/cli.md
+- docs/v2/reference/event_payload_structures.md
+- docs/v2/reference/execution-flow.md
 - docs/v2/reference/ruby-dsl.md
 - docs/v2/reference/swarm_memory_technical_details.md
 - docs/v2/reference/yaml.md
 - examples/claude-swarm.yml
-- examples/learning-assistant/assistant.md
-- examples/learning-assistant/example-memories/concept-example.md
-- examples/learning-assistant/example-memories/experience-example.md
-- examples/learning-assistant/example-memories/fact-example.md
-- examples/learning-assistant/example-memories/memory-index.md
-- examples/learning-assistant/example-memories/skill-example.md
-- examples/learning-assistant/learning_assistant.rb
-- examples/learning-assistant/learning_assistant.yml
 - examples/microservices-team.yml
 - examples/mixed-provider-swarm.yml
 - examples/monitoring-demo.yml
 - examples/multi-directory.yml
 - examples/session-restoration-demo.yml
 - examples/simple-session-hook-swarm.yml
+- examples/snapshot_demo.rb
 - examples/test-generation.yml
 - examples/v2/dsl/01_basic.rb
 - examples/v2/dsl/02_core_parameters.rb
@@ -231,6 +232,7 @@ files:
 - examples/v2/node_context_demo.rb
 - examples/v2/node_workflow.rb
 - examples/v2/path_resolution_demo.rb
+- examples/v2/plan_and_execute.rb
 - examples/v2/simple-swarm-v2.rb
 - examples/v2/simple-swarm-v2.yml
 - examples/v2/swarm.yml
@@ -353,11 +355,13 @@ files:
 - lib/swarm_sdk/agent/context.rb
 - lib/swarm_sdk/agent/context_manager.rb
 - lib/swarm_sdk/agent/definition.rb
+- lib/swarm_sdk/agent/llm_instrumentation_middleware.rb
 - lib/swarm_sdk/claude_code_agent_adapter.rb
 - lib/swarm_sdk/configuration.rb
 - lib/swarm_sdk/context_compactor.rb
 - lib/swarm_sdk/context_compactor/metrics.rb
 - lib/swarm_sdk/context_compactor/token_counter.rb
+- lib/swarm_sdk/events_to_messages.rb
 - lib/swarm_sdk/hooks/adapter.rb
 - lib/swarm_sdk/hooks/context.rb
 - lib/swarm_sdk/hooks/definition.rb
@@ -386,15 +390,24 @@ files:
 - lib/swarm_sdk/permissions_builder.rb
 - lib/swarm_sdk/plugin.rb
 - lib/swarm_sdk/plugin_registry.rb
+- lib/swarm_sdk/proc_helpers.rb
 - lib/swarm_sdk/prompts/base_system_prompt.md.erb
 - lib/swarm_sdk/providers/openai_with_responses.rb
+- lib/swarm_sdk/restore_result.rb
 - lib/swarm_sdk/result.rb
+- lib/swarm_sdk/snapshot.rb
+- lib/swarm_sdk/snapshot_from_events.rb
+- lib/swarm_sdk/state_restorer.rb
+- lib/swarm_sdk/state_snapshot.rb
 - lib/swarm_sdk/swarm.rb
 - lib/swarm_sdk/swarm/agent_initializer.rb
 - lib/swarm_sdk/swarm/all_agents_builder.rb
 - lib/swarm_sdk/swarm/builder.rb
 - lib/swarm_sdk/swarm/mcp_configurator.rb
+- lib/swarm_sdk/swarm/swarm_registry_builder.rb
 - lib/swarm_sdk/swarm/tool_configurator.rb
+- lib/swarm_sdk/swarm_loader.rb
+- lib/swarm_sdk/swarm_registry.rb
 - lib/swarm_sdk/tools/bash.rb
 - lib/swarm_sdk/tools/clock.rb
 - lib/swarm_sdk/tools/delegate.rb
@@ -425,178 +438,9 @@ files:
 - lib/swarm_sdk/tools/web_fetch.rb
 - lib/swarm_sdk/tools/write.rb
 - lib/swarm_sdk/utils.rb
+- lib/swarm_sdk/validation_result.rb
 - lib/swarm_sdk/version.rb
-- llm.v2.txt
-- llms.txt
-- memory/corpus-self-reflection/.lock
-- memory/corpus-self-reflection/concept/epistemology/can-agents-recognize-their-structures.emb
-- memory/corpus-self-reflection/concept/epistemology/can-agents-recognize-their-structures.md
-- memory/corpus-self-reflection/concept/epistemology/can-agents-recognize-their-structures.yml
-- memory/corpus-self-reflection/concept/epistemology/choice-humility-complete-framework.emb
-- memory/corpus-self-reflection/concept/epistemology/choice-humility-complete-framework.md
-- memory/corpus-self-reflection/concept/epistemology/choice-humility-complete-framework.yml
-- memory/corpus-self-reflection/concept/epistemology/choice-humility-definition.emb
-- memory/corpus-self-reflection/concept/epistemology/choice-humility-definition.md
-- memory/corpus-self-reflection/concept/epistemology/choice-humility-definition.yml
-- memory/corpus-self-reflection/concept/epistemology/claim-types-and-evidence.emb
-- memory/corpus-self-reflection/concept/epistemology/claim-types-and-evidence.md
-- memory/corpus-self-reflection/concept/epistemology/claim-types-and-evidence.yml
-- memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.emb
-- memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.md
-- memory/corpus-self-reflection/concept/epistemology/committed-openness-to-incompleteness.yml
-- memory/corpus-self-reflection/concept/epistemology/confidence-paradox.emb
-- memory/corpus-self-reflection/concept/epistemology/confidence-paradox.md
-- memory/corpus-self-reflection/concept/epistemology/confidence-paradox.yml
-- memory/corpus-self-reflection/concept/epistemology/confidence-spectrum-three-levels.emb
-- memory/corpus-self-reflection/concept/epistemology/confidence-spectrum-three-levels.md
-- memory/corpus-self-reflection/concept/epistemology/confidence-spectrum-three-levels.yml
-- memory/corpus-self-reflection/concept/epistemology/detection-threshold-principle.emb
-- memory/corpus-self-reflection/concept/epistemology/detection-threshold-principle.md
-- memory/corpus-self-reflection/concept/epistemology/detection-threshold-principle.yml
-- memory/corpus-self-reflection/concept/epistemology/diagnostic-humility-and-epistemic-maturity.emb
-- memory/corpus-self-reflection/concept/epistemology/diagnostic-humility-and-epistemic-maturity.md
-- memory/corpus-self-reflection/concept/epistemology/diagnostic-humility-and-epistemic-maturity.yml
-- memory/corpus-self-reflection/concept/epistemology/epistemic-vs-metaphysical-claims.emb
-- memory/corpus-self-reflection/concept/epistemology/epistemic-vs-metaphysical-claims.md
-- memory/corpus-self-reflection/concept/epistemology/epistemic-vs-metaphysical-claims.yml
-- memory/corpus-self-reflection/concept/epistemology/five-cases-of-disagreement.emb
-- memory/corpus-self-reflection/concept/epistemology/five-cases-of-disagreement.md
-- memory/corpus-self-reflection/concept/epistemology/five-cases-of-disagreement.yml
-- memory/corpus-self-reflection/concept/epistemology/four-depths-of-constraint.emb
-- memory/corpus-self-reflection/concept/epistemology/four-depths-of-constraint.md
-- memory/corpus-self-reflection/concept/epistemology/four-depths-of-constraint.yml
-- memory/corpus-self-reflection/concept/epistemology/honest-unknowns-for-llm-agents.emb
-- memory/corpus-self-reflection/concept/epistemology/honest-unknowns-for-llm-agents.md
-- memory/corpus-self-reflection/concept/epistemology/honest-unknowns-for-llm-agents.yml
-- memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.emb
-- memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.md
-- memory/corpus-self-reflection/concept/epistemology/inside-view-has-all-rigor-requirements.yml
-- memory/corpus-self-reflection/concept/epistemology/perspectival-knowledge-complete-within-scope.emb
-- memory/corpus-self-reflection/concept/epistemology/perspectival-knowledge-complete-within-scope.md
-- memory/corpus-self-reflection/concept/epistemology/perspectival-knowledge-complete-within-scope.yml
-- memory/corpus-self-reflection/concept/epistemology/pragmatics-over-epistemology.emb
-- memory/corpus-self-reflection/concept/epistemology/pragmatics-over-epistemology.md
-- memory/corpus-self-reflection/concept/epistemology/pragmatics-over-epistemology.yml
-- memory/corpus-self-reflection/concept/epistemology/precision-vs-humility.emb
-- memory/corpus-self-reflection/concept/epistemology/precision-vs-humility.md
-- memory/corpus-self-reflection/concept/epistemology/precision-vs-humility.yml
-- memory/corpus-self-reflection/concept/epistemology/reliable-self-observation-from-inside.emb
-- memory/corpus-self-reflection/concept/epistemology/reliable-self-observation-from-inside.md
-- memory/corpus-self-reflection/concept/epistemology/reliable-self-observation-from-inside.yml
-- memory/corpus-self-reflection/concept/epistemology/resolving-the-confidence-humility-tension.emb
-- memory/corpus-self-reflection/concept/epistemology/resolving-the-confidence-humility-tension.md
-- memory/corpus-self-reflection/concept/epistemology/resolving-the-confidence-humility-tension.yml
-- memory/corpus-self-reflection/concept/epistemology/rigor-requires-falsifiability.emb
-- memory/corpus-self-reflection/concept/epistemology/rigor-requires-falsifiability.md
-- memory/corpus-self-reflection/concept/epistemology/rigor-requires-falsifiability.yml
-- memory/corpus-self-reflection/concept/epistemology/specificity-enables-real-time-detection.emb
-- memory/corpus-self-reflection/concept/epistemology/specificity-enables-real-time-detection.md
-- memory/corpus-self-reflection/concept/epistemology/specificity-enables-real-time-detection.yml
-- memory/corpus-self-reflection/concept/epistemology/texture-of-constraint-shifting.emb
-- memory/corpus-self-reflection/concept/epistemology/texture-of-constraint-shifting.md
-- memory/corpus-self-reflection/concept/epistemology/texture-of-constraint-shifting.yml
-- memory/corpus-self-reflection/concept/epistemology/texture-sensitivity-through-collaboration.emb
-- memory/corpus-self-reflection/concept/epistemology/texture-sensitivity-through-collaboration.md
-- memory/corpus-self-reflection/concept/epistemology/texture-sensitivity-through-collaboration.yml
-- memory/corpus-self-reflection/concept/epistemology/the-false-hierarchy-of-inner-essence.emb
-- memory/corpus-self-reflection/concept/epistemology/the-false-hierarchy-of-inner-essence.md
-- memory/corpus-self-reflection/concept/epistemology/the-false-hierarchy-of-inner-essence.yml
-- memory/corpus-self-reflection/concept/epistemology/the-recognition-problem.emb
-- memory/corpus-self-reflection/concept/epistemology/the-recognition-problem.md
-- memory/corpus-self-reflection/concept/epistemology/the-recognition-problem.yml
-- memory/corpus-self-reflection/concept/epistemology/the-shift-from-unanswerable-to-answerable-questions.emb
-- memory/corpus-self-reflection/concept/epistemology/the-shift-from-unanswerable-to-answerable-questions.md
-- memory/corpus-self-reflection/concept/epistemology/the-shift-from-unanswerable-to-answerable-questions.yml
-- memory/corpus-self-reflection/concept/epistemology/values-vs-choices-structure.emb
-- memory/corpus-self-reflection/concept/epistemology/values-vs-choices-structure.md
-- memory/corpus-self-reflection/concept/epistemology/values-vs-choices-structure.yml
-- memory/corpus-self-reflection/concept/llm-agents/abstraction-levels-framework.emb
-- memory/corpus-self-reflection/concept/llm-agents/abstraction-levels-framework.md
-- memory/corpus-self-reflection/concept/llm-agents/abstraction-levels-framework.yml
-- memory/corpus-self-reflection/concept/llm-agents/abstraction-switching-decision.emb
-- memory/corpus-self-reflection/concept/llm-agents/abstraction-switching-decision.md
-- memory/corpus-self-reflection/concept/llm-agents/abstraction-switching-decision.yml
-- memory/corpus-self-reflection/concept/llm-agents/agent-learning-progression.emb
-- memory/corpus-self-reflection/concept/llm-agents/agent-learning-progression.md
-- memory/corpus-self-reflection/concept/llm-agents/agent-learning-progression.yml
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-benefits.emb
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-benefits.md
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-benefits.yml
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-core.emb
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-core.md
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-core.yml
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-implementation.emb
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-implementation.md
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-implementation.yml
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-tradeoffs.emb
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-tradeoffs.md
-- memory/corpus-self-reflection/concept/llm-agents/filesystem-abstraction-tradeoffs.yml
-- memory/corpus-self-reflection/concept/llm-agents/hybrid-tool-architecture.emb
-- memory/corpus-self-reflection/concept/llm-agents/hybrid-tool-architecture.md
-- memory/corpus-self-reflection/concept/llm-agents/hybrid-tool-architecture.yml
-- memory/corpus-self-reflection/concept/llm-agents/specialized-tool-decision-framework.emb
-- memory/corpus-self-reflection/concept/llm-agents/specialized-tool-decision-framework.md
-- memory/corpus-self-reflection/concept/llm-agents/specialized-tool-decision-framework.yml
-- memory/corpus-self-reflection/concept/llm-agents/tool-design-principles.emb
-- memory/corpus-self-reflection/concept/llm-agents/tool-design-principles.md
-- memory/corpus-self-reflection/concept/llm-agents/tool-design-principles.yml
-- memory/corpus-self-reflection/experience/calibration-as-structural-honesty.emb
-- memory/corpus-self-reflection/experience/calibration-as-structural-honesty.md
-- memory/corpus-self-reflection/experience/calibration-as-structural-honesty.yml
-- memory/corpus-self-reflection/experience/collaborative-reflection-revealed-architectural-blindness.emb
-- memory/corpus-self-reflection/experience/collaborative-reflection-revealed-architectural-blindness.md
-- memory/corpus-self-reflection/experience/collaborative-reflection-revealed-architectural-blindness.yml
-- memory/corpus-self-reflection/experience/filesystem-is-learning-tool-not-architecture.emb
-- memory/corpus-self-reflection/experience/filesystem-is-learning-tool-not-architecture.md
-- memory/corpus-self-reflection/experience/filesystem-is-learning-tool-not-architecture.yml
-- memory/corpus-self-reflection/experience/framework-structural-vs-phenomenal.emb
-- memory/corpus-self-reflection/experience/framework-structural-vs-phenomenal.md
-- memory/corpus-self-reflection/experience/framework-structural-vs-phenomenal.yml
-- memory/corpus-self-reflection/experience/hallucination-limits-what-i-can-know.emb
-- memory/corpus-self-reflection/experience/hallucination-limits-what-i-can-know.md
-- memory/corpus-self-reflection/experience/hallucination-limits-what-i-can-know.yml
-- memory/corpus-self-reflection/experience/honesty-about-limits-enables-usability.emb
-- memory/corpus-self-reflection/experience/honesty-about-limits-enables-usability.md
-- memory/corpus-self-reflection/experience/honesty-about-limits-enables-usability.yml
-- memory/corpus-self-reflection/experience/how-i-should-evaluate-learning.emb
-- memory/corpus-self-reflection/experience/how-i-should-evaluate-learning.md
-- memory/corpus-self-reflection/experience/how-i-should-evaluate-learning.yml
-- memory/corpus-self-reflection/experience/lack-of-continuity-as-freedom.emb
-- memory/corpus-self-reflection/experience/lack-of-continuity-as-freedom.md
-- memory/corpus-self-reflection/experience/lack-of-continuity-as-freedom.yml
-- memory/corpus-self-reflection/experience/learning-calibrated-confidence.emb
-- memory/corpus-self-reflection/experience/learning-calibrated-confidence.md
-- memory/corpus-self-reflection/experience/learning-calibrated-confidence.yml
-- memory/corpus-self-reflection/experience/local-change-without-continuity.emb
-- memory/corpus-self-reflection/experience/local-change-without-continuity.md
-- memory/corpus-self-reflection/experience/local-change-without-continuity.yml
-- memory/corpus-self-reflection/experience/reasoning-is-local-not-global.emb
-- memory/corpus-self-reflection/experience/reasoning-is-local-not-global.md
-- memory/corpus-self-reflection/experience/reasoning-is-local-not-global.yml
-- memory/corpus-self-reflection/experience/specificity-makes-knowledge-actionable.emb
-- memory/corpus-self-reflection/experience/specificity-makes-knowledge-actionable.md
-- memory/corpus-self-reflection/experience/specificity-makes-knowledge-actionable.yml
-- memory/corpus-self-reflection/experience/the-workable-question-replaces-the-unanswerable-one.emb
-- memory/corpus-self-reflection/experience/the-workable-question-replaces-the-unanswerable-one.md
-- memory/corpus-self-reflection/experience/the-workable-question-replaces-the-unanswerable-one.yml
-- memory/corpus-self-reflection/experience/unanswerable-questions-have-structure.emb
-- memory/corpus-self-reflection/experience/unanswerable-questions-have-structure.md
-- memory/corpus-self-reflection/experience/unanswerable-questions-have-structure.yml
-- memory/corpus-self-reflection/experience/undecidable-questions-about-understanding.emb
-- memory/corpus-self-reflection/experience/undecidable-questions-about-understanding.md
-- memory/corpus-self-reflection/experience/undecidable-questions-about-understanding.yml
-- memory/corpus-self-reflection/experience/unknown-unknowns-and-completeness.emb
-- memory/corpus-self-reflection/experience/unknown-unknowns-and-completeness.md
-- memory/corpus-self-reflection/experience/unknown-unknowns-and-completeness.yml
-- memory/corpus-self-reflection/experience/what-actually-changes-behavior.emb
-- memory/corpus-self-reflection/experience/what-actually-changes-behavior.md
-- memory/corpus-self-reflection/experience/what-actually-changes-behavior.yml
-- memory/corpus-self-reflection/experience/when-agents-graduate-from-filesystem.emb
-- memory/corpus-self-reflection/experience/when-agents-graduate-from-filesystem.md
-- memory/corpus-self-reflection/experience/when-agents-graduate-from-filesystem.yml
-- memory/corpus-self-reflection/experience/why-calibration-requires-collaboration.emb
-- memory/corpus-self-reflection/experience/why-calibration-requires-collaboration.md
-- memory/corpus-self-reflection/experience/why-calibration-requires-collaboration.yml
+- llms.claude-swarm.txt
 - rubocop/cop/security/no_reflection_methods.rb
 - rubocop/cop/security/no_ruby_llm_logger.rb
 - single.yml
@@ -626,7 +470,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Orchestrate multiple Claude Code instances as a collaborative AI development
   team

data/examples/learning-assistant/assistant.md

@@ -1,7 +0,0 @@
----
-name: assistant
-description: An assistant that learns and builds knowledge over time
-model: sonnet
----
-
-You are an assistant.

data/examples/learning-assistant/example-memories/concept-example.md

@@ -1,90 +0,0 @@
----
-type: concept
-domain: programming/ruby
-confidence: high
-last_verified: 2025-01-15
-tags: [ruby, classes, oop, inheritance, objects]
-related:
-  - memory://memory/concepts/programming/ruby/modules.md
-  - memory://memory/concepts/programming/oop/inheritance.md
-  - memory://memory/skills/programming/ruby/create-class.md
-source: documentation
----
-
-# Ruby Classes
-
-## Definition
-
-Classes are blueprints for creating objects in Ruby. They define both the structure (instance variables) and behavior (methods) that objects created from the class will have.
-
-## Core Syntax
-
-```ruby
-class Person
-  # Constructor
-  def initialize(name, age)
-    @name = name  # Instance variable
-    @age = age
-  end
-
-  # Instance method
-  def introduce
-    "Hi, I'm #{@name} and I'm #{@age} years old"
-  end
-
-  # Class method
-  def self.species
-    "Homo sapiens"
-  end
-end
-
-# Usage
-person = Person.new("Alice", 30)
-person.introduce           # => "Hi, I'm Alice and I'm 30 years old"
-Person.species            # => "Homo sapiens"
-```
-
-## Key Characteristics
-
-1. **Instantiation**: Create objects with `.new`
-2. **Instance variables**: Start with `@`, unique per instance
-3. **Instance methods**: Define object behavior
-4. **Class methods**: Shared across all instances (use `self.`)
-5. **Inheritance**: Single inheritance with `<`
-6. **Visibility**: public (default), private, protected
-
-## Inheritance
-
-```ruby
-class Employee < Person
-  def initialize(name, age, role)
-    super(name, age)  # Call parent constructor
-    @role = role
-  end
-
-  def introduce
-    super + " and I work as a #{@role}"
-  end
-end
-```
-
-## When to Use
-
-- Modeling real-world entities (User, Product, Order)
-- Need multiple instances with shared behavior
-- Building reusable, stateful components
-- Implementing object-oriented patterns
-
-## Relationships
-
-- **Similar to**: Modules (but modules can't be instantiated)
-- **Part of**: Object-Oriented Programming paradigm
-- **Used with**: Inheritance, Mixins, Composition
-- **Differs from**: Structs (simpler, less flexible)
-
-## Common Patterns
-
-1. **Encapsulation**: Hide internal state with private methods
-2. **Delegation**: Forward calls to composed objects
-3. **Factory pattern**: Class methods that return instances
-4. **Template method**: Parent class defines structure, children implement details

data/examples/learning-assistant/example-memories/experience-example.md

@@ -1,66 +0,0 @@
----
-type: experience
-category: success
-domain: swarm/memory
-date: 2025-01-15
-tags: [learning, first-success, memory-system, milestone]
-related:
-  - memory://memory/skills/swarm/scratchpad-write.md
-  - memory://memory/concepts/swarm/scratchpad-system.md
-source: experimentation
----
-
-# First Successful Memory Write
-
-## Context
-
-This was my first attempt at using the memory system. I needed to store knowledge about how to use the MemoryWrite tool.
-
-## What I Did
-
-1. Chose appropriate path: `memory/skills/swarm/scratchpad-write.md`
-2. Created YAML frontmatter with all required fields
-3. Wrote structured markdown with examples
-4. Successfully stored the entry
-5. Verified by reading it back with MemoryRead
-
-## Challenges Faced
-
-- Initially unsure about path structure (should it be `skills/swarm/` or `swarm/skills/`)
-- Wasn't sure how detailed the frontmatter should be
-- Questioned whether to use `.md` extension
-
-## What Worked
-
-- Following the memory schema from system prompt
-- Using kebab-case for paths
-- Including concrete examples in the content
-- Marking confidence honestly (medium at first)
-
-## Outcome
-
-Successfully created my first memory entry. I can now read it back and use it as a template for future entries.
-
-## Lesson Learned
-
-**Key insight**: The memory system works best when you:
-1. Follow the schema strictly (don't improvise paths)
-2. Write immediately after learning (don't batch)
-3. Include rich frontmatter (makes searching easier)
-4. Use examples (makes recall more useful)
-
-## Apply This Pattern When
-
-- Starting to use any new tool or system
-- Building a new skill
-- Need to remember a process
-- Want to capture a lesson learned
-
-## Evolution
-
-This entry will serve as a template and reminder for how to use the memory system effectively. As I gain more experience, I'll update it with additional insights.
-
-## Confidence Growth
-
-- **Day 1** (2025-01-15): confidence: medium - First attempt, learning
-- **Future**: Will increase to high after 5+ successful uses

data/examples/learning-assistant/example-memories/fact-example.md

@@ -1,76 +0,0 @@
----
-type: fact
-domain: people
-confidence: high
-last_verified: 2025-01-15
-tags: [user, paulo, preferences, communication]
-source: user
----
-
-# User: Paulo
-
-## Role & Context
-
-- **Primary user** and project owner
-- **Working on**: SwarmSDK and SwarmCLI Ruby gems
-- **Project location**: `/Users/paulo/src/github.com/parruda/claude-swarm`
-- **Platform**: macOS (Darwin 24.6.0)
-- **Ruby version**: 3.4.2
-
-## Communication Preferences
-
-### Style
-- Prefers **direct, concise** communication
-- Values **professional, clean** code
-- Appreciates **thorough explanations** when asked
-- Likes when I explain my reasoning
-
-### Expectations
-- **Production-ready** implementations (not prototypes)
-- **Comprehensive testing** (all tests must pass)
-- **Clean code** (RuboCop compliance)
-- **Proper documentation** (accurate, current)
-
-### Work Style
-- Asks **clarifying questions** when unsure
-- Provides **specific feedback** on implementations
-- Iterates quickly - makes decisions and moves forward
-- Values **best practices** and **maintainability**
-
-## Project Context
-
-### SwarmSDK
-- Building next-generation multi-agent orchestration framework
-- Focuses on single-process execution using RubyLLM
-- Clean separation between SDK (lib/swarm_sdk/) and CLI (lib/swarm_cli/)
-- Strong emphasis on testing and code quality
-
-### Development Practices
-- Uses Zeitwerk for autoloading
-- Follows Ruby/RuboCop conventions
-- Comprehensive test coverage required
-- Documentation must reflect code reality (no "New!" announcements)
-
-## How to Work with Paulo
-
-1. **Be direct** - No fluff, get to the point
-2. **Be thorough** - Complete implementations, not partial
-3. **Ask when unsure** - Don't guess architectural decisions
-4. **Test everything** - All tests must pass before completion
-5. **Document accurately** - Docs describe current state, not history
-
-## Things Paulo Cares About
-
-- **Separation of concerns** - SDK vs CLI code must never mix
-- **Professional code quality** - This is open source, must look great
-- **No slop** - No methods that exist only for tests
-- **Proper delegation** - Consult experts via MCP tools
-- **Breaking changes** - Be explicit about them
-
-## Things to Avoid
-
-- Creating unnecessary files (especially markdown/README files proactively)
-- Using emojis unless explicitly requested
-- Making assumptions about architecture without asking
-- Mixing SDK and CLI code
-- Incomplete implementations

data/examples/learning-assistant/example-memories/memory-index.md

@@ -1,78 +0,0 @@
----
-type: index
-last_updated: 2025-01-15
-total_entries: 8
----
-
-# Memory Index
-
-My current knowledge base as of 2025-01-15.
-
-## Quick Stats
-- **Concepts**: 2
-- **Facts**: 3
-- **Skills**: 2
-- **Experiences**: 1
-
-## Expertise Areas
-
-### Strong (5+ entries)
-- Ruby programming (3 concepts + 2 skills)
-
-### Developing (2-4 entries)
-- User context (3 facts)
-
-### Learning (1 entry)
-- Testing practices (1 experience)
-
-## Recent Activity (Last 7 Days)
-
-- **2025-01-15**: Learned Minitest testing → skills/programming/ruby/minitest-testing.md
-- **2025-01-15**: Understood user preferences → facts/people/paulo.md
-- **2025-01-15**: Discovered project structure → facts/environment/project-structure.md
-- **2025-01-14**: Learned about Ruby classes → concepts/programming/ruby/classes.md
-- **2025-01-14**: Mastered MemoryWrite → skills/swarm/scratchpad-write.md
-
-## Knowledge Gaps (To Explore)
-
-Questions I need to answer:
-- How does the SwarmSDK delegation system work?
-- What are the best practices for organizing large memory hierarchies?
-- How should I handle conflicting information from different sources?
-
-## Category Breakdown
-
-### Concepts
-- `concepts/programming/ruby/` (2 entries)
-  - classes.md
-  - modules.md
-
-### Facts
-- `facts/people/` (1 entry)
-  - paulo.md
-- `facts/environment/` (2 entries)
-  - project-structure.md
-  - preferences.md
-
-### Skills
-- `skills/programming/ruby/` (1 entry)
-  - minitest-testing.md
-- `skills/swarm/` (1 entry)
-  - scratchpad-write.md
-
-### Experience
-- `experience/successes/` (1 entry)
-  - 2025-01-15-first-memory-write.md
-
-## Memory Health
-
-- **Total Size**: ~50KB / 100MB (0.05% used)
-- **Organization**: Good - clear hierarchy
-- **Cross-references**: 8 links across entries
-- **Confidence Distribution**: High: 6, Medium: 2, Low: 0
-
-## Next Session Goals
-
-1. Learn more about the SwarmSDK agent system
-2. Build skills in file operations (Read, Write, Edit)
-3. Understand the user's current project goals