writing-gnoe2e-scenarios

Use when writing, changing or reviewing a txtar scenario under misc/gnoe2e/testdata, when a change to gnoland, gpao or the harness needs an end-to-end proof across several validators or through the package-approver oracle, or when a scenario is flaky, passes by luck, or waits with sleep.

Jump to install

Repository: gnolang/gno
Last source activity: September 5, 2026 at 16:03
Detected SKILL.md language: English
Stars: 1,081
Forks: 465

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/gnolang/gno --skill writing-gnoe2e-scenarios

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Writing gnoe2e scenarios

A gnoe2e scenario is one claim about the chain, the oracle or the harness, written as a txtar script that fails when the claim stops being true. This skill is the entry point; the pages below own the method and the reference. Read them from the module root, misc/gnoe2e/.

docs/writing-scenarios.md: the method. Shape, choosing the cluster, one-shot versus wait, negation, comments, determinism, the pre-commit checklist. Read it whole before writing a line.

docs/dialect.md: the reference. Every verb's usage, every -- cluster -- key, every exported variable, the two accounts. Read the row for each verb you use.

testdata/tour.txtar: the worked example. Copy its shape, not its content.

docs/architecture.md: only when the scenario needs something the harness does not offer yet.

Before declaring a config. or genesis. key, run make defaults: it lists every key a -- cluster -- section takes and the value a cluster boots with, so a key is checked rather than guessed.

Non-negotiable

Every declared cluster setting is read back by a line in the script.

Anything the oracle does is an eventually; a read of a write this script committed, on the same node, is one shot; sleep only observes an absence, and the comment says why the window is long enough.

Every ! line is pinned by the stderr or stdout match that follows it.

Three consecutive passes with go run . run -verbose testdata/oracle/<file>.txtar before committing, and one line added to the index in README.md.

When the claim is a chain bug

Write the scenario so it is red on master and green with the fix (make test-master runs the working tree's scenarios against binaries built from master). It lands in the same change as the fix, asserting the fixed behaviour, with a header stating that it is red on master and green on the branch.