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.

FileKindSize
SKILL.mdskill md1.6 KB
cluster.shexecutablescript1.5 KB
---
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. |
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