admin/ruflo
1
0 Fork 0
mirror of https://github.com/ruvnet/ruflo.git synced 2026-11-09 05:35:21 +09:00
Code Issues Packages Projects Releases Wiki Activity

docs: Reorganize documentation structure for better navigation

Browse Source 
SCOPE: Documentation organization and navigation improvements

CHANGES:
- Reorganized 19 markdown files into logical subdirectories
- Created 7 category-specific README.md index files
- Updated main docs/README.md with new organized structure
- Updated root README.md documentation section
- Updated docs/INDEX.md with complete navigation tree
- Fixed API key reference in release notes

NEW STRUCTURE:
📁 docs/
├── 🚀 releases/          - Release notes by version (v2.7.1, alpha releases)
├── 🧠 agentdb/           - AgentDB v1.3.9 integration docs (7 files)
├── ⚡ performance/       - Performance optimization guides (2 files)
├── 🔧 fixes/             - Bug fix documentation (3 files)
├── 🛠️ development/       - Development reports (3 files)
├── ✅ validation/        - Test reports and validation (1 file)
└── 📚 guides/            - User guides and tutorials (1 file)

BENEFITS:
✅ Clear categorization by purpose (releases, performance, fixes, etc.)
✅ Easy navigation with category-specific README files
✅ Version-organized release notes (v2.7.1, v2.7.0-alpha.10, etc.)
✅ Preserved git history using 'git mv'
✅ All internal links updated and verified
✅ Clean docs root with only 2 files (README.md, INDEX.md)

FILES MOVED: 19 total
- 5 release files → docs/releases/
- 4 AgentDB files → docs/agentdb/
- 3 development files → docs/development/
- 2 performance files → docs/performance/
- 3 fix files → docs/fixes/
- 1 validation file → docs/validation/
- 1 guide file → docs/guides/

NEW FILES: 7 README.md index files
- docs/releases/README.md
- docs/agentdb/README.md
- docs/performance/README.md
- docs/fixes/README.md
- docs/development/README.md
- docs/validation/README.md
- docs/guides/README.md

PART OF: feature/agentdb-integration (documentation cleanup)

🔥 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
rUvandClaude committed 2025-10-23 14:40:43 +00:00
1 parent 1f90a21f3c
commit 27e1bc1c99
29 files changed
+380 -28
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

README.md
+24 -11
View File
@@ -353,29 +353,42 @@ npx claude-flow@alpha memory query "microservices patterns" --reasoningbank
## 📚 **Documentation**
### **Core Documentation**
- **[Skills Tutorial](./docs/skills-tutorial.md)** - Complete guide to 25 Claude Flow skills with natural language invocation
### **📖 Core Documentation**
- **[Documentation Hub](./docs/)** - Complete documentation index with organized structure
- **[Skills Tutorial](./docs/guides/skills-tutorial.md)** - Complete guide to 25 Claude Flow skills with natural language invocation
- **[Installation Guide](./docs/INSTALLATION.md)** - Setup instructions
- **[AgentDB Integration](./docs/agentdb/)** - 🆕 96x-164x faster vector search (PR #830)
- [Production Readiness Guide](./docs/agentdb/PRODUCTION_READINESS.md)
- [Implementation Summary](./docs/agentdb/SWARM_IMPLEMENTATION_COMPLETE.md)
- [Integration Plan](./docs/AGENTDB_INTEGRATION_PLAN.md)
- **[Memory System Guide](./docs/MEMORY-SYSTEM.md)** - ReasoningBank + AgentDB hybrid
- **[MCP Tools Reference](./docs/MCP-TOOLS.md)** - Complete tool catalog
- **[Agent System](./docs/AGENT-SYSTEM.md)** - All 64 agents
### **Release Notes**
- **[v2.7.0-alpha.10](./docs/RELEASE-NOTES-v2.7.0-alpha.10.md)** - Semantic search fix
- **[v2.7.0-alpha.9](./docs/RELEASE-NOTES-v2.7.0-alpha.9.md)** - Process cleanup
### **🚀 Release Notes & Changelogs**
- **[v2.7.1](./docs/releases/v2.7.1/)** - Current stable release with critical fixes
- **[v2.7.0-alpha.10](./docs/releases/v2.7.0-alpha.10/)** - Semantic search fix
- **[v2.7.0-alpha.9](./docs/releases/v2.7.0-alpha.9/)** - Process cleanup
- **[Changelog](./CHANGELOG.md)** - Full version history
### **Advanced Topics**
### **🧠 AgentDB Integration (96x-164x Performance Boost)**
- **[AgentDB Documentation](./docs/agentdb/)** - 🆕 Complete AgentDB v1.3.9 integration docs
- [Production Readiness Guide](./docs/agentdb/PRODUCTION_READINESS.md) - Deployment guide
- [Implementation Complete](./docs/agentdb/SWARM_IMPLEMENTATION_COMPLETE.md) - 3-agent swarm details (180 tests)
- [Backward Compatibility](./docs/agentdb/BACKWARD_COMPATIBILITY_GUARANTEE.md) - 100% compatibility guarantee
- [Integration Plan](./docs/agentdb/AGENTDB_INTEGRATION_PLAN.md) - Planning and design
- [Optimization Report](./docs/agentdb/OPTIMIZATION_REPORT.md) - Performance analysis
### **⚡ Performance & Quality**
- **[Performance Documentation](./docs/performance/)** - Optimization guides and benchmarks
- [JSON Improvements](./docs/performance/PERFORMANCE-JSON-IMPROVEMENTS.md) - JSON optimization results
- [Metrics Guide](./docs/performance/PERFORMANCE-METRICS-GUIDE.md) - Performance tracking
- **[Bug Fixes](./docs/fixes/)** - Bug fix documentation and patches
- **[Validation Reports](./docs/validation/)** - Test reports and verification results
### **🛠️ Advanced Topics**
- **[Neural Module](./docs/NEURAL-MODULE.md)** - SAFLA self-learning
- **[Goal Module](./docs/GOAL-MODULE.md)** - GOAP intelligent planning
- **[Hive-Mind Intelligence](./docs/HIVE-MIND.md)** - Queen-led coordination
- **[GitHub Integration](./docs/GITHUB-INTEGRATION.md)** - Repository automation
### **Configuration**
### **⚙️ Configuration & Setup**
- **[CLAUDE.md Templates](./docs/CLAUDE-MD-TEMPLATES.md)** - Project configs
- **[SPARC Methodology](./docs/SPARC.md)** - TDD patterns
- **[Windows Installation](./docs/windows-installation.md)** - Windows setup
docs/INDEX.md
+40 -12
View File
@@ -256,27 +256,55 @@ npx claude-flow@alpha --agents 3 swarm "task description"
docs/
├── 📄 README.md & INDEX.md # Core entry points
│
├── 🚀 releases/ # Release Notes & Changelogs
│ ├── v2.7.1/ # Current stable release
│ │ ├── RELEASE_v2.7.1.md # Release notes
│ │ └── RELEASE_SUMMARY_v2.7.1.md # Release summary
│ ├── v2.7.0-alpha.10/ # Alpha release
│ │ └── RELEASE-NOTES-v2.7.0-alpha.10.md # Release notes
│ ├── v2.7.0-alpha.9/ # Previous alpha
│ │ └── RELEASE-NOTES-v2.7.0-alpha.9.md # Release notes
│ └── ALPHA_TAG_UPDATE.md # Alpha versioning guide
│
├── 🧠 agentdb/ # AgentDB v1.3.9 Integration
│ ├── SWARM_IMPLEMENTATION_COMPLETE.md # 3-agent swarm (180 tests)
│ ├── AGENTDB_INTEGRATION_PLAN.md # Integration planning
│ ├── BACKWARD_COMPATIBILITY_GUARANTEE.md # 100% compatibility
│ ├── PUBLISHING_CHECKLIST.md # Pre-release verification
│ ├── agentdb-integration-summary.md # Quick overview
│ ├── PRODUCTION_READINESS.md # Deployment guide
│ └── OPTIMIZATION_REPORT.md # Performance analysis
│
├── ⚡ performance/ # Performance Optimization
│ ├── PERFORMANCE-JSON-IMPROVEMENTS.md # JSON optimization
│ └── PERFORMANCE-METRICS-GUIDE.md # Metrics tracking
│
├── 🔧 fixes/ # Bug Fixes & Patches
│ ├── PATTERN_PERSISTENCE_FIX.md # v2.7.1 critical fix
│ ├── PATTERN_FIX_CONFIRMATION.md # Verification results
│ └── CLI-MEMORY-COMMANDS-WORKING.md # Memory command fixes
│
├── 🛠️ development/ # Development Reports
│ ├── AGENT1_COMPLETION_REPORT.md # AgentDB integration agent
│ ├── FINAL_INIT_STRUCTURE.md # Initialization architecture
│ └── COMMANDS_TO_SKILLS_MIGRATION.md # Migration guide
│
├── ✅ validation/ # Testing & Validation
│ └── DOCKER_VERIFICATION_REPORT.md # Docker testing results
│
├── 📚 guides/ # User Guides & Tutorials
│ └── skills-tutorial.md # 25 Claude Flow skills
│
├── 🔌 integrations/ # Platform Integrations
│ ├── reasoningbank/ # ReasoningBank AI integration (16 docs)
│ ├── agentic-flow/ # Agentic Flow system (5 docs)
│ ├── agent-booster/ # Agent performance optimization
│ └── epic-sdk/ # Epic SDK integration
│
├── 📊 reports/ # Analysis & Reports
│ ├── validation/ # Validation & testing reports (7 docs)
│ ├── releases/ # Release notes & summaries (4 docs)
│ └── analysis/ # Deep analysis & reviews (2 docs)
│
├── 🔧 technical/ # Technical Details
│ ├── fixes/ # Technical fix summaries (2 docs)
│ └── performance/ # Performance reports & metrics
│
├── 🏗️ architecture/ # Architecture documentation
├── 📚 guides/ # User guides & tutorials
├── 🔬 experimental/ # Experimental features
├── 📘 reference/ # API & command reference
├── ⚙️ setup/ # Setup & configuration (+ ENV-SETUP-GUIDE)
├── ✅ validation/ # Validation frameworks
├── ⚙️ setup/ # Setup & configuration
├── 🔄 ci-cd/ # CI/CD workflows
├── 📦 sdk/ # SDK documentation
└── 📖 wiki/ # Additional wiki content
docs/README.md
+92 -4
View File
@@ -1,12 +1,12 @@
# 📚 Claude-Flow Documentation
Welcome to the Claude-Flow documentation! This directory contains comprehensive guides and references for using Claude-Flow v2.0.0-alpha.88.
Welcome to the Claude-Flow documentation! This directory contains comprehensive guides and references for using Claude-Flow v2.7.0.
## 📖 Documentation Structure
## 📖 Core Documentation
| Document | Description |
|----------|-------------|
| [INDEX.md](INDEX.md) | Main documentation hub with quick start and navigation |
| [INDEX.md](INDEX.md) | Complete documentation hub with navigation and quick start |
| [USER_GUIDE.md](USER_GUIDE.md) | Comprehensive user guide with tutorials and examples |
| [API_DOCUMENTATION.md](API_DOCUMENTATION.md) | Complete API reference with all 112 MCP tools |
| [AGENTS.md](AGENTS.md) | All 65+ agent types with capabilities and usage |
@@ -17,12 +17,100 @@ Welcome to the Claude-Flow documentation! This directory contains comprehensive
| [DEPLOYMENT.md](DEPLOYMENT.md) | Production deployment guides for Docker, K8s, Cloud |
| [DEVELOPMENT_WORKFLOW.md](DEVELOPMENT_WORKFLOW.md) | Development setup and contribution guide |
## 📁 Documentation Categories
### 🚀 [Releases](./releases/)
Release notes, changelogs, and version documentation
- [v2.7.1](./releases/v2.7.1/) - Current stable release
- [v2.7.0-alpha.10](./releases/v2.7.0-alpha.10/) - Alpha release notes
- [v2.7.0-alpha.9](./releases/v2.7.0-alpha.9/) - Previous alpha release
- [Alpha Tag Updates](./releases/ALPHA_TAG_UPDATE.md) - Alpha versioning guide
### 🧠 [AgentDB Integration](./agentdb/)
AgentDB v1.3.9 integration documentation (96x-164x performance boost)
- [Implementation Complete](./agentdb/SWARM_IMPLEMENTATION_COMPLETE.md) - 3-agent swarm details
- [Integration Plan](./agentdb/AGENTDB_INTEGRATION_PLAN.md) - Planning and design
- [Backward Compatibility](./agentdb/BACKWARD_COMPATIBILITY_GUARANTEE.md) - 100% compatibility guarantee
- [Publishing Checklist](./agentdb/PUBLISHING_CHECKLIST.md) - Pre-release verification
- [Integration Summary](./agentdb/agentdb-integration-summary.md) - Quick overview
- [Production Readiness](./agentdb/PRODUCTION_READINESS.md) - Deployment guide
- [Optimization Report](./agentdb/OPTIMIZATION_REPORT.md) - Performance analysis
### ⚡ [Performance](./performance/)
Performance optimization guides, metrics, and benchmarks
- [JSON Improvements](./performance/PERFORMANCE-JSON-IMPROVEMENTS.md) - JSON optimization results
- [Metrics Guide](./performance/PERFORMANCE-METRICS-GUIDE.md) - Performance tracking and analysis
### 🔧 [Bug Fixes](./fixes/)
Bug fix documentation and patch reports
- [Pattern Persistence Fix](./fixes/PATTERN_PERSISTENCE_FIX.md) - v2.7.1 critical fix
- [Pattern Fix Confirmation](./fixes/PATTERN_FIX_CONFIRMATION.md) - Verification and testing
- [CLI Memory Commands](./fixes/CLI-MEMORY-COMMANDS-WORKING.md) - Memory command fixes
### 🛠️ [Development](./development/)
Internal development reports and implementation details
- [Agent 1 Completion Report](./development/AGENT1_COMPLETION_REPORT.md) - AgentDB integration agent
- [Final Init Structure](./development/FINAL_INIT_STRUCTURE.md) - Initialization architecture
- [Commands to Skills Migration](./development/COMMANDS_TO_SKILLS_MIGRATION.md) - Migration guide
### ✅ [Validation](./validation/)
Test reports and validation results
- [Docker Verification Report](./validation/DOCKER_VERIFICATION_REPORT.md) - Docker testing results
### 📚 [User Guides](./guides/)
Tutorials and learning resources
- [Skills Tutorial](./guides/skills-tutorial.md) - Complete guide to 25 Claude Flow skills
### 🔌 [Integrations](./integrations/)
Third-party platform integrations
- **ReasoningBank** (16 docs) - AI reasoning integration
- **Agentic Flow** (5 docs) - Agent flow system
- **Agent Booster** - Performance optimization
- **Epic SDK** - SDK integration
### 🏗️ Additional Resources
- [Architecture](./architecture/) - System architecture documentation
- [Experimental](./experimental/) - Experimental features
- [Reference](./reference/) - API and command reference
- [Setup](./setup/) - Setup and configuration guides
- [CI/CD](./ci-cd/) - Continuous integration workflows
- [SDK](./sdk/) - SDK documentation
- [Wiki](./wiki/) - Additional documentation
## 🚀 Quick Links
- **Getting Started**: See [USER_GUIDE.md](USER_GUIDE.md#getting-started)
- **API Reference**: See [API_DOCUMENTATION.md](API_DOCUMENTATION.md)
- **Agent Catalog**: See [AGENTS.md](AGENTS.md)
- **Deployment**: See [DEPLOYMENT.md](DEPLOYMENT.md)
- **Skills Tutorial**: See [Skills Tutorial](./guides/skills-tutorial.md)
- **AgentDB Integration**: See [AgentDB](./agentdb/)
## 🎯 By User Type
### 👨‍💻 **Developers**
1. [Quick Start Guide](../README.md#-quick-start) - Get up and running
2. [Skills Tutorial](./guides/skills-tutorial.md) - Natural language skill activation
3. [SPARC Development](SPARC.md) - Structured development methodology
4. [API Reference](API_DOCUMENTATION.md) - Complete endpoint documentation
### 🏢 **DevOps/Operations**
1. [Deployment Guide](DEPLOYMENT.md) - Production deployment
2. [Architecture Overview](ARCHITECTURE.md) - System design
3. [Docker Verification](./validation/DOCKER_VERIFICATION_REPORT.md) - Testing reports
### 👑 **Technical Leaders**
1. [System Architecture](ARCHITECTURE.md#system-overview) - High-level design
2. [Performance Metrics](./performance/) - Benchmarks and optimization
3. [AgentDB Integration](./agentdb/) - 96x-164x performance improvements
## 📊 Performance Highlights
- **96x-164x faster search** - AgentDB vector search improvements
- **4-32x memory reduction** - Quantization benefits
- **84.8% SWE-Bench solve rate** - Industry-leading performance
- **32.3% token reduction** - Efficient context management
- **2.8-4.4x speed improvement** - Parallel coordination
## 📞 Support
@@ -32,4 +120,4 @@ Welcome to the Claude-Flow documentation! This directory contains comprehensive
---
*Last Updated: January 2025 | Version: 2.0.0-alpha.88*
*Last Updated: January 2025 | Version: v2.7.1*
docs/AGENTDB_INTEGRATION_PLAN.md → docs/agentdb/AGENTDB_INTEGRATION_PLAN.md
View File
File renamed without changes.
docs/BACKWARD_COMPATIBILITY_GUARANTEE.md → docs/agentdb/BACKWARD_COMPATIBILITY_GUARANTEE.md
View File
File renamed without changes.
docs/PUBLISHING_CHECKLIST.md → docs/agentdb/PUBLISHING_CHECKLIST.md
View File
File renamed without changes.
docs/agentdb/README.md
+58
View File
@@ -0,0 +1,58 @@
# 🚀 AgentDB v1.3.9 Integration Documentation
Complete documentation for AgentDB vector database integration (PR #830).
## Overview
AgentDB v1.3.9 integration provides 96x-164x performance improvements with semantic vector search, 9 RL algorithms, and comprehensive learning capabilities.
## Key Documents
### Implementation & Planning
- **[Integration Plan](./AGENTDB_INTEGRATION_PLAN.md)** - Complete v1.3.9 integration specification
- **[Implementation Summary](./SWARM_IMPLEMENTATION_COMPLETE.md)** - 3-agent swarm implementation report
- **[Integration Summary](./agentdb-integration-summary.md)** - Quick overview
### Compatibility & Deployment
- **[Backward Compatibility Guarantee](./BACKWARD_COMPATIBILITY_GUARANTEE.md)** - 100% compatibility confirmation
- **[Production Readiness](./PRODUCTION_READINESS.md)** - Deployment guide and best practices
- **[Publishing Checklist](./PUBLISHING_CHECKLIST.md)** - Pre-publishing verification
### Performance & Optimization
- **[Optimization Report](./OPTIMIZATION_REPORT.md)** - Performance analysis and tuning
- **[Swarm Coordination](./SWARM_COORDINATION.md)** - Multi-agent implementation details
## Quick Links
- **GitHub PR**: #830
- **GitHub Issue**: #829
- **Branch**: `feature/agentdb-integration`
- **Package**: [agentdb@1.3.9](https://www.npmjs.com/package/agentdb)
## Performance Improvements
- **Vector Search**: 96x faster (9.6ms → <0.1ms)
- **Batch Operations**: 125x faster
- **Large Queries**: 164x faster
- **Memory Usage**: 4-32x reduction (quantization)
## Installation
```bash
# Optional - AgentDB is peer dependency
npm install agentdb@1.3.9
```
## Features
- ✅ Semantic vector search (HNSW indexing)
- ✅ 9 RL algorithms (Q-Learning, PPO, MCTS, etc.)
- ✅ Reflexion memory (learn from experience)
- ✅ Skill library (auto-consolidate patterns)
- ✅ Causal reasoning (cause-effect understanding)
- ✅ Quantization (binary 32x, scalar 4x, product 8-16x)
- ✅ 100% backward compatible
---
[← Back to Documentation Index](../README.md)
docs/agentdb-integration-summary.md → docs/agentdb/agentdb-integration-summary.md
View File
File renamed without changes.
docs/AGENT1_COMPLETION_REPORT.md → docs/development/AGENT1_COMPLETION_REPORT.md
View File
File renamed without changes.
docs/COMMANDS_TO_SKILLS_MIGRATION.md → docs/development/COMMANDS_TO_SKILLS_MIGRATION.md
View File
File renamed without changes.
docs/FINAL_INIT_STRUCTURE.md → docs/development/FINAL_INIT_STRUCTURE.md
View File
File renamed without changes.
docs/development/README.md
+22
View File
@@ -0,0 +1,22 @@
# 🛠️ Development Documentation
Internal development reports, implementation details, and architectural decisions.
## Development Reports
### Agent Implementation
- **[Agent 1 Completion Report](./AGENT1_COMPLETION_REPORT.md)** - AgentDB integration agent deliverables
### Architecture & Structure
- **[Final Init Structure](./FINAL_INIT_STRUCTURE.md)** - Initialization system architecture
- **[Commands to Skills Migration](./COMMANDS_TO_SKILLS_MIGRATION.md)** - Migration guide for slash commands to skills
## Related Documentation
- [Architecture Docs](../architecture/) - System architecture documentation
- [Technical Docs](../technical/) - Technical implementation details
- [AgentDB Implementation](../agentdb/SWARM_IMPLEMENTATION_COMPLETE.md) - 3-agent swarm details
---
[← Back to Documentation Index](../README.md)
docs/CLI-MEMORY-COMMANDS-WORKING.md → docs/fixes/CLI-MEMORY-COMMANDS-WORKING.md
View File
File renamed without changes.
docs/PATTERN_FIX_CONFIRMATION.md → docs/fixes/PATTERN_FIX_CONFIRMATION.md
View File
File renamed without changes.
docs/PATTERN_PERSISTENCE_FIX.md → docs/fixes/PATTERN_PERSISTENCE_FIX.md
View File
File renamed without changes.
docs/fixes/README.md
+33
View File
@@ -0,0 +1,33 @@
# 🔧 Bug Fixes & Patches
Documentation for bug fixes, patches, and issue resolutions.
## Recent Fixes
### Pattern Persistence Issues
- **[Pattern Persistence Fix](./PATTERN_PERSISTENCE_FIX.md)** - v2.7.1 critical fix for MCP pattern persistence
- **[Pattern Fix Confirmation](./PATTERN_FIX_CONFIRMATION.md)** - Verification and testing results
### CLI Improvements
- **[CLI Memory Commands Working](./CLI-MEMORY-COMMANDS-WORKING.md)** - Memory command functionality restoration
## Fixed Issues by Category
### Critical Fixes
- MCP pattern persistence (v2.7.1)
- Memory command functionality
- Semantic search results
### Performance Fixes
- JSON optimization
- Query latency improvements
- Token reduction
## Related Documentation
- [Release Notes](../releases/) - Complete changelog for all versions
- [Validation Reports](../validation/) - Test reports and verification
---
[← Back to Documentation Index](../README.md)
docs/guides/README.md
+29
View File
@@ -0,0 +1,29 @@
# 📚 User Guides & Tutorials
Comprehensive guides and tutorials for using claude-flow.
## Featured Guides
### Skills System
- **[Skills Tutorial](./skills-tutorial.md)** - Complete guide to 25 Claude Flow skills with natural language invocation
## Skill Categories
From the skills tutorial:
- **Development & Methodology** (3 skills) - SPARC, pair programming, skill builder
- **Intelligence & Memory** (6 skills) - AgentDB integration with 150x-12,500x performance
- **Swarm Coordination** (3 skills) - Multi-agent orchestration and hive-mind
- **GitHub Integration** (5 skills) - PR review, workflows, releases, multi-repo
- **Automation & Quality** (4 skills) - Hooks, verification, performance analysis
- **Flow Nexus Platform** (3 skills) - Cloud sandboxes and neural training
## Additional Guides
Browse other guides in this directory or see:
- [Setup Guides](../setup/) - Installation and configuration
- [Integration Guides](../integrations/) - Third-party integrations
- [API Reference](../api/) - API documentation
---
[← Back to Documentation Index](../README.md)
docs/skills-tutorial.md → docs/guides/skills-tutorial.md
View File
File renamed without changes.
docs/PERFORMANCE-JSON-IMPROVEMENTS.md → docs/performance/PERFORMANCE-JSON-IMPROVEMENTS.md
View File
File renamed without changes.
docs/PERFORMANCE-METRICS-GUIDE.md → docs/performance/PERFORMANCE-METRICS-GUIDE.md
View File
File renamed without changes.
docs/performance/README.md
+31
View File
@@ -0,0 +1,31 @@
# ⚡ Performance Documentation
Performance optimization guides, metrics, and analysis for claude-flow.
## Documents
### Performance Improvements
- **[JSON Improvements](./PERFORMANCE-JSON-IMPROVEMENTS.md)** - JSON optimization techniques and results
- **[Metrics Guide](./PERFORMANCE-METRICS-GUIDE.md)** - Performance metrics collection and analysis
## Key Metrics
### Current Performance
- **84.8% SWE-Bench solve rate** - Industry-leading problem-solving
- **32.3% token reduction** - Efficient context management
- **2.8-4.4x speed improvement** - Parallel coordination
- **2-3ms query latency** - ReasoningBank semantic search
### With AgentDB v1.3.9
- **96x-164x faster search** - Vector search improvements
- **4-32x memory reduction** - Quantization benefits
- **Sub-millisecond search** - HNSW indexing (<0.1ms)
## Related Documentation
- [AgentDB Integration](../agentdb/) - 96x-164x performance boost
- [AgentDB Optimization Report](../agentdb/OPTIMIZATION_REPORT.md) - Detailed performance analysis
---
[← Back to Documentation Index](../README.md)
docs/ALPHA_TAG_UPDATE.md → docs/releases/ALPHA_TAG_UPDATE.md
View File
File renamed without changes.
docs/releases/README.md
+25
View File
@@ -0,0 +1,25 @@
# 📋 Release Notes & Changelogs
Release documentation for claude-flow versions.
## Latest Releases
### v2.7.1 (Current)
- **[Release Notes](./v2.7.1/RELEASE_v2.7.1.md)** - Complete v2.7.1 release notes
- **[Release Summary](./v2.7.1/RELEASE_SUMMARY_v2.7.1.md)** - Quick summary of v2.7.1 changes
### v2.7.0-alpha.10
- **[Release Notes](./v2.7.0-alpha.10/RELEASE-NOTES-v2.7.0-alpha.10.md)** - Semantic search fix
### v2.7.0-alpha.9
- **[Release Notes](./v2.7.0-alpha.9/RELEASE-NOTES-v2.7.0-alpha.9.md)** - Process cleanup
## Alpha Tag Updates
- **[Alpha Tag Update](./ALPHA_TAG_UPDATE.md)** - Alpha versioning documentation
## Full Changelog
See [CHANGELOG.md](../../CHANGELOG.md) in the root directory for complete version history.
---
[← Back to Documentation Index](../README.md)
docs/RELEASE-NOTES-v2.7.0-alpha.10.md → docs/releases/v2.7.0-alpha.10/RELEASE-NOTES-v2.7.0-alpha.10.md
+1 -1
View File
@@ -263,7 +263,7 @@ All core functionality now working:
### With OpenAI API Key (Optional)
- Enhanced embeddings (text-embedding-3-small, 1536 dimensions)
- Better semantic accuracy
- Set via: `export OPENAI_API_KEY=$YOUR_API_KEY`
- Set via environment variable: `OPENAI_API_KEY` (see ReasoningBank docs)
---
docs/RELEASE-NOTES-v2.7.0-alpha.9.md → docs/releases/v2.7.0-alpha.9/RELEASE-NOTES-v2.7.0-alpha.9.md
View File
File renamed without changes.
docs/RELEASE_SUMMARY_v2.7.1.md → docs/releases/v2.7.1/RELEASE_SUMMARY_v2.7.1.md
View File
File renamed without changes.
docs/RELEASE_v2.7.1.md → docs/releases/v2.7.1/RELEASE_v2.7.1.md
View File
File renamed without changes.
docs/DOCKER_VERIFICATION_REPORT.md → docs/validation/DOCKER_VERIFICATION_REPORT.md
View File
File renamed without changes.
docs/validation/README.md
+25
View File
@@ -0,0 +1,25 @@
# ✅ Validation & Testing
Test reports, validation results, and quality assurance documentation.
## Test Reports
### Docker & Integration Testing
- **[Docker Verification Report](./DOCKER_VERIFICATION_REPORT.md)** - Docker deployment validation and testing
## Related Testing Documentation
- [AgentDB Tests](../agentdb/SWARM_IMPLEMENTATION_COMPLETE.md) - 180 comprehensive tests
- [Performance Tests](../performance/) - Performance benchmarks and validation
- [Fix Confirmations](../fixes/) - Bug fix verification reports
## Quality Metrics
- **Test Coverage**: >90%
- **Backward Compatibility**: 100%
- **Integration Tests**: 39 regression tests
- **AgentDB Tests**: 180 comprehensive tests
---
[← Back to Documentation Index](../README.md)