claude-flow-novice 1.3.2 → 1.3.3
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.
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# Agent Coordination System
|
|
2
|
+
|
|
3
|
+
## Overview
|
|
4
|
+
The Claude-Flow coordination system manages multiple AI agents working together on complex tasks. It provides intelligent task distribution, resource management, and inter-agent communication.
|
|
5
|
+
|
|
6
|
+
## Agent Types and Capabilities
|
|
7
|
+
- **Researcher**: Web search, information gathering, knowledge synthesis
|
|
8
|
+
- **Coder**: Code analysis, development, debugging, testing
|
|
9
|
+
- **Analyst**: Data processing, pattern recognition, insights generation
|
|
10
|
+
- **Coordinator**: Task planning, resource allocation, workflow management
|
|
11
|
+
- **General**: Multi-purpose agent with balanced capabilities
|
|
12
|
+
|
|
13
|
+
## Task Management
|
|
14
|
+
- **Priority Levels**: 1 (lowest) to 10 (highest)
|
|
15
|
+
- **Dependencies**: Tasks can depend on completion of other tasks
|
|
16
|
+
- **Parallel Execution**: Independent tasks run concurrently
|
|
17
|
+
- **Load Balancing**: Automatic distribution based on agent capacity
|
|
18
|
+
|
|
19
|
+
## Coordination Commands
|
|
20
|
+
```bash
|
|
21
|
+
# Agent Management
|
|
22
|
+
npx claude-flow agent spawn <type> --name <name> --priority <1-10>
|
|
23
|
+
npx claude-flow agent list
|
|
24
|
+
npx claude-flow agent info <agent-id>
|
|
25
|
+
npx claude-flow agent terminate <agent-id>
|
|
26
|
+
|
|
27
|
+
# Task Management
|
|
28
|
+
npx claude-flow task create <type> <description> --priority <1-10> --deps <task-ids>
|
|
29
|
+
npx claude-flow task list --verbose
|
|
30
|
+
npx claude-flow task status <task-id>
|
|
31
|
+
npx claude-flow task cancel <task-id>
|
|
32
|
+
|
|
33
|
+
# System Monitoring
|
|
34
|
+
npx claude-flow status --verbose
|
|
35
|
+
npx claude-flow monitor --interval 5000
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Workflow Execution
|
|
39
|
+
Workflows are defined in JSON format and can orchestrate complex multi-agent operations:
|
|
40
|
+
```bash
|
|
41
|
+
npx claude-flow workflow examples/research-workflow.json
|
|
42
|
+
npx claude-flow workflow examples/development-config.json --async
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Advanced Features
|
|
46
|
+
- **Circuit Breakers**: Automatic failure handling and recovery
|
|
47
|
+
- **Work Stealing**: Dynamic load redistribution for efficiency
|
|
48
|
+
- **Resource Limits**: Memory and CPU usage constraints
|
|
49
|
+
- **Metrics Collection**: Performance monitoring and optimization
|
|
50
|
+
|
|
51
|
+
## Configuration
|
|
52
|
+
Coordination settings in `claude-flow.config.json`:
|
|
53
|
+
```json
|
|
54
|
+
{
|
|
55
|
+
"orchestrator": {
|
|
56
|
+
"maxConcurrentTasks": 10,
|
|
57
|
+
"taskTimeout": 300000,
|
|
58
|
+
"defaultPriority": 5
|
|
59
|
+
},
|
|
60
|
+
"agents": {
|
|
61
|
+
"maxAgents": 20,
|
|
62
|
+
"defaultCapabilities": ["research", "code", "terminal"],
|
|
63
|
+
"resourceLimits": {
|
|
64
|
+
"memory": "1GB",
|
|
65
|
+
"cpu": "50%"
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Communication Patterns
|
|
72
|
+
- **Direct Messaging**: Agent-to-agent communication
|
|
73
|
+
- **Event Broadcasting**: System-wide notifications
|
|
74
|
+
- **Shared Memory**: Common information access
|
|
75
|
+
- **Task Handoff**: Seamless work transfer between agents
|
|
76
|
+
|
|
77
|
+
## Best Practices
|
|
78
|
+
- Start with general agents and specialize as needed
|
|
79
|
+
- Use descriptive task names and clear requirements
|
|
80
|
+
- Monitor system resources during heavy workloads
|
|
81
|
+
- Implement proper error handling in workflows
|
|
82
|
+
- Regular cleanup of completed tasks and inactive agents
|
|
83
|
+
|
|
84
|
+
## Troubleshooting
|
|
85
|
+
- Check agent health with `npx claude-flow status`
|
|
86
|
+
- View detailed logs with `npx claude-flow monitor`
|
|
87
|
+
- Restart stuck agents with terminate/spawn cycle
|
|
88
|
+
- Use `--verbose` flags for detailed diagnostic information
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# Memory Bank Configuration
|
|
2
|
+
|
|
3
|
+
## Overview
|
|
4
|
+
The Claude-Flow memory system provides persistent storage and intelligent retrieval of information across agent sessions. It uses a hybrid approach combining SQL databases with semantic search capabilities.
|
|
5
|
+
|
|
6
|
+
## Storage Backends
|
|
7
|
+
- **Primary**: JSON database (`./memory/claude-flow-data.json`)
|
|
8
|
+
- **Sessions**: File-based storage in `./memory/sessions/`
|
|
9
|
+
- **Cache**: In-memory cache for frequently accessed data
|
|
10
|
+
|
|
11
|
+
## Memory Organization
|
|
12
|
+
- **Namespaces**: Logical groupings of related information
|
|
13
|
+
- **Sessions**: Time-bound conversation contexts
|
|
14
|
+
- **Indexing**: Automatic content indexing for fast retrieval
|
|
15
|
+
- **Replication**: Optional distributed storage support
|
|
16
|
+
|
|
17
|
+
## Commands
|
|
18
|
+
- `npx claude-flow memory query <search>`: Search stored information
|
|
19
|
+
- `npx claude-flow memory stats`: Show memory usage statistics
|
|
20
|
+
- `npx claude-flow memory export <file>`: Export memory to file
|
|
21
|
+
- `npx claude-flow memory import <file>`: Import memory from file
|
|
22
|
+
|
|
23
|
+
## Configuration
|
|
24
|
+
Memory settings are configured in `claude-flow.config.json`:
|
|
25
|
+
```json
|
|
26
|
+
{
|
|
27
|
+
"memory": {
|
|
28
|
+
"backend": "json",
|
|
29
|
+
"path": "./memory/claude-flow-data.json",
|
|
30
|
+
"cacheSize": 1000,
|
|
31
|
+
"indexing": true,
|
|
32
|
+
"namespaces": ["default", "agents", "tasks", "sessions"],
|
|
33
|
+
"retentionPolicy": {
|
|
34
|
+
"sessions": "30d",
|
|
35
|
+
"tasks": "90d",
|
|
36
|
+
"agents": "permanent"
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Best Practices
|
|
43
|
+
- Use descriptive namespaces for different data types
|
|
44
|
+
- Regular memory exports for backup purposes
|
|
45
|
+
- Monitor memory usage with stats command
|
|
46
|
+
- Clean up old sessions periodically
|
|
47
|
+
|
|
48
|
+
## Memory Types
|
|
49
|
+
- **Episodic**: Conversation and interaction history
|
|
50
|
+
- **Semantic**: Factual knowledge and relationships
|
|
51
|
+
- **Procedural**: Task patterns and workflows
|
|
52
|
+
- **Meta**: System configuration and preferences
|
|
53
|
+
|
|
54
|
+
## Integration Notes
|
|
55
|
+
- Memory is automatically synchronized across agents
|
|
56
|
+
- Search supports both exact match and semantic similarity
|
|
57
|
+
- Memory contents are private to your local instance
|
|
58
|
+
- No data is sent to external services without explicit commands
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-flow-novice",
|
|
3
|
-
"version": "1.3.
|
|
3
|
+
"version": "1.3.3",
|
|
4
4
|
"description": "Standalone Claude Flow for beginners - AI agent orchestration made easy. Enhanced init command creates complete agent system, MCP configuration with 30 essential tools, and automated hooks. Fully standalone with zero external dependencies, all memory leaks eliminated, complete project setup in one command.",
|
|
5
5
|
"mcpName": "io.github.ruvnet/claude-flow",
|
|
6
6
|
"main": ".claude-flow-novice/dist/index.js",
|