[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7583R7W128A128D3DRC8QFR":3,"skill-same:01M7583R7W128A128D3DRC8QFR":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":31,"ownerDescription":33,"updatedAt":34,"install":35,"resources":47},"01M7583R7W128A128D3DRC8QFR","ad-hoc-test",null,"Verify new nub functionality end-to-end by building the dev binary and exercising it against real throwaway fixtures. Invoke (via the Skill tool) in BOTH directions, and the second is the one that gets skipped. (1) CONFIRM — after implementing or changing a subcommand\u002Fflag\u002Fbehavior, check the feature ACTUALLY works, not just that tests pass. (2) FALSIFY — before opening a PR on behavior, and again before calling a review round done, SELF-REVIEW by sweeping many adversarial fixtures for what the change BROKE somewhere you were not looking: boundary abuse, real installed registry packages, monorepo and symlink layouts, the tier x module-format matrix. Green gates plus a working reported-case is NOT that sweep. Reviewers read code and cannot run it, so they systematically miss the silent wrong answer — the resolution that returns a different module with no error — which only a fixture run can catch, by checking WHICH file answered rather than that something did. The loop: create fixtures in a tmp dir, build the dev `nub`, run against them, and diff every result three ways — plain node, a build of your branch's MERGE-BASE, and your build. Use the merge-base, NEVER the shipped release: the release can trail `main` by dozens of unrelated commits, so a difference against it is not attributable to your change and every \"pre-existing, not mine\" verdict resting on it is unfounded. Ad-hoc e2e is a valid verification method on its own; this skill also covers when to promote a durable check into the committed test suite. Pairs with the `dev-loop` build skill and AGENTS.md's pre-push loop.","nubjs\u002Fnub","nubjs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6785695?v=4","01M7583N3EYYHSNB6FJQXCDMQH","Nub","01M7583N44MVMSN8385QEF3C8V",4440,"MIT","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fad-hoc-test\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: ad-hoc-test\ndescription: >-\n  Verify new nub functionality end-to-end by building the dev binary and\n  exercising it against real throwaway fixtures. Invoke (via the Skill tool) in\n  BOTH directions, and the second is the one that gets skipped. (1) CONFIRM —\n  after implementing or changing a subcommand\u002Fflag\u002Fbehavior, check the feature\n  ACTUALLY works, not just that tests pass. (2) FALSIFY — before opening a PR on\n  behavior, and again before calling a review round done, SELF-REVIEW by sweeping\n  many adversarial fixtures for what the change BROKE somewhere you were not\n  looking: boundary abuse, real installed registry packages, monorepo and symlink\n  layouts, the tier x module-format matrix. Green gates plus a working\n  reported-case is NOT that sweep. Reviewers read code and cannot run it, so they\n  systematically miss the silent wrong answer — the resolution that returns a\n  different module with no error — which only a fixture run can catch, by\n  checking WHICH file answered rather than that something did. The loop: create\n  fixtures in a tmp dir, build the dev `nub`, run against them, and diff every\n  result three ways — plain node, a build of your branch's MERGE-BASE, and your\n  build. Use the merge-base, NEVER the shipped release: the release can trail\n  `main` by dozens of unrelated commits, so a difference against it is not\n  attributable to your change and every \"pre-existing, not mine\" verdict resting\n  on it is unfounded. Ad-hoc e2e is a valid verification method on its own; this\n  skill also covers when to promote a durable check into the committed test\n  suite. Pairs with the `dev-loop` build skill and AGENTS.md's pre-push loop.\nmetadata:\n  internal: true\n---\n\n# Ad-hoc end-to-end testing of nub\n\nA green `cargo test` does not prove the *feature works when a user runs it*. Build the dev `nub` and run the actual subcommand against a real fixture on disk — a first-class verification method, and the implementer's half of the pre-push loop. It does not replace the test suite; durable behaviors should also become committed tests.\n\nThe highest-yield bug-finding shape is a **differential fixture**: one minimal fixture isolating ONE behavior, run against `nub` AND the reference tool it claims parity with (npm\u002Fpnpm\u002Fyarn\u002Fbun\u002Fnode) on identical input. Always compare against the thing you assert parity with.\n\n**Where it runs: the builder VM by default.** Any probe or sweep that needs no macOS-specific behavior goes to a spot VM — write the whole loop below as ONE script and dispatch it with `nub scripts\u002Fremote-build.ts --job adhoc --script \u003Cfile> --detach`, then `--attach \u003Cvm-name>` (the `remote-build` skill). The script runs at the synced repo root with `NUB_BIN` naming a fresh `--profile fast` build of your tree, real addon staged; the image carries Node 26 + npm, and the script installs pnpm\u002Fbun itself when a differential needs them. Batch a sweep into one script, not one VM per fixture. The merge-base control build can ride a second dispatch with `--source \u003Cmerge-base-worktree>`. Stay local only for the tight fix-and-rerun loop against a warm binary and for macOS-native behavior.\n\n## Two directions — and the second is the one that gets skipped\n\n**CONFIRM** is the loop below. **FALSIFY** is the sweep: before opening a PR on behavior, and again before calling a review round done, hunt across many fixtures for what your change broke *somewhere you were not looking*. Both are required; only the first is instinctive.\n\n- **Confirming is not testing.** Fixtures built to demonstrate a fix all pass, because you chose them to pass. A sweep is built to FALSIFY: adversarial shapes, real registry packages, the full tier × module- format matrix, the layouts users actually have. If every fixture passed on the first run, you tested your intent, not your change.\n- **\"The gates are green and the reported case works\" is the trap** — it satisfies the letter of the pre-push loop, so no alarm fires.\n- **Review cannot substitute for it.** A reviewer reads code and hypothesizes; they cannot run it, so they systematically miss the SILENT WRONG ANSWER — the resolution that returns a different module with no error, the value that is quietly wrong. Those are reachable only by executing the thing and checking WHICH file answered, not merely that something did.\n- **Schedule the sweep explicitly.** Answering someone else's findings always offers a next one; your own verification never gets scheduled by default.\n\nThe sweep decomposes into prongs that share nothing — adversarial boundary abuse, real installed packages, monorepo and symlink topologies, the tier × entry-kind × import-form matrix — so it parallelises across sub-agents well. Require every claim to carry its command and verbatim output, and verify each load-bearing finding yourself.\n\n## The control decides whether the result means anything\n\nA green result with no control is not evidence. Run each fixture three ways — plain `node`, a build of your branch's **merge-base**, and your build.\n\n- **The control is the MERGE-BASE, never a shipped release.** `~\u002F.nub\u002Fbin\u002Fnub` can trail `main` by dozens of unrelated commits, so a difference against it is not attributable to your change and every \"pre-existing, not mine\" verdict resting on it is unfounded.\n  ```bash\n  git worktree add \u002Ftmp\u002Fbase $(git merge-base origin\u002Fmain HEAD)\n  # own CARGO_TARGET_DIR; build the addon before nub-cli\n  ```\n- **Bind the artifact to the change before trusting any run.** The N-API addon and the whole `runtime\u002F` tree are EMBEDDED into the `nub` binary at build time, so a stale binary silently tests the old behavior and a working fix reads as broken. Rebuild in order (addon → `nub-cli`) and confirm from the build log that the crates you changed actually compiled.\n- **Score with the SCORER, never by hand-summing its input.** A results file is often PRE-GATE: in the build-jail corpus, `verdict-table.json` holds raw rows while validity, scheduling, artifact-ratio and manufactured-pass all live in `aggregate.mjs`, so arithmetic over the tables silently skips every gate. Measured 2026-07-31: hand-summing gave 47 survive \u002F 61 break where `node aggregate.mjs \u003Croot>` over the `report.json` set gives **45\u002F63** — two `hook-installer` rows that read `DID-WORK-AND-SUCCEEDED` in BOTH arms are still breaks, because a granted shard-mate's project write satisfies an ungranted package's predicate. Run the project's own scorer over its own inputs; a number you computed yourself from an intermediate file is a different number.\n- **Read the artifact you BUILT, not the first path matching its name.** Same root cause as the rule above — trusting the first plausible file instead of the final one. `--profile fast` writes `target\u002Ffast\u002F`, `cargo test` writes `target\u002Fdebug\u002F`, and generated files live under a per-crate `build\u002F\u003Ccrate>-\u003Chash>\u002Fout\u002F`, so several plausible copies coexist and the stale one is often first alphabetically. Sort candidates by mtime and check the winner is newer than the build.\n- **Vary exactly one thing, and check the variable is INDEPENDENT of the harness.** A control that moves two variables launders a wrong answer into a verified one; a variable that also feeds the measurement destroys attribution instead. Measured 2026-07-31: a Windows differential varied `LOCALAPPDATA`, but nub's store lives at `%LOCALAPPDATA%\\nub\\pm\\store`, so the store moved outside every snapshot root and 6 packages read NOT-INSTALLED. Before running an experiment, ask whether the thing you are varying also feeds the harness. When a control agrees with what you expected, get suspicious rather than relieved.\n- **Exit code is NOT a universal success condition — check what the script actually does first.** Some lifecycle scripts wrap `spawnSync` in `try\u002Fcatch` and never propagate its status, so *every* arm exits 0 no matter what was denied (every hook installer measured — `lefthook`, `@arkweid\u002Flefthook`, `@evilmartians\u002Flefthook` — behaves this way). Where that happens, judge the ARTIFACT against a jail-off control instead. Exit code remains the right default; this is a real exception class.\n- **A grant can MOVE a failure rather than close it.** Re-measure after every grant instead of assuming one is the whole job.\n- **Cover the TIERS, not just your host Node.** The fast tier (22.15+) and compat tier (18.19–22.14) take different code paths and break differently.\n- **A behavior fix landed AFTER your sweep un-verifies the sweep.** Narrowing changes feel safe but can withdraw a resolution real code depended on. Re-run at least the highest-value prong against the binary you intend to ship.\n- **Read a tester's CAVEATS as closely as its findings** — the limitations section is where a report tells you which conclusions are not load-bearing yet.\n\n## The loop\n\n### 1. Create a fixture in a tmp dir\n\nMinimal, isolating the ONE behavior you changed — not a whole app.\n\n```bash\nFIX=$(mktemp -d \u002Ftmp\u002Fnub-fix.XXXX)\ncd \"$FIX\"\n# write only what the behavior needs, e.g.:\ncat > package.json \u003C\u003C'EOF'\n{ \"name\": \"fix\", \"scripts\": { \"build\": \"echo built\" } }\nEOF\n# ...a lockfile, a workspace, a .npmrc, a tsconfig, an index.ts — whatever this behavior reads.\n```\n\n> **Give each fixture a UNIQUE package identity when the behavior touches install \u002F linking \u002F\n> build-approval.** nub's global virtual store persists built package cells across runs, so a second\n> fixture reusing a dependency's `name@version` can link the *first* run's already-built cell — a FALSE\n> CONFIRMATION, because the run never exercised your package at all. Name the dependency uniquely per run\n> (e.g. `dep$(date +%s)@9.9.9`) or wipe the store, and confirm `node_modules\u002F\u003Cdep>\u002F` contents are yours.\n\n### 2. Build the dev `nub`\n\n```bash\n# from your worktree:\nscripts\u002Frust-build.sh build -p nub-cli --profile fast\nNUB=\"$(scripts\u002Frust-build.sh --print-target)\u002Ffast\u002Fnub\"      # DERIVE it; see below\nls -l \"$NUB\"                                                # and eyeball the mtime\n# or, if you ran `make install-dev`:  NUB=nub-dev\n```\n\n**Never hardcode `\u003Cworktree>\u002Ftarget\u002Ffast\u002Fnub`.** The wrapper builds into a content-hashed bucket under `~\u002F.cache\u002Fnub\u002Fshared-target-\u003Chash>\u002F` AND CoW-seeds the worktree's own `target\u002F` from a warm bucket — so `\u003Cworktree>\u002Ftarget\u002Ffast\u002Fnub` exists, is executable, reports a plausible `--version`, and is not what you just built. There is no error and no warning. Measured 2026-09-05: a probe script read that path for an hour while the real build sat in the bucket, and the stale copy happened to hold an earlier version of the same change, so every run looked plausible; the tell was the sweep finally disagreeing with a unit test. Derive the path from `--print-target` and print its mtime, so a stale read shows up in the output instead of being inferred later. (`cargo test` is immune — it compiles from source.)\n\nIf the change touches the runtime\u002Ftranspiler (the N-API addon), build the addon too: `make addon-fast` (or `make install-dev`, which does both).\n\n### 3. Run the subcommand against the fixture\n\n```bash\ncd \"$FIX\"\n\"$NUB\" \u003Cthe-subcommand-and-flags-you-changed>\necho \"exit: $?\"\n```\n\n### 4. Verify the INTENDED effect\n\nState explicitly what \"worked\" means before running, then check that exact thing — the effect on disk, the exit code, or the diff vs the reference tool.\n\n```bash\n# filesystem effect:\nls -la node_modules\u002F.bin\u002F ; cat the-file-it-should-have-written\n# lockfile\u002Fconfig it should have produced or respected:\ncat nub-lock.yaml 2>\u002Fdev\u002Fnull; cat package.json\n# exit code on a refusal path:\n\"$NUB\" \u003Cunsound-invocation>; echo \"exit: $?\"   # expect a non-zero + a clear error\n# DIFFERENTIAL: run the reference tool on the SAME fixture and diff:\npnpm \u003Cequivalent> ; # compare output \u002F node_modules \u002F lockfile to nub's\n```\n\n### 5. Probe variants and edge cases\n\n```bash\n\"$NUB\" \u003Ccmd> --flag-variant        # each flag\u002Falias you touched\n\"$NUB\" \u003Ccmd>                        # the no-arg \u002F default case\n(cd empty-dir && \"$NUB\" \u003Ccmd>)      # missing input \u002F empty project\n\"$NUB\" \u003Ccmd> \u003Cmalformed-input>      # the failure mode — should error clearly, not panic\n```\n\nFor version-banded runtime behavior, drive nub onto a specific Node: `PATH=\"$HOME\u002F.nvm\u002Fversions\u002Fnode\u002Fv20.19.0\u002Fbin:$PATH\" \"$NUB\" …`. Use Docker for clean-machine \u002F global-cache \u002F Node-floor behavior.\n\n### 6. Clean up\n\n```bash\nrm -rf \"$FIX\"\n```\n\n## Then: promote durable checks into the suite\n\nAd-hoc verification proves *this* change; a committed test prevents the *next* regression.\n\n- A behavior covered by a tmp-fixture check should become a committed integration test under `crates\u002Fnub-cli\u002Ftests\u002F*.rs` (or a documented harness under `tests\u002F\u003Cfeature>\u002F` for multi-version\u002FDocker loops).\n- Keep it a throwaway only for genuinely one-shot \u002F environment-bound checks.\n- Follow AGENTS.md's testing philosophy: minimum number of tests, comprehensive (not exhaustive) coverage, contract-describing names, self-debugging failure messages.\n\n**Local host won't show the behavior?** OS\u002Fplatform-gated probes — macOS Seatbelt \u002F `sandbox-exec` \u002F codesigning, Windows cmd.exe \u002F `--script-shell` selection \u002F `.cmd` resolution \u002F Authenticode, musl\u002Fglibc, a Node floor — can't be reached here. Linux corners go to Docker; a real macOS or Windows behavior goes to the **`ci-adhoc-test` skill** (branch-scoped workflow, no PR required).\n\n## Quick reference\n\n```bash\nFIX=$(mktemp -d \u002Ftmp\u002Fnub-fix.XXXX); cd \"$FIX\"        # 1. fixture\n# ...write minimal package.json \u002F lockfile \u002F tsconfig \u002F source...\nscripts\u002Frust-build.sh build -p nub-cli --profile fast # 2. build dev nub\nNUB=\"$(scripts\u002Frust-build.sh --print-target)\u002Ffast\u002Fnub\" #    derive, never hardcode target\u002F\n\"$NUB\" \u003Csubcommand>; echo \"exit: $?\"                 # 3. run it\ncat the-effect; pnpm \u003Cequiv>                         # 4. verify effect (differential)\n\"$NUB\" \u003Cvariant>; \"$NUB\" \u003Cbad-input>                # 5. probe edges\nrm -rf \"$FIX\"                                         # 6. clean up\n# 7. promote a durable check into crates\u002Fnub-cli\u002Ftests\u002F*.rs\n```\n","# Ad-hoc end-to-end testing of nub\n\nA green `cargo test` does not prove the *feature works when a user runs it*. Build the dev `nub` and run the actual subcommand against a real fixture on disk — a first-class verification method, and the implementer's half of the pre-push loop. It does not replace the test suite; durable behaviors should also become committed tests.\n\nThe highest-yield bug-finding shape is a **differential fixture**: one minimal fixture isolating ONE behavior, run against `nub` AND the reference tool it claims parity with (npm\u002Fpnpm\u002Fyarn\u002Fbun\u002Fnode) on identical input. Always compare against the thing you assert parity with.\n\n**Where it runs: the builder VM by default.** Any probe or sweep that needs no macOS-specific behavior goes to a spot VM — write the whole loop below as ONE script and dispatch it with `nub scripts\u002Fremote-build.ts --job adhoc --script \u003Cfile> --detach`, then `--attach \u003Cvm-name>` (the `remote-build` skill). The script runs at the synced repo root with `NUB_BIN` naming a fresh `--profile fast` build of your tree, real addon staged; the image carries Node 26 + npm, and the script installs pnpm\u002Fbun itself when a differential needs them. Batch a sweep into one script, not one VM per fixture. The merge-base control build can ride a second dispatch with `--source \u003Cmerge-base-worktree>`. Stay local only for the tight fix-and-rerun loop against a warm binary and for macOS-native behavior.\n\n## Two directions — and the second is the one that gets skipped\n\n**CONFIRM** is the loop below. **FALSIFY** is the sweep: before opening a PR on behavior, and again before calling a review round done, hunt across many fixtures for what your change broke *somewhere you were not looking*. Both are required; only the first is instinctive.\n\n- **Confirming is not testing.** Fixtures built to demonstrate a fix all pass, because you chose them to pass. A sweep is built to FALSIFY: adversarial shapes, real registry packages, the full tier × module- format matrix, the layouts users actually have. If every fixture passed on the first run, you tested your intent, not your change.\n- **\"The gates are green and the reported case works\" is the trap** — it satisfies the letter of the pre-push loop, so no alarm fires.\n- **Review cannot substitute for it.** A reviewer reads code and hypothesizes; they cannot run it, so they systematically miss the SILENT WRONG ANSWER — the resolution that returns a different module with no error, the value that is quietly wrong. Those are reachable only by executing the thing and checking WHICH file answered, not merely that something did.\n- **Schedule the sweep explicitly.** Answering someone else's findings always offers a next one; your own verification never gets scheduled by default.\n\nThe sweep decomposes into prongs that share nothing — adversarial boundary abuse, real installed packages, monorepo and symlink topologies, the tier × entry-kind × import-form matrix — so it parallelises across sub-agents well. Require every claim to carry its command and verbatim output, and verify each load-bearing finding yourself.\n\n## The control decides whether the result means anything\n\nA green result with no control is not evidence. Run each fixture three ways — plain `node`, a build of your branch's **merge-base**, and your build.\n\n- **The control is the MERGE-BASE, never a shipped release.** `~\u002F.nub\u002Fbin\u002Fnub` can trail `main` by dozens of unrelated commits, so a difference against it is not attributable to your change and every \"pre-existing, not mine\" verdict resting on it is unfounded.\n  ```bash\n  git worktree add \u002Ftmp\u002Fbase $(git merge-base origin\u002Fmain HEAD)\n  # own CARGO_TARGET_DIR; build the addon before nub-cli\n  ```\n- **Bind the artifact to the change before trusting any run.** The N-API addon and the whole `runtime\u002F` tree are EMBEDDED into the `nub` binary at build time, so a stale binary silently tests the old behavior and a working fix reads as broken. Rebuild in order (addon → `nub-cli`) and confirm from the build log that the crates you changed actually compiled.\n- **Score with the SCORER, never by hand-summing its input.** A results file is often PRE-GATE: in the build-jail corpus, `verdict-table.json` holds raw rows while validity, scheduling, artifact-ratio and manufactured-pass all live in `aggregate.mjs`, so arithmetic over the tables silently skips every gate. Measured 2026-07-31: hand-summing gave 47 survive \u002F 61 break where `node aggregate.mjs \u003Croot>` over the `report.json` set gives **45\u002F63** — two `hook-installer` rows that read `DID-WORK-AND-SUCCEEDED` in BOTH arms are still breaks, because a granted shard-mate's project write satisfies an ungranted package's predicate. Run the project's own scorer over its own inputs; a number you computed yourself from an intermediate file is a different number.\n- **Read the artifact you BUILT, not the first path matching its name.** Same root cause as the rule above — trusting the first plausible file instead of the final one. `--profile fast` writes `target\u002Ffast\u002F`, `cargo test` writes `target\u002Fdebug\u002F`, and generated files live under a per-crate `build\u002F\u003Ccrate>-\u003Chash>\u002Fout\u002F`, so several plausible copies coexist and the stale one is often first alphabetically. Sort candidates by mtime and check the winner is newer than the build.\n- **Vary exactly one thing, and check the variable is INDEPENDENT of the harness.** A control that moves two variables launders a wrong answer into a verified one; a variable that also feeds the measurement destroys attribution instead. Measured 2026-07-31: a Windows differential varied `LOCALAPPDATA`, but nub's store lives at `%LOCALAPPDATA%\\nub\\pm\\store`, so the store moved outside every snapshot root and 6 packages read NOT-INSTALLED. Before running an experiment, ask whether the thing you are varying also feeds the harness. When a control agrees with what you expected, get suspicious rather than relieved.\n- **Exit code is NOT a universal success condition — check what the script actually does first.** Some lifecycle scripts wrap `spawnSync` in `try\u002Fcatch` and never propagate its status, so *every* arm exits 0 no matter what was denied (every hook installer measured — `lefthook`, `@arkweid\u002Flefthook`, `@evilmartians\u002Flefthook` — behaves this way). Where that happens, judge the ARTIFACT against a jail-off control instead. Exit code remains the right default; this is a real exception class.\n- **A grant can MOVE a failure rather than close it.** Re-measure after every grant instead of assuming one is the whole job.\n- **Cover the TIERS, not just your host Node.** The fast tier (22.15+) and compat tier (18.19–22.14) take different code paths and break differently.\n- **A behavior fix landed AFTER your sweep un-verifies the sweep.** Narrowing changes feel safe but can withdraw a resolution real code depended on. Re-run at least the highest-value prong against the binary you intend to ship.\n- **Read a tester's CAVEATS as closely as its findings** — the limitations section is where a report tells you which conclusions are not load-bearing yet.\n\n## The loop\n\n### 1. Create a fixture in a tmp dir\n\nMinimal, isolating the ONE behavior you changed — not a whole app.\n\n```bash\nFIX=$(mktemp -d \u002Ftmp\u002Fnub-fix.XXXX)\ncd \"$FIX\"\n# write only what the behavior needs, e.g.:\ncat > package.json \u003C\u003C'EOF'\n{ \"name\": \"fix\", \"scripts\": { \"build\": \"echo built\" } }\nEOF\n# ...a lockfile, a workspace, a .npmrc, a tsconfig, an index.ts — whatever this behavior reads.\n```\n\n> **Give each fixture a UNIQUE package identity when the behavior touches install \u002F linking \u002F\n> build-approval.** nub's global virtual store persists built package cells across runs, so a second\n> fixture reusing a dependency's `name@version` can link the *first* run's already-built cell — a FALSE\n> CONFIRMATION, because the run never exercised your package at all. Name the dependency uniquely per run\n> (e.g. `dep$(date +%s)@9.9.9`) or wipe the store, and confirm `node_modules\u002F\u003Cdep>\u002F` contents are yours.\n\n### 2. Build the dev `nub`\n\n```bash\n# from your worktree:\nscripts\u002Frust-build.sh build -p nub-cli --profile fast\nNUB=\"$(scripts\u002Frust-build.sh --print-target)\u002Ffast\u002Fnub\"      # DERIVE it; see below\nls -l \"$NUB\"                                                # and eyeball the mtime\n# or, if you ran `make install-dev`:  NUB=nub-dev\n```\n\n**Never hardcode `\u003Cworktree>\u002Ftarget\u002Ffast\u002Fnub`.** The wrapper builds into a content-hashed bucket under `~\u002F.cache\u002Fnub\u002Fshared-target-\u003Chash>\u002F` AND CoW-seeds the worktree's own `target\u002F` from a warm bucket — so `\u003Cworktree>\u002Ftarget\u002Ffast\u002Fnub` exists, is executable, reports a plausible `--version`, and is not what you just built. There is no error and no warning. Measured 2026-09-05: a probe script read that path for an hour while the real build sat in the bucket, and the stale copy happened to hold an earlier version of the same change, so every run looked plausible; the tell was the sweep finally disagreeing with a unit test. Derive the path from `--print-target` and print its mtime, so a stale read shows up in the output instead of being inferred later. (`cargo test` is immune — it compiles from source.)\n\nIf the change touches the runtime\u002Ftranspiler (the N-API addon), build the addon too: `make addon-fast` (or `make install-dev`, which does both).\n\n### 3. Run the subcommand against the fixture\n\n```bash\ncd \"$FIX\"\n\"$NUB\" \u003Cthe-subcommand-and-flags-you-changed>\necho \"exit: $?\"\n```\n\n### 4. Verify the INTENDED effect\n\nState explicitly what \"worked\" means before running, then check that exact thing — the effect on disk, the exit code, or the diff vs the reference tool.\n\n```bash\n# filesystem effect:\nls -la node_modules\u002F.bin\u002F ; cat the-file-it-should-have-written\n# lockfile\u002Fconfig it should have produced or respected:\ncat nub-lock.yaml 2>\u002Fdev\u002Fnull; cat package.json\n# exit code on a refusal path:\n\"$NUB\" \u003Cunsound-invocation>; echo \"exit: $?\"   # expect a non-zero + a clear error\n# DIFFERENTIAL: run the reference tool on the SAME fixture and diff:\npnpm \u003Cequivalent> ; # compare output \u002F node_modules \u002F lockfile to nub's\n```\n\n### 5. Probe variants and edge cases\n\n```bash\n\"$NUB\" \u003Ccmd> --flag-variant        # each flag\u002Falias you touched\n\"$NUB\" \u003Ccmd>                        # the no-arg \u002F default case\n(cd empty-dir && \"$NUB\" \u003Ccmd>)      # missing input \u002F empty project\n\"$NUB\" \u003Ccmd> \u003Cmalformed-input>      # the failure mode — should error clearly, not panic\n```\n\nFor version-banded runtime behavior, drive nub onto a specific Node: `PATH=\"$HOME\u002F.nvm\u002Fversions\u002Fnode\u002Fv20.19.0\u002Fbin:$PATH\" \"$NUB\" …`. Use Docker for clean-machine \u002F global-cache \u002F Node-floor behavior.\n\n### 6. Clean up\n\n```bash\nrm -rf \"$FIX\"\n```\n\n## Then: promote durable checks into the suite\n\nAd-hoc verification proves *this* change; a committed test prevents the *next* regression.\n\n- A behavior covered by a tmp-fixture check should become a committed integration test under `crates\u002Fnub-cli\u002Ftests\u002F*.rs` (or a documented harness under `tests\u002F\u003Cfeature>\u002F` for multi-version\u002FDocker loops).\n- Keep it a throwaway only for genuinely one-shot \u002F environment-bound checks.\n- Follow AGENTS.md's testing philosophy: minimum number of tests, comprehensive (not exhaustive) coverage, contract-describing names, self-debugging failure messages.\n\n**Local host won't show the behavior?** OS\u002Fplatform-gated probes — macOS Seatbelt \u002F `sandbox-exec` \u002F codesigning, Windows cmd.exe \u002F `--script-shell` selection \u002F `.cmd` resolution \u002F Authenticode, musl\u002Fglibc, a Node floor — can't be reached here. Linux corners go to Docker; a real macOS or Windows behavior goes to the **`ci-adhoc-test` skill** (branch-scoped workflow, no PR required).\n\n## Quick reference\n\n```bash\nFIX=$(mktemp -d \u002Ftmp\u002Fnub-fix.XXXX); cd \"$FIX\"        # 1. fixture\n# ...write minimal package.json \u002F lockfile \u002F tsconfig \u002F source...\nscripts\u002Frust-build.sh build -p nub-cli --profile fast # 2. build dev nub\nNUB=\"$(scripts\u002Frust-build.sh --print-target)\u002Ffast\u002Fnub\" #    derive, never hardcode target\u002F\n\"$NUB\" \u003Csubcommand>; echo \"exit: $?\"                 # 3. run it\ncat the-effect; pnpm \u003Cequiv>                         # 4. verify effect (differential)\n\"$NUB\" \u003Cvariant>; \"$NUB\" \u003Cbad-input>                # 5. probe edges\nrm -rf \"$FIX\"                                         # 6. clean up\n# 7. promote a durable check into crates\u002Fnub-cli\u002Ftests\u002F*.rs\n```\n",{"name":5,"metadata":24,"description":7},{"internal":25},true,"main","9b734566fd36ceed8379f67a92291bc68af60801",".claude\u002Fskills\u002Fad-hoc-test",71,"https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub","https:\u002F\u002Fnubjs.com","https:\u002F\u002Fgithub.com\u002Fnubjs","The all-in-one Node.js toolkit","2026-11-14 14:11:35",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":25},[37,40,43],{"tool":38,"command":39},"npx","npx skills add nubjs\u002Fnub --skill ad-hoc-test",{"tool":41,"command":42},"bunx","bunx skills add nubjs\u002Fnub --skill ad-hoc-test",{"tool":44,"command":45},"pnpm","pnpm dlx skills add nubjs\u002Fnub --skill ad-hoc-test","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fad-hoc-test\u002FSKILL.md",[],[49,55,61,68,75,82],{"skillNo":50,"name":51,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M758BSH88RVXBG8TPCT427TY","nub","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002Fskills\u002Fnub\u002FSKILL.md",[],[],{"skillNo":56,"name":51,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M758BKPRHXS5MS27WG908PBG","This project uses nub, a single Rust CLI that runs on the project's installed Node and replaces the everyday Node toolchain. ALWAYS prefer nub over node, bun, npm, npx, pnpm, and yarn for: executing JS\u002FTS files, running package.json scripts, the npx-equivalent, installing dependencies, watch mode, and Node version management. Surfaces whenever you would otherwise reach for node\u002Fbun\u002Fnpm\u002Fnpx or a package manager.","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002Fsite\u002Fpublic\u002Fskill.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M758BCR8A21H8P4TQ0YRHTC7","worktree","Create and manage isolated git worktrees for parallel build\u002Ftest\u002Flanding work on the nub repo. Invoke (via the Skill tool) whenever you need a fresh worktree to land a change, when you want to know what `.worktreeinclude` does or how to add an entry, or when cleaning up after a merge. Encodes the one-command setup (`nub scripts\u002Fnew-worktree.ts \u003Cslug>` or `node …`) that bakes in the proven recipe — worktree off origin\u002Fmain (vendor\u002Faube is plain in-tree files now, no submodule init), the shared CARGO_TARGET_DIR (`~\u002F.cache\u002Fnub\u002Fshared-target`) that all worktrees reuse, and applying `.worktreeinclude` — plus the eagerly-pull-the-shared-tree discipline and the safe cleanup path. Pairs with the `dev-loop` build skill.","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fworktree\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M758B9NZ1GQMD1A6B25NK0D9","windows-vm-test","Run ad-hoc Nub tests and debugging probes in the maintainer's existing local Windows 11 ARM64 QEMU\u002FHVF VM when its external disk and runbook are present. Use for interactive win32-arm64 or Windows-on-ARM x64-emulation checks; use ci-adhoc-test for true x64-native behavior or when the local VM is unavailable.","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwindows-vm-test\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M758B2JHMBB6YJTGYSJR65S4","visual-review","Verify UI\u002Flayout\u002Fstyling changes are correct by computing occlusion, clipping, and alignment from the browser's resolved paint order via the chrome-devtools MCP `evaluate_script` tool — instead of eyeballing a flat screenshot. Invoke BEFORE declaring any UI, site, or styling\u002Flayout change correct. Screenshots have no depth buffer, so z-index\u002Focclusion\u002Fclip bugs are exactly where \"just look at it\" fails; the `evaluate_script` routines below turn those fuzzy visual judgments into deterministic measurements — including optical center-of-mass, which measures the glyph ink's true visual center so differently-sized labels can be aligned by more than eye.","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fvisual-review\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M758AWPM7CE440NBAYJHD44J","type-declarations","Add, audit, or update @nubjs\u002Ftypes declarations for Nub runtime APIs. Use whenever Nub adds or changes a user-visible global, built-in method, module loader type, or TC39 proposal; when TypeScript or @types\u002Fnode gains an overlapping declaration; and before every release to reconcile runtime changes since the previous tag. Covers conflict-safe global augmentation, compiler-version routing, fixture matrices, and package verification.","https:\u002F\u002Fgithub.com\u002Fnubjs\u002Fnub\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftype-declarations\u002FSKILL.md",[],[]]