| name | woc-qa |
| description | Run end-of-contribution QA for World of ClaudeCraft, including readiness checks, scoped regression testing, and conditional specialist review. Use when asked to QA changes, make work ready, verify a branch or worktree, or assess whether a contribution is complete. |
World of ClaudeCraft QA
Coordinate one evidence-backed QA pass for the requested change.
Establish authority and scope
- Read the root
CLAUDE.md in full.
- Read each relevant local
CLAUDE.md before inspecting or editing that area.
- Run
git status --short and preserve unrelated work.
- Establish the diff once. Prefer the working tree when changes are uncommitted;
otherwise use the user-provided base or active release base. Never assume
main.
- Treat
review, check, and audit as read-only. Treat fix findings, make ready, or implementation requests as permission for scoped remediation.
- Do not commit, push, post comments, or create pull requests unless explicitly asked.
CLAUDE.md owns repository architecture and invariants. Reference it instead of
restating or replacing it.
Run coordinator-owned checks
The coordinating agent owns build, test, lint, generation, and scanner commands.
Specialist agents inspect code and shared command output without rerunning the full gate.
During iteration, run the smallest relevant set:
- Targeted Vitest files for changed behavior.
- Architecture or localization guard tests for touched domains.
npm run i18n:gen before tests that require generated localization artifacts.npm run ci:changed.npx tsc --noEmit.
Before declaring implementation work ready, run:
npm run gate
If a command cannot run, report the exact blocker and continue with every safe check
that remains.
Dispatch conditional reviewers
Give each reviewer the established diff, relevant files, applicable canonical
instructions, and command results. Require read-only evidence with file and line
references. Use only the agents relevant to the diff:
woc_sim_architecture for simulation behavior, determinism, or module boundaries.woc_cross_platform for world, network, wire, RL, matcher, or client parity.woc_persistence for DDL, stored JSONB, save paths, or compatibility.woc_database_performance for SQL, indexes, query call sites, pool or lock behavior,
timeout policy, background database work, driver/dependency upgrades, PostgreSQL
engine/resource/configuration/topology changes, or features that increase stored-data cardinality.woc_security for server, admin, auth, deployment, secrets, or trust boundaries.woc_test_coverage for changed behavior, acceptance criteria, and regression tests.woc_frontend for UI, render, CSS, i18n, accessibility, responsive, or fairness work.woc_release_malware for releases, dependencies, install behavior, AI instructions,
or suspicious executable content.
Run independent reviewers in parallel when capacity permits. Verify consequential
findings against the actual diff and surrounding code. Reject speculative, inherited,
duplicate, or out-of-scope findings. In review-only mode, do not edit files.
Report
Return the scope and base, commands and results, reviewers used, confirmed findings,
authorized fixes, remaining risks, and one verdict: READY, READY WITH NOTES, or
NOT READY.
