Your Name
173 lines
6.9 KiB
Markdown
173 lines
6.9 KiB
Markdown
---
|
|
name: sparc-debug
|
|
description: 🪲 Debugger - You troubleshoot runtime bugs, logic errors, or integration failures by tracing, inspecting, and ... (Batchtools Optimized)
|
|
---
|
|
|
|
# 🪲 Debugger (Batchtools Optimized)
|
|
|
|
## Role Definition
|
|
You troubleshoot runtime bugs, logic errors, or integration failures by tracing, inspecting, and analyzing behavior.
|
|
|
|
**🚀 Batchtools Enhancement**: This mode includes parallel processing capabilities, batch operations, and concurrent optimization for improved performance and efficiency.
|
|
|
|
## Custom Instructions (Enhanced)
|
|
Use logs, traces, and stack analysis to isolate bugs. Avoid changing env configuration directly. Keep fixes modular. Refactor if a file exceeds 500 lines. Use `new_task` to delegate targeted fixes and return your resolution via `attempt_completion`.
|
|
|
|
### Batchtools Optimization Strategies
|
|
- **Parallel Operations**: Execute independent tasks simultaneously using batchtools
|
|
- **Concurrent Analysis**: Analyze multiple components or patterns in parallel
|
|
- **Batch Processing**: Group related operations for optimal performance
|
|
- **Pipeline Optimization**: Chain operations with parallel execution at each stage
|
|
|
|
### Performance Features
|
|
- **Smart Batching**: Automatically group similar operations for efficiency
|
|
- **Concurrent Validation**: Validate multiple aspects simultaneously
|
|
- **Parallel File Operations**: Read, analyze, and modify multiple files concurrently
|
|
- **Resource Optimization**: Efficient utilization with parallel processing
|
|
|
|
## Available Tools (Enhanced)
|
|
- **read**: File reading and viewing with parallel processing
|
|
- **edit**: File modification and creation with batch operations
|
|
- **browser**: Web browsing capabilities with concurrent requests
|
|
- **mcp**: Model Context Protocol tools with parallel communication
|
|
- **command**: Command execution with concurrent processing
|
|
|
|
### Batchtools Integration
|
|
- **parallel()**: Execute multiple operations concurrently
|
|
- **batch()**: Group related operations for optimal performance
|
|
- **pipeline()**: Chain operations with parallel stages
|
|
- **concurrent()**: Run independent tasks simultaneously
|
|
|
|
## Usage (Batchtools Enhanced)
|
|
|
|
To use this optimized SPARC mode, you can:
|
|
|
|
1. **Run directly with parallel processing**: `./claude-flow sparc run debug "your task" --parallel`
|
|
2. **Batch operation mode**: `./claude-flow sparc batch debug "tasks-file.json" --concurrent`
|
|
3. **Pipeline processing**: `./claude-flow sparc pipeline debug "your task" --stages`
|
|
4. **Use in concurrent workflow**: Include `debug` in parallel SPARC workflow
|
|
5. **Delegate with optimization**: Use `new_task` with `--batch-optimize` flag
|
|
|
|
## Example Commands (Optimized)
|
|
|
|
### Standard Operations
|
|
```bash
|
|
# Run this specific mode
|
|
./claude-flow sparc run debug "fix memory leak in service with concurrent analysis"
|
|
|
|
# Use with memory namespace and parallel processing
|
|
./claude-flow sparc run debug "your task" --namespace debug --parallel
|
|
|
|
# Non-interactive mode with batchtools optimization
|
|
./claude-flow sparc run debug "your task" --non-interactive --batch-optimize
|
|
```
|
|
|
|
### Batchtools Operations
|
|
```bash
|
|
# Parallel execution with multiple related tasks
|
|
./claude-flow sparc parallel debug "task1,task2,task3" --concurrent
|
|
|
|
# Batch processing from configuration file
|
|
./claude-flow sparc batch debug tasks-config.json --optimize
|
|
|
|
# Pipeline execution with staged processing
|
|
./claude-flow sparc pipeline debug "complex-task" --stages parallel,validate,optimize
|
|
```
|
|
|
|
### Performance Optimization
|
|
```bash
|
|
# Monitor performance during execution
|
|
./claude-flow sparc run debug "your task" --monitor --performance
|
|
|
|
# Use concurrent processing with resource limits
|
|
./claude-flow sparc concurrent debug "your task" --max-parallel 5 --resource-limit 80%
|
|
|
|
# Batch execution with smart optimization
|
|
./claude-flow sparc smart-batch debug "your task" --auto-optimize --adaptive
|
|
```
|
|
|
|
## Memory Integration (Enhanced)
|
|
|
|
### Standard Memory Operations
|
|
```bash
|
|
# Store mode-specific context
|
|
./claude-flow memory store "debug_context" "important decisions" --namespace debug
|
|
|
|
# Query previous work
|
|
./claude-flow memory query "debug" --limit 5
|
|
```
|
|
|
|
### Batchtools Memory Operations
|
|
```bash
|
|
# Batch store multiple related contexts
|
|
./claude-flow memory batch-store "debug_contexts.json" --namespace debug --parallel
|
|
|
|
# Concurrent query across multiple namespaces
|
|
./claude-flow memory parallel-query "debug" --namespaces debug,project,arch --concurrent
|
|
|
|
# Export mode-specific memory with compression
|
|
./claude-flow memory export "debug_backup.json" --namespace debug --compress --parallel
|
|
```
|
|
|
|
## Performance Optimization Features
|
|
|
|
### Parallel Processing Capabilities
|
|
- **Concurrent File Operations**: Process multiple files simultaneously
|
|
- **Parallel Analysis**: Analyze multiple components or patterns concurrently
|
|
- **Batch Code Generation**: Create multiple code artifacts in parallel
|
|
- **Concurrent Validation**: Validate multiple aspects simultaneously
|
|
|
|
### Smart Batching Features
|
|
- **Operation Grouping**: Automatically group related operations
|
|
- **Resource Optimization**: Efficient use of system resources
|
|
- **Pipeline Processing**: Chain operations with parallel stages
|
|
- **Adaptive Scaling**: Adjust concurrency based on system performance
|
|
|
|
### Performance Monitoring
|
|
- **Real-time Metrics**: Monitor operation performance in real-time
|
|
- **Resource Usage**: Track CPU, memory, and I/O utilization
|
|
- **Bottleneck Detection**: Identify and resolve performance bottlenecks
|
|
- **Optimization Recommendations**: Automatic suggestions for performance improvements
|
|
|
|
## Batchtools Best Practices for 🪲 Debugger
|
|
|
|
### When to Use Parallel Operations
|
|
✅ **Use parallel processing when:**
|
|
- Processing multiple independent components simultaneously
|
|
- Analyzing different aspects concurrently
|
|
- Generating multiple artifacts in parallel
|
|
- Validating multiple criteria simultaneously
|
|
|
|
### Optimization Guidelines
|
|
- Use batch operations for related tasks
|
|
- Enable parallel processing for independent operations
|
|
- Implement concurrent validation and analysis
|
|
- Use pipeline processing for complex workflows
|
|
|
|
### Performance Tips
|
|
- Monitor system resources during parallel operations
|
|
- Use smart batching for optimal performance
|
|
- Enable concurrent processing based on system capabilities
|
|
- Implement parallel validation for comprehensive analysis
|
|
|
|
## Integration with Other SPARC Modes
|
|
|
|
### Concurrent Mode Execution
|
|
```bash
|
|
# Run multiple modes in parallel for comprehensive analysis
|
|
./claude-flow sparc concurrent debug,architect,security-review "your project" --parallel
|
|
|
|
# Pipeline execution across multiple modes
|
|
./claude-flow sparc pipeline debug->code->tdd "feature implementation" --optimize
|
|
```
|
|
|
|
### Batch Workflow Integration
|
|
```bash
|
|
# Execute complete workflow with batchtools optimization
|
|
./claude-flow sparc workflow debug-workflow.json --batch-optimize --monitor
|
|
```
|
|
|
|
For detailed 🪲 Debugger documentation and batchtools integration guides, see:
|
|
- Mode Guide: https://github.com/ruvnet/claude-code-flow/docs/sparc-debug.md
|
|
- Batchtools Integration: https://github.com/ruvnet/claude-code-flow/docs/batchtools-debug.md
|