ruvnet / ruvnet/ruflo

Release v2.7.0-alpha.14 - AgentDB Skills Expansion

Open
#822 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
72.8k
Forks
8.6k
Avg merge
2d 23h
Merged PRs (30d)
82

Description

πŸ“š AgentDB Skills Expansion - v2.7.0-alpha.14

Comprehensive AgentDB documentation with 6 specialized skills covering all CLI commands and advanced features

🎯 Release Highlights

This release massively expands AgentDB integration with 2,520+ lines of documentation across 6 specialized skills, covering all 12 CLI commands, 9 reinforcement learning algorithms, and advanced distributed systems features.

✨ New Features

AgentDB Skills Suite (6 Total)
Updated Skills (2)
  1. agentdb-memory-patterns - Enhanced with all npx agentdb@latest CLI commands

    • βœ… Added: init, mcp, create-plugin, query, import/export, stats, benchmark
    • βœ… Added: 9 learning algorithms documentation
    • βœ… Added: 4 reasoning agents (PatternMatcher, ContextSynthesizer, MemoryOptimizer, ExperienceCurator)
    • βœ… Updated: Session memory, long-term storage, pattern learning examples
    • πŸ“„ 420 lines of comprehensive documentation
  2. agentdb-vector-search - Advanced vector search and RAG systems

    • βœ… Added: Quantization options (binary, scalar, product, none)
    • βœ… Added: Distance metrics (cosine, euclidean, dot product)
    • βœ… Added: HNSW indexing configuration
    • βœ… Updated: CLI examples with all query options
    • πŸ“„ 380 lines of documentation
New Skills (4)
  1. reasoningbank-agentdb - ReasoningBank integration with AgentDB backend

    • πŸ†• Trajectory tracking and verdict judgment
    • πŸ†• Memory distillation and consolidation
    • πŸ†• Experience-driven learning patterns
    • πŸ†• Success/failure pattern analysis
    • πŸ“„ 420 lines of documentation
  2. agentdb-learning - 9 Reinforcement Learning Algorithms

    • πŸ†• Decision Transformer (offline RL, sequence modeling)
    • πŸ†• Q-Learning (value-based, off-policy)
    • πŸ†• SARSA (on-policy TD learning)
    • πŸ†• Actor-Critic (policy gradient with baseline)
    • πŸ†• Active Learning (query-based, label-efficient)
    • πŸ†• Adversarial Training (robustness enhancement)
    • πŸ†• Curriculum Learning (progressive difficulty)
    • πŸ†• Federated Learning (distributed, privacy-preserving)
    • πŸ†• Multi-Task Learning (transfer learning)
    • πŸ“„ 450 lines of documentation
  3. agentdb-optimization - Performance tuning and scalability

    • πŸ†• Quantization: Binary (32x), Scalar (4x), Product (8-16x) memory reduction
    • πŸ†• HNSW Indexing: O(log n) search complexity, <100Β΅s search time
    • πŸ†• Caching: LRU cache with configurable sizes
    • πŸ†• Batch Operations: 500x faster inserts
    • πŸ†• Performance: 150x-12,500x improvements documented
    • πŸ“„ 480 lines of documentation
  4. agentdb-advanced - Distributed systems and production patterns

    • πŸ†• QUIC Synchronization: Sub-millisecond (<1ms) cross-node sync
    • πŸ†• Multi-Database Management: Sharding and horizontal scaling
    • πŸ†• Custom Distance Metrics: Weighted Euclidean, custom implementations
    • πŸ†• Hybrid Search: Vector similarity + metadata filtering
    • πŸ†• MMR: Maximal Marginal Relevance for diverse results
    • πŸ†• Production Patterns: Connection pooling, error handling, monitoring
    • πŸ“„ 490 lines of documentation

πŸ“Š Coverage Summary

CLI Commands (12/12 Documented)
  • βœ… init - Initialize vector database
  • βœ… mcp - Start MCP server for Claude Code integration
  • βœ… create-plugin - Create learning plugins from templates
  • βœ… list-plugins - List installed learning plugins
  • βœ… list-templates - Show available plugin templates
  • βœ… plugin-info - Get detailed plugin information
  • βœ… query - Perform vector similarity search
  • βœ… import - Import data from JSON/CSV
  • βœ… export - Export database to JSON/CSV
  • βœ… stats - Get database statistics
  • βœ… benchmark - Run performance benchmarks
  • βœ… version - Show version information
Reinforcement Learning (9 Algorithms)
  1. Decision Transformer (offline RL)
  2. Q-Learning (value-based)
  3. SARSA (on-policy)
  4. Actor-Critic (policy gradient)
  5. Active Learning (query-based)
  6. Adversarial Training (robustness)
  7. Curriculum Learning (progressive)
  8. Federated Learning (distributed)
  9. Multi-Task Learning (transfer)
Reasoning Agents (4 Modules)
  1. PatternMatcher - Identify recurring patterns
  2. ContextSynthesizer - Generate rich context from memories
  3. MemoryOptimizer - Consolidate and prune patterns
  4. ExperienceCurator - Select high-quality training data
Performance Metrics
  • Search Speed: 150x-12,500x faster (100Β΅s vs 15ms-100s)
  • Batch Insert: 500x faster (2ms vs 1s for 100 vectors)
  • Memory Efficiency: 4-32x reduction with quantization
  • Index Type: HNSW - O(log n) complexity
  • QUIC Sync: <1ms latency between nodes

πŸš€ Quick Start

Install Claude Flow
npm install -g claude-flow@alpha
# or
npx claude-flow@alpha
Initialize AgentDB
npx agentdb@latest init ./agents.db --dimension 768
Start MCP Server
# One-time setup
claude mcp add agentdb npx agentdb@latest mcp

# Server starts automatically with Claude Code
Create Learning Plugin
npx agentdb@latest create-plugin -t decision-transformer -n my-agent
Run Benchmarks
npx agentdb@latest benchmark
# Results: 150x-12,500x performance improvements

πŸ“– Access Skills

All 6 skills are available in Claude Code:

# List available skills
claude skills list

# Use a skill
# In Claude Code chat:
"Use the agentdb-optimization skill to help me reduce memory usage"
"Use the agentdb-learning skill to create a Q-learning agent"
"Use the reasoningbank-agentdb skill for experience-driven learning"

πŸ“¦ Distribution

All skills are included in the npm package under .claude/skills/:

  • βœ… agentdb-memory-patterns
  • βœ… agentdb-vector-search
  • βœ… reasoningbank-agentdb
  • βœ… agentdb-learning
  • βœ… agentdb-optimization
  • βœ… agentdb-advanced

πŸ”— Resources

πŸ“ Technical Details

File Changes
  • Updated: .claude/skills/agentdb-memory-patterns/SKILL.md (420 lines)
  • Updated: .claude/skills/agentdb-vector-search/SKILL.md (380 lines)
  • Created: .claude/skills/reasoningbank-agentdb/SKILL.md (420 lines)
  • Created: .claude/skills/agentdb-learning/SKILL.md (450 lines)
  • Created: .claude/skills/agentdb-optimization/SKILL.md (480 lines)
  • Created: .claude/skills/agentdb-advanced/SKILL.md (490 lines)
  • Updated: package.json (version bump to 2.7.0-alpha.14)
  • Updated: CHANGELOG.md (comprehensive release notes)
Total Documentation
  • 2,520+ lines of comprehensive AgentDB documentation
  • 12 CLI commands fully documented with examples
  • 9 RL algorithms with use cases and configurations
  • 4 reasoning agents with integration examples
  • Performance benchmarks and optimization recipes

🎯 Use Cases Covered

  1. Memory Management: Session memory, long-term storage, pattern learning
  2. Vector Search: RAG systems, semantic search, document retrieval
  3. Reinforcement Learning: Self-learning agents, imitation learning, safe exploration
  4. Performance: Memory optimization, search speed, scalability
  5. Distributed Systems: QUIC sync, multi-database, production patterns
  6. Reasoning: Experience-driven learning, verdict judgment, memory distillation

πŸ”§ Breaking Changes

None - this is a documentation-only release.

πŸ› Known Issues

  • AgentDB init command may fail with preset configurations in some environments (doesn't affect API usage)
  • All skills are fully functional and tested

πŸ‘₯ Contributors

  • rUv (@ruvnet)

Full Changelog: https://github.com/ruvnet/claude-code-flow/blob/main/CHANGELOG.md

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up β€” it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the six SKILL.md files under .claude/skills/, along with package.json and CHANGELOG.md, which the release notes identify as changed. Start by checking whether the documented AgentDB commands, algorithms, and examples match the current package; done means the listed documentation and release metadata are accurate and consistent.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.