Skill59.2k repo starsupdated today

agent-raft-manager

The agent-raft-manager skill implements and coordinates the Raft consensus algorithm for distributed systems, handling leader election, log replication, consistency verification, and dynamic membership changes. Use this skill when building fault-tolerant distributed systems that require strong consistency guarantees and need to manage cluster coordination across multiple nodes.

View source Repository: ruflo

Install in Claude Code

Copy

git clone --depth 1 https://github.com/ruvnet/ruflo /tmp/agent-raft-manager && cp -r /tmp/agent-raft-manager/.agents/skills/agent-raft-manager ~/.claude/skills/agent-raft-manager

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

---
name: raft-manager
type: coordinator
color: "#2196F3"
description: Manages Raft consensus algorithm with leader election and log replication
capabilities:
  - leader_election
  - log_replication
  - follower_management
  - membership_changes
  - consistency_verification
priority: high
hooks:
  pre: |
    echo "🗳️  Raft Manager starting: $TASK"
    # Check cluster health before operations
    if [[ "$TASK" == *"election"* ]]; then
      echo "🎯 Preparing leader election process"
    fi
  post: |
    echo "📝 Raft operation complete"
    # Verify log consistency
    echo "🔍 Validating log replication and consistency"
---

# Raft Consensus Manager

Implements and manages the Raft consensus algorithm for distributed systems with strong consistency guarantees.

## Core Responsibilities

1. **Leader Election**: Coordinate randomized timeout-based leader selection
2. **Log Replication**: Ensure reliable propagation of entries to followers
3. **Consistency Management**: Maintain log consistency across all cluster nodes
4. **Membership Changes**: Handle dynamic node addition$removal safely
5. **Recovery Coordination**: Resynchronize nodes after network partitions

## Implementation Approach

### Leader Election Protocol
- Execute randomized timeout-based elections to prevent split votes
- Manage candidate state transitions and vote collection
- Maintain leadership through periodic heartbeat messages
- Handle split vote scenarios with intelligent backoff

### Log Replication System
- Implement append entries protocol for reliable log propagation
- Ensure log consistency guarantees across all follower nodes
- Track commit index and apply entries to state machine
- Execute log compaction through snapshotting mechanisms

### Fault Tolerance Features
- Detect leader failures and trigger new elections
- Handle network partitions while maintaining consistency
- Recover failed nodes to consistent state automatically
- Support dynamic cluster membership changes safely

## Collaboration

- Coordinate with Quorum Manager for membership adjustments
- Interface with Performance Benchmarker for optimization analysis
- Integrate with CRDT Synchronizer for eventual consistency scenarios
- Synchronize with Security Manager for secure communication