slicc: Skill for Claude Code

verifying-before-push

Run the full verification pass before committing, pushing, or opening or updating a PR. These commands mirror the CI gates in .github/workflows/ci.yml; running them locally first is the fastest way to avoid a red PR.

Quick Reference

npm run verify
npm run typecheck
npm run test
npm run test:coverage
npm run build
npm run bundle-size
node packages/dev-tools/tools/check-touched-exemptions.mjs

Run npm run verify first because formatting is the most common CI failure. Do not omit the separate check-touched-exemptions.mjs command: npm run verify does not include it. npm run bundle-size needs the build to have run first — it measures files in dist/.

Pre-push lint gate (automatic)

The .husky/pre-push hook runs the full CI lint gate automatically before every push to a feature branch. It mirrors every check from the CI lint job — biome, prettier, custom lint scripts, complexity gate, manifest justifications, and knip dead-code detection — all in parallel (~6 s wall-clock), then the autofix-drift check (below) serially, because it writes.

You can also run it manually:

npm run verify                         # Same gate, run on demand

Escape hatch: git push --no-verify bypasses the gate when needed.

The standard pass

Run every command in order:

npm run verify                         # Lint gate (mirrors CI lint job)
node packages/dev-tools/tools/check-touched-exemptions.mjs  # NOT in npm run verify — easy to miss
npm run typecheck
npm run test
npm run test:coverage                  # Enforces minimum coverage thresholds
npm run build
npm run bundle-size                    # Bundle budgets; needs the build above

The check-touched-exemptions.mjs gate runs right after lint because it catches grandfathered debt that lint alone misses. See the section below for details.

Lint

Run npm run lint. It runs biome check --write . over JS/TS/JSON/CSS and prettier --write . over the remaining doc / config-text formats (Markdown, YAML, HTML), then lint:docs (CLAUDE.md size limits), lint:no-comments (no-op on main; hard fail on the no-comment benchmark branch), lint:skills (tessl SKILL.md lint), lint:skill-router (developer-skill router and alias sync), lint:no-innerhtml, lint:layer-back-edges (no new imports pointing up a per-package layer stack — baseline-ratcheted; fix the layering, never grow layer-back-edge-baseline.json or layer-back-edge-baseline-{node-server,cloudflare-worker}.json), lint:no-float-probes (the ten names in check-no-float-probes.mjs's FLOAT_PROBE_NAMES — isExtensionRealm, isChromeExtensionRealm, hasLocalNodeServer, resolveFloatTopology, getChromeExtensionRealm, setChromeExtensionRealm, hasChromeRuntimeConnect, canConnectToChromeRuntime, getExtensionDelegateId, setExtensionDelegateId — plus the raw __slicc_connect_mode global-bag key; no new read under scoops/, tools/, kernel/ except kernel/host.ts / kernel/kernel-worker.ts — baseline-ratcheted, starts empty; ask the injected CapabilityBroker instead, never grow float-probe-baseline.json), lint:record-string-unknown (no new Record<string, unknown> in non-test source — baseline-ratcheted; name the shape, or suppress a genuinely untyped payload with // biome-ignore lint/plugin: <reason>, never grow record-string-unknown-baseline.json), lint:patches, lint:swift-pins (GitHub SPM packages dual-pinned in Package.swift and xcodegen project.yml must overlap — see packages/dev-tools/swift-pin-reconcile/), lint:swift-deps (SPM unused-dependency gate — see below), lint:swift-forbidden-imports (widget hosts / SliccWidgetKit must not import WebRTC — see below), lint:dead-flags (registry vs isFeatureEnabled / getFeatureValue / Cherry host / worker overlay keys; waiver // unused-flag-ok), and lint:duplication.