claudemem-orchestration

Claudemem Multi-Agent Orchestration

Version: 1.1.0 Purpose: Coordinate multiple agents using shared claudemem output

Overview

When multiple agents need to investigate the same codebase:

1. Run claudemem ONCE to get structural overview
2. Write output to shared file in session directory
3. Launch agents in parallel - all read the same file
4. Consolidate results with consensus analysis

This pattern avoids redundant claudemem calls and enables consensus-based prioritization.

For parallel execution patterns, see: orchestration:multi-model-validation skill

Claudemem-Specific Patterns

This skill focuses on claudemem-specific orchestration. For general parallel execution:

• 4-Message Pattern - See orchestration:multi-model-validation Pattern 1
• Session Setup - See orchestration:multi-model-validation Pattern 0
• Statistics Collection - See orchestration:multi-model-validation Pattern 7

Pattern 1: Shared Claudemem Output

Purpose: Run expensive claudemem commands ONCE, share results across agents.

# Create unique session directory (per orchestration:multi-model-validation Pattern 0)
SESSION_ID="analysis-$(date +%Y%m%d-%H%M%S)-$(head -c 4 /dev/urandom | xxd -p)"
SESSION_DIR="/tmp/${SESSION_ID}"
mkdir -p "$SESSION_DIR"

# Run claudemem ONCE, write to shared files
claudemem --agent map "feature area" > "$SESSION_DIR/structure-map.md"
claudemem --agent test-gaps > "$SESSION_DIR/test-gaps.md" 2>&1 || echo "No gaps found" > "$SESSION_DIR/test-gaps.md"
claudemem --agent dead-code > "$SESSION_DIR/dead-code.md" 2>&1 || echo "No dead code" > "$SESSION_DIR/dead-code.md"

# Export session info
echo "$SESSION_ID" > "$SESSION_DIR/session-id.txt"

Why shared output matters:

• Claudemem indexing is expensive (full AST parse)
• Same index serves all queries in session
• Parallel agents reading same file = no redundant computation

Pattern 2: Role-Based Agent Distribution

After running claudemem, distribute to role-specific agents: