- Do not run ESLint automatically after every small code change.
- Do not check TypeScript errors (e.g.
pnpm exec tsc,astro check) automatically; only run TypeScript validation when the user explicitly asks for it. - Prefer the editor diagnostics (
ReadLints) for quick feedback on files you touched. - Run
pnpm exec eslint ...,pnpm lint, or broader validation only when the user asks for it, when preparing a final verification for a risky change, or when diagnostics are insufficient to catch a likely issue. - When validation is skipped because the change is small, mention that briefly in the final response.
- Never use
document.querySelectorordocument.querySelectorAlldirectly. Always use the$and$$utilities fromsrc/lib/dom-selector.tsinstead, importing them from@/lib/dom-selector.
- One change per PR. Scope to a single component or section.
- Follow the template in
.github/pull_request_template.md. - Screenshots required for visual changes (mobile + desktop).
- Breaking changes must be listed explicitly or state "None".