gotit

Register a project-local assertion type (the `x-` prefix family) when the 8 built-ins (exit_code, contains, not_contains, stderr_contains, regex, json_path, count, golden_file) cannot express the check. Invoke only when a built-in genuinely doesn't fit.

Author one YAML spec under tests/e2e/specs/<wave>/ that exercises a daemon/server/long-running process — with readiness polling, clean-shutdown verification, and optional log assertions. Invoke when the user asks to "write an e2e test for the server", "spec the daemon", "test the watch subcommand", "verify graceful shutdown", or any test that needs a process running in the background while other steps run.

Author one YAML spec under tests/e2e/specs/<wave>/ for one CLI feature, with appropriate assertions and an auto-rendered sidecar notes file. Invoke when the user asks to "write an e2e test for X", "add a spec for the Y subcommand", or to verify a CLI feature end-to-end.

One-shot setup of the gotit E2E test suite in a Go CLI project — wires runner_test.go, features.yaml, AGENTS.md, .gitignore, and a passing smoke spec. Invoke when the user asks to "add e2e tests", "set up gotit", or "scaffold end-to-end tests" in a Go project.

Read the most recent JSONL log under tests/e2e/results/, identify the failed step, classify the failure, and propose a fix or open a tracking issue. Invoke when a test fails locally or in CI and the user wants to debug it.

Convert an existing CLI test suite (bats, expect, pytest+subprocess, Makefile-driven shell scripts) into gotit YAML specs. Invoke when the user is migrating an established test suite to gotit.

Run the gotit E2E suite (full or filtered) via `go test -run`, with feature-flag and verbosity overrides, and summarize the result. Invoke when the user asks to "run the e2e tests", "run wave2 only", or to verify a single spec after editing.

Install and use the gotit interactive TUI — the headline surface for browsing, running, and debugging gotit E2E specs. Invoke when the user wants to "open the test runner", "run the e2e tests interactively", "debug a failed spec", or asks how to install the gotit binary.

Land an E2E spec for an unshipped feature behind a feature flag — spec is committed but skipped in CI until the flag is flipped. Invoke when writing tests-first for a feature that isn't implemented yet, or when an existing flag needs to flip from false to true on shipping.

Add a static repository fixture under tests/e2e/testdata/repos/ that specs reference via `repo.fixture:`. Invoke when a spec needs a small, file-tree-based test repo (no commit history beyond an initial commit).

Register a programmatic Go function under tests/e2e/helpers/ that builds a test repository with custom commit history, then wire it into runner_test.go's RepoHelpers map. Invoke when a spec needs renames, multi-commit history, branches, or other state a static fixture cannot express.

Open a new wave directory or close an existing one — flip its feature flags, rename files for archival, and update the AGENTS/README pointers. Invoke at release boundaries, when the user says "open wave3" or "ship the rename-detection feature".