# Contributor handoff — QwikDev/qwik

> Canonical page: https://codevetter.com/unpack/qwik/agent-handoff

# Contributor handoff — QwikDev/qwik

Scanned commit 8eb4589be115eb8f2dabfd12c107dcc23647caec (2026-10-02). Generated by codevetter codevetter 1.15.0 on 2026-10-02.

Source inspection; upstream code and tests were not executed.

Tests and CI were inspected, not executed, and this report is a bounded source inventory rather than exhaustive coverage or a verification certificate. Future work should begin at the package and protocol boundary implicated by the task. Serialization and routing changes require coordinated reader/writer inspection, while optimizer behavior must account for both implementations. Repository setup and verification guidance is recorded below for later authorized work; none of those commands ran here.
- Read root AGENTS.md and the owning package sources first; the monorepo map identifies core, Router, React, utilities, DOM, Vite integration, optimizers, scaffolding, docs, and Insights. — [AGENTS.md#L16-18](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/AGENTS.md#L16-L18) [AGENTS.md#L40-61](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/AGENTS.md#L40-L61)
- Shared guidance originates in .ruler; generated AGENTS.md/CLAUDE.md should not be edited directly, and the inspected ruler-check workflow regenerates and checks their drift. — [AGENTS.md#L20-28](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/AGENTS.md#L20-L28) [.github/workflows/ruler-check.yml#L33-42](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/.github/workflows/ruler-check.yml#L33-L42)
- The documented focused loop is build.core.dev followed by the closest Vitest test or Chromium Playwright file; this audit inspected that guidance without executing its setup or verification commands. — [AGENTS.md#L93-109](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/AGENTS.md#L93-L109) [vitest.config.ts#L25-35](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/vitest.config.ts#L25-L35) [e2e/qwik-e2e/playwright.config.ts#L30-41](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/e2e/qwik-e2e/playwright.config.ts#L30-L41)
- Optimizer selection differs between local test configuration and default provider selection; account for tsOptimizer:true, QWIK_OPTIMIZER overrides, and Rust binding prerequisites when planning authorized checks. — [vitest.config.ts#L15-22](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/vitest.config.ts#L15-L22) [packages/qwik-vite/src/plugins/plugin.ts#L106-115](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik-vite/src/plugins/plugin.ts#L106-L115) [AGENTS.md#L85-90](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/AGENTS.md#L85-L90)
- For state changes, read serialization.md, SSR emitStateData, and DomContainer's reader together; preserve type/value pairing, shared references, and the distinction between qwik/state and sync-function metadata. — [packages/qwik/src/core/shared/serdes/serialization.md#L3-37](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik/src/core/shared/serdes/serialization.md#L3-L37) [packages/qwik/src/server/ssr-container.ts#L1342-1385](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik/src/server/ssr-container.ts#L1342-L1385) [packages/qwik/src/core/client/dom-container.ts#L180-202](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik/src/core/client/dom-container.ts#L180-L202)
- For action/loader protocol changes, inspect both server handlers and client transport; JSON-looking endpoints use Qwik serialization and have explicit invalidation, redirect, and caching semantics. — [packages/qwik-router/src/runtime/src/use-endpoint.ts#L55-73](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik-router/src/runtime/src/use-endpoint.ts#L55-L73) [packages/qwik-router/src/middleware/request-handler/handlers/action-handler.ts#L107-122](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik-router/src/middleware/request-handler/handlers/action-handler.ts#L107-L122) [packages/qwik-router/src/runtime/src/route-loaders.ts#L1126-1149](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik-router/src/runtime/src/route-loaders.ts#L1126-L1149) [packages/qwik-router/src/middleware/request-handler/handlers/loader-handler.ts#L97-127](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik-router/src/middleware/request-handler/handlers/loader-handler.ts#L97-L127)
- Loader behavior tests consume built qwikloader.debug.js, so source-only edits without regenerated output can leave the intended verification testing stale artifacts. (inferred) — [packages/qwik/src/qwikloader.behavior.unit.ts#L7-8](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik/src/qwikloader.behavior.unit.ts#L7-L8) [AGENTS.md#L95-98](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/AGENTS.md#L95-L98)
- Root tsc.check is not a substitute for every package's type checks: tsconfig.json explicitly excludes packages/qwik/src, scripts, and generated library trees. — [package.json#L295-297](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/package.json#L295-L297) [tsconfig.json#L45-56](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/tsconfig.json#L45-L56)
- Preserve compatibility boundaries: qwikCity delegates to qwikRouter, staticAdapter aliases ssgAdapter, and Node notFound is a deprecated pass-through slated for V3 removal. — [packages/qwik-router/src/buildtime/vite/plugin.ts#L65-70](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik-router/src/buildtime/vite/plugin.ts#L65-L70) [packages/qwik-router/src/adapters/ssg/vite/index.ts#L16-17](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik-router/src/adapters/ssg/vite/index.ts#L16-L17) [packages/qwik-router/src/middleware/node/index.ts#L100-105](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik-router/src/middleware/node/index.ts#L100-L105)
- Do not assume repository scripts are read-only: build/update scripts generate artifacts, scaffold commit writes files, and installDeps starts an external package manager. — [package.json#L198-209](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/package.json#L198-L209) [packages/qwik/src/cli/add/update-app.ts#L54-76](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik/src/cli/add/update-app.ts#L54-L76) [packages/qwik/src/cli/utils/install-deps.ts#L8-14](https://github.com/QwikDev/qwik/blob/8eb4589be115eb8f2dabfd12c107dcc23647caec/packages/qwik/src/cli/utils/install-deps.ts#L8-L14)

Every claim links to its cited files at the pinned commit. Citations identify source evidence; they do not establish runtime correctness. Independent CodeVetter scan — not reviewed by upstream maintainers.

## Public product links

- [CodeVetter](https://codevetter.com/)
- [Download](https://codevetter.com/download)
- [Documentation](https://codevetter.com/docs/)
- [Source](https://github.com/Codevetter/codevetter)