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.2",
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",