Skip to content

Commit 058759e

Browse files
committed
docs: add clusterd test driver to the mz-test skill
The framework-selection list in the mz-test skill had no entry for dataflow/replica-level compute tests. Add the clusterd test driver (#37008) with its run commands and REWRITE workflow. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012QXMSBfD9bXzJaqs52URyV
1 parent 1ea75db commit 058759e

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

.agents/skills/mz-test/SKILL.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,10 @@ Determine the right framework based on what you're testing:
171171
* **Raw pgwire messages** (COPY, extended protocol): pgtest (`.pt` in `test/pgtest/`).
172172
Wire new files in `src/environmentd/tests/pgwire.rs`.
173173
* **Pure logic, decoding, pure functions**: Rust `#[mz_ore::test]` (or `#[mz_ore::test(tokio::test)]` for async).
174+
* **Compute dataflow / replica protocol behavior** (drive a specific dataflow against specific persist state and exact timestamps, no `environmentd`/SQL/catalog): clusterd test driver — script-based golden tests in `test/clusterd-test-driver/scripts/`.
175+
Run against a real `clusterd` with `bin/mzcompose --find clusterd-test-driver run default`, or on the host without Docker via `bin/pyactivate test/clusterd-test-driver/run-local.py`.
176+
`REWRITE=1` regenerates the `----` expected-output blocks in place.
177+
See `doc/developer/design/20260612_headless_clusterd_test_driver.md`.
174178
* **Restart/upgrade issues**: Platform Checks.
175179
See `doc/developer/platform-checks.md`, especially the "Writing a Check" section.
176180
Do not use the old Legacy Upgrade tests.

0 commit comments

Comments
 (0)