- Scope: applies to the entire repository unless a more specific AGENTS.md is added.
- Testing: run
npm run buildafter changes to verify the extension builds successfully. - UI verification: when modifying webview-facing UI or preview behavior, generate a preview screenshot using
make preview-screenshot(seescripts/preview_screenshot.pyfor options). Runmake preview-depsfirst to install Python dependencies and Playwright Chromium (with required system libraries). - Preview workflow details live in
README.md; follow the screenshot guidance at the top of that file when making UI changes. - Code style: prefer TypeScript strict defaults; avoid adding unnecessary dependencies.