> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qredence.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Development workflow

> Branch from main, work locally. Install: npm ci at repo root, pnpm install --dir web for web. Never run pnpm install at root (rewrites node_modules to pnpm layout). After code changes:...

Branch from `main`, work locally. Install: `npm ci` at repo root, `pnpm install --dir web` for web. Never run `pnpm install` at root (rewrites `node_modules` to pnpm layout). After code changes: `npm run check` (full output, fix all errors/infos). Run focused tests: `npx tsx ../../node_modules/vitest/dist/cli.js --run test/specific.test.ts` from package root. Never run `npm run dev`, `npm run build`, `npm run test` globally.

Web adapter updates (`prime-bridge.ts`, `event-mapper.ts`) must stay synchronized with `packages/coding-agent` public surface changes (`createAgentSession`, `AgentSessionEvent`, `ExtensionUIContext`, `IpythonKernelProvisioner`, `SessionManager`).

Related: [Testing](/fleet-prime-agent/how-to-contribute--testing), [Patterns and conventions](/fleet-prime-agent/how-to-contribute--patterns-and-conventions)