Testing And Verification
Testing & Qualitytesting-and-verificationTesting 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
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.