donaldfilimon/abi / .claude/skills/cluster-demo-guide
cluster-demo-guide
VerifiedBuild the abi CLI and run the in-process WDBX Raft-style consensus demo — leader election, log replication, leader failover, and re-election — plus the single-node cluster status. Use when asked about WDBX clustering, consensus, Raft, or failover behavior.
cluster-demo-guide — drive the WDBX consensus demo
Driver: .agents/skills/cluster-demo-guide/cluster.sh (paths relative to repo root).
Read-only CLI capture — evidence is the RESULT: line + the election/replication trace.
Run (agent path)
.agents/skills/cluster-demo-guide/cluster.sh # 3 nodes (default)
.agents/skills/cluster-demo-guide/cluster.sh 5 # N nodes
Builds the CLI, runs abi wdbx cluster status and abi wdbx cluster demo <n>,
and asserts leader_elected=true, replicate(, and re-election. Prints
RESULT: PASS (exit 0) or a FAIL count.
Current Rust driver: asserts election, majority replication, leader loss, and term-increasing re-election on the bounded in-process demo.
Gotchas
- This is in-process consensus.
cluster serve <port> [node] [host]is the separate networked RequestVote/AppendEntries RPC surface; use thewdbx-cluster-serveskill for that server path. The demo remains single-process. cluster status(no demo) reports the single-node default (nodes=1).- Malformed node count → usage (exit 2).
Troubleshooting
| Symptom | Fix |
|---|---|
build FAIL | ./tools/check.sh. |
missing leader_elected=true | check ../wdbx/crates/abi-wdbx/src/cluster.rs; use the wdbx-explorer subagent. |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |