Skip to content

donaldfilimon/abi / .agents/skills/cluster-demo-guide

cluster-demo-guide

Verified

Build 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 the wdbx-cluster-serve skill 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

SymptomFix
build FAIL./tools/check.sh.
missing leader_elected=truecheck ../wdbx/crates/abi-wdbx/src/cluster.rs; use the wdbx-explorer subagent.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall