Runbook Index

E2E

• e2e-tests: E2E tests rules and guidelines — Use for writing/maintaining Playwright tests; selectors, running single tests, no timeouts.
• e2e-triage: Quickly triage failing Playwright tests without timeouts — Use when E2E tests fail locally or in CI; fix selectors/flow.

Meta / Shared

• fix-codegen-drift: Resolve generated types drift between schema and committed files — Use when CI or agent:check reports codegen drift.
• always-colocate-tests: Always co-locate automated tests — Use to check test placement and naming.
• finalizing-changes: Finalizing changes — Use as a pre-PR checklist (tests, cleanup, a11y, checks).
• use-yarn-not-npm: Use Yarn (Classic) not npm — Use for package management consistency.
• never-run-commands-in-the-root-directory: Never run commands in the root directory — Use to run commands within subprojects only.
• project-description: Project overview, gameplay, and story — Use for high-level context and structure.
• non-player-characters: A description of all non player characters — Use for lore and NPC references.
• ts-checks: Run and triage TypeScript checks reliably; handle noisy tests — Use to get parseable tsc output and keep checks green without weakening jest.
• commit-sequencing: Create clean, multi-commit changes safely without empty commits — Use when preparing multiple commits locally.

Maintenance

• After adding or editing runbooks or this index, run yarn agent:runbook:sync (updates .cursor/skills/).
• Verify no drift with yarn agent:check.
• Replaced system: runbooks used to sync to .cursor/rules/*.mdc; that is deprecated in favor of .cursor/skills/. Do not reintroduce rules-based sync for runbooks.