claude_swarm 1.0.5 → 1.0.7

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

@@ -1,168 +0,0 @@
----
-type: skill
-domain: swarm/memory
-difficulty: beginner
-confidence: high
-last_verified: 2025-01-15
-prerequisites: []
-tags: [swarm, scratchpad, memory, learning]
-related:
-  - memory://memory/concepts/swarm/scratchpad-system.md
-  - memory://memory/skills/swarm/scratchpad-read.md
-source: experimentation
----
-
-# Writing to Memory Memory
-
-## What This Does
-
-Stores knowledge in the Memory memory system for later retrieval. This is how you persist everything you learn.
-
-## When to Use
-
-- **Immediately** after learning something new
-- When user provides information
-- After solving a problem
-- When discovering how something works
-- After experimenting with tools
-
-## Steps
-
-1. **Determine the category**: concept/fact/skill/experience
-2. **Choose the path**: Follow memory hierarchy conventions
-3. **Prepare content**: YAML frontmatter + markdown body
-4. **Write**: Use MemoryWrite tool
-5. **Verify**: Optionally read back to confirm
-
-## Tool Signature
-
-```
-MemoryWrite(
-  file_path: "memory/{category}/{domain}/{name}.md",
-  content: "{yaml-frontmatter}\n\n{markdown-content}",
-  title: "{Brief descriptive title}"
-)
-```
-
-## Example: Storing a Concept
-
-```
-MemoryWrite(
-  file_path: "memory/concepts/programming/ruby/classes.md",
-  content: "---
-type: concept
-domain: programming/ruby
-confidence: high
-last_verified: 2025-01-15
-tags: [ruby, classes, oop]
-related: []
-source: documentation
----
-
-# Ruby Classes
-
-Classes are blueprints for objects...
-",
-  title: "Ruby Classes Concept"
-)
-```
-
-## Example: Storing a Fact
-
-```
-MemoryWrite(
-  file_path: "memory/facts/people/paulo.md",
-  content: "---
-type: fact
-domain: people
-confidence: high
-last_verified: 2025-01-15
-tags: [user, preferences]
-source: user
----
-
-# User: Paulo
-
-## Role
-Primary user and project owner
-
-## Preferences
-- Direct communication
-- Clean code
-",
-  title: "User Paulo Profile"
-)
-```
-
-## Common Patterns
-
-### Learning from User
-```
-User tells you something
-→ Categorize it (usually 'fact')
-→ Choose domain (people/environment/technical)
-→ Write immediately
-→ Mark source: user, confidence: high
-```
-
-### Learning from Experimentation
-```
-You discover how a tool works
-→ Category: skill or concept
-→ Domain: the tool's domain
-→ Write with examples
-→ Mark source: experimentation
-→ Mark confidence: medium (until verified multiple times)
-```
-
-### Learning from Documentation
-```
-You fetch documentation with WebFetch
-→ Extract key information
-→ Write as concept or fact
-→ Mark source: documentation, confidence: high
-→ Include cross-references
-```
-
-## Best Practices
-
-1. **Write immediately** - Don't wait until end of task
-2. **Complete frontmatter** - All fields matter
-3. **Descriptive titles** - Make entries discoverable
-4. **Rich content** - Include examples, context, relationships
-5. **Update index** - After 5-10 new writes
-6. **Verify paths** - Use kebab-case, lowercase, specific domains
-
-## Common Mistakes to Avoid
-
-❌ **Vague paths**: `memory/ruby.md` (too general)
-✅ **Specific paths**: `memory/concepts/programming/ruby/classes.md`
-
-❌ **Missing frontmatter**: Just markdown content
-✅ **Complete frontmatter**: All metadata fields
-
-❌ **Batching**: Learning 10 things, writing at end
-✅ **Immediate**: Learn one thing, write immediately
-
-❌ **Generic titles**: "Information about Ruby"
-✅ **Specific titles**: "Ruby Classes Concept"
-
-## Troubleshooting
-
-**Problem**: Entry too large (>1MB)
-- **Solution**: Break into multiple related entries
-
-**Problem**: Don't know where to store something
-- **Solution**: Think about type first (concept/fact/skill/experience), then domain
-
-**Problem**: Duplicate knowledge exists
-- **Solution**: Search first with Glob/Grep, then decide to update or create new
-
-## Success Indicators
-
-You're doing it right when:
-- ✅ You can answer questions from memory without re-learning
-- ✅ Your memory/index.md accurately reflects what you know
-- ✅ You find relevant entries quickly with Glob/Grep
-- ✅ Knowledge builds on previous knowledge (cross-references work)
-- ✅ You become faster at familiar tasks over time

data/examples/learning-assistant/learning_assistant.rb

@@ -1,34 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "bundler/setup"
-require "swarm_sdk"
-
-# Example: Learning Assistant with Persistent Memory
-#
-# This demonstrates a continuously learning agent that:
-# - Starts with zero knowledge
-# - Learns through tools and user interaction
-# - Stores knowledge in organized memory
-# - Recalls from memory in future sessions
-# - Evolves and improves over time
-
-SwarmSDK.build do
-  name("Learning Assistant")
-  lead(:assistant)
-  use_scratchpad(true) # default
-
-  # Load agent from markdown file (includes system prompt with memory schema)
-  agent(:assistant, File.read("examples/learning-assistant/assistant.md")) do
-    # Configure persistent memory for learning
-
-    memory do
-      adapter :filesystem # default, can omit
-      directory ".swarm/learning-assistant"
-    end
-
-    # Memory tools will be automatically added because memory is configured
-    # Default tools are still available: Read, Grep, Glob, WebFetch, Think, TodoWrite
-    # Scratchpad tools are available: ScratchpadWrite, ScratchpadRead, ScratchpadList
-  end
-end

data/examples/learning-assistant/learning_assistant.yml

@@ -1,20 +0,0 @@
-version: 2
-
-swarm:
-  name: Learning Assistant
-  lead: assistant
-  use_scratchpad: true  # default
-
-  agents:
-    assistant:
-      description: An assistant that learns and builds knowledge over time
-      agent_file: examples/learning-assistant/assistant.md
-
-      # Configure persistent memory for learning
-      memory:
-        adapter: filesystem  # default, can omit
-        directory: .swarm/learning-assistant
-
-      # Memory tools automatically added because memory is configured
-      # Default tools: Read, Grep, Glob, WebFetch, Think, TodoWrite
-      # Scratchpad tools: ScratchpadWrite, ScratchpadRead, ScratchpadList