donaldfilimon/abi / .agents/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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.6 KB |
| cluster.shexecutable | script | 1.5 KB |
SKILL.md
View on GitHub---
name: cluster-demo-guide
description: 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)
```bash
.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
| 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 |