Menu
Verification steps for code changes. Debug mode defers lint; full checklist before merge. Use after changes or when planning.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Apex Language Server data architecture — type sources, worker topology, and data ownership. Use when working on type resolution, worker communication, resource loading, hover, definition, diagnostics, or any code in apex-ls/src/server/ or apex-parser-ast/src/symbols/.
Numbering convention for ordering GUS work items within an epic. Numeric prefixes in Subject__c express sequencing (do X before Y) and parallelism. Use when planning an epic, when the user states a dependency between work items, or when asked what's unblocked/ready in an epic.
Enforces Effect-TS patterns for services, errors, layers, and atoms. Use when writing code with Effect.Service, Schema.TaggedError, Layer composition, or effect-atom React components.
Create feature branches for all work. Use when creating branches, checking out, or pushing. Prevents accidental push to main.
Interact with the Gus Salesforce org via CLI (sf). Query, create, update work items; query team epics. Use when user mentions Gus, work items, epics, or GUS/Git2Gus workflows.
Guidelines for package.json files in packages
| name | verification |
| description | Verification steps for code changes. Debug mode defers lint; full checklist before merge. Use after changes or when planning. |
Do each step in order; do not skip a step unless all previous are passing except in debug mode. Run from repo root; use -w for a single package. After changes outside debug mode, restart from step 1.
npm run compile — references/compile.md (TS4023: ts4023-effect-errors, TS1261: ts1261-filename-casing)
npm run lint — fix new errors/warnings (defer in debug mode — see Debug mode)
Effect code: node_modules/.bin/effect-language-service diagnostics --project tsconfig.json (or --file <path>) — fix reported issues; read_lints does not surface Effect LS. Call the local bin directly, never bare npx (the unscoped registry name is a typosquat). If the bin is missing (fresh clone / pruned node_modules), note it and run npm install — do not skip silently or fall back to npx.
npm run test - See references/unit-tests.md
npm run bundle to ensure bundles still build
If working in packages that define test:web / test:desktop (e.g. packages/apex-ls): run from root npm run test:web -w <package-name> -- --retries 0 / npm run test:desktop -w <package-name> -- --retries 0 as needed. Skip if your changes are not in those packages.
node_modules/.bin/knip - check for dead code related to your changes (local bin, not npx). If the bin is missing, note it and run npm install — do not skip silently or fall back to npx.
npm run check:dupes and then look in jscpd-report (and parser-ast report if using check:dupes:parser-ast) to make sure none of your changes are flagged.Use when actively debugging a bug (repro, instrumentation, iterative fixes) — including Cursor Debug mode with runtime logging.
npm run compile or -w as needed). Fix compile errors that block running tests or the app.npm run lint (ESLint/Prettier). Clean up lint before merge / PR, not between repro iterations.If the user asks to suspend lint, stop running lint, or says lint is getting in the way of debugging:
npm run lint or use lint results to block progress until they ask to resume verification or move to pre-PR.Return to the full ordered checklist when leaving debug (e.g. pre-PR, session end).
minify if that helps debug)-w to specify runs for a single package. Never cd into a package.ERR_MODULE_NOT_FOUND you can rm -rf ~/.npm/_npx and re-run it. You'll have to agree to it (or pass -y to it)When creating plans in plan mode, include verification after the "actual" todos (full checklist; in debug work, note lint/knip/dupes run before merge).
references/unit-tests.md — unit testsreferences/compile.md — compile; TS4023 / TS1261 skills@.claude/skills/ts4023-effect-errors/ — TS4023@.claude/skills/ts1261-filename-casing/ — TS1261@.claude/skills/playwright-e2e/ — Playwright E2E