OpenParable
Skip to content
← Back to skills

Testing And Verification

Testing & Quality
testing-and-verification

Testing And Verification is an Agent Skill for testing & quality published in the pierrecomputer/pierre repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when adding or running tests, checking snapshots, choosing between Bun tests and Playwright, running lint/format/typecheck, or deciding the verification scope for a change.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/pierrecomputer/pierre/blob/HEAD/.agents/skills/testing-and-verification/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/testing-and-verification, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Testing and Verification

Baseline Commands

After code changes, run the required baseline (moon tasks run from anywhere in the repo, including CI-marked agent shells):

moon run root:format root:lint

Useful check/fix pairs on the root project:

moon run root:format-check
moon run root:format
moon run root:lint
moon run root:lint-fix
moon run root:lint-css
moon run root:lint-css-fix

For code changes, also run the relevant typecheck (moon builds workspace dependencies first automatically):

moonx <project>:typecheck
# or, scoped to what actually changed:
moonx :typecheck --affected

Unit and Integration Tests

Use Bun's built-in test runner. Tests usually live in a test/ folder inside each package and use describe, test, and expect from bun:test.

Prefer unit or integration tests by default:

moonx diffs:test
moonx trees:test

moon run :test runs every project's suite. Tests import workspace dependencies through their built dist, so moon builds those first; running bun test directly inside a package also works when dist is fresh.

Snapshots

Bun supports toMatchSnapshot(). Avoid new snapshot coverage unless it is shallow and narrowly scoped to the exact behavior under test.

Update snapshots from the package directory:

bun test -u

Browser and E2E Tests

Add Playwright/browser E2E tests only when behavior cannot be validated without a real browser engine. Good candidates include computed style checks, shadow DOM boundaries, and browser-only rendering behavior.

Keep E2E coverage small and high-value:

moonx trees:coverage
moonx trees:test-e2e
moonx path-store:test-demo
moonx docs:test-e2e

If E2E fixtures or dev servers are started in a worktree, follow the cleanup contract from the worktrees-and-dev-servers skill.