Tooluck logoTooluck
SKILL.md

gentle-ai-bench

Agent skill fromGentleman-Programming/gentle-ai

Trigger: bench, journey, journeys, driven mode, gentle-ai-bench, journey corpus, j-numbers, bench axis. Author and verify gentle-ai bench journeys; go test ./bench never proves driven execution.

How to install gentle-ai-bench

install gentle-ai-bench
# install the gentle-ai pack with the skills CLI
npx skills add Gentleman-Programming/gentle-ai

# or add only this skill to Claude Code: copy the folder

skills/gentle-ai-bench/

# into

~/.claude/skills/gentle-ai-bench/ (all projects)

.claude/skills/gentle-ai-bench/ (one project)

skills/gentle-ai-bench/SKILL.md

MITFull file
1## Activation Contract
2
3Load when touching `bench/` in gentle-ai, adding or changing a journey, changing a product semantic a journey might pin, or diagnosing a bench failure in CI's Unit Tests job.
4
5## Hard Rules
6
7- `go test ./bench` validates corpus declarations only. It does NOT execute journeys. The only driven proof is building the harness and the product binary and running the harness against it; a green `go test ./bench` claims nothing about execution.
8- Reproduce CI, do not guess invocations: read the Unit Tests step in `.github/workflows/ci.yml` and copy its exact build and `gentle-ai-bench run --binary ...` commands. Use `--only <journey-id>` to drive one journey.
9- Journey IDs are unique across every `journeys_*.go` file. The collision guard fails loudly naming both files; pick an unused ID by reading the corpus, never reuse a retired one.
10- Every journey declares `Review:` — `reviewOptedIn` (the runner enables receipt-driven development globally before the first step, uncounted, and fails the journey if the switch does not come on) or `reviewUntouched` (its subject IS the switch, or it has nothing to do with reviews). The declaration is mandatory; `validateCorpus` fails the run without it. Lifecycle journeys must not depend on the product default. Reviews default to ON; `reviewUntouched` does not imply OFF. Journeys requiring OFF must explicitly disable it, while default-mode journeys must assert ON/default with unset sources.
11…

Excerpt shown under the repository's MIT license.

More skills in gentle-ai

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates