- Follow a spec-first workflow: update
spec.mdbefore implementing behavior changes, interface changes, or new scope. - Keep repository-level decisions and major discussion outcomes summarized in
project-memory.mdso later agents do not need to rebuild context from code. - Webview UI must use VS Code theme CSS variables instead of hard-coded primary theme colors.
- Keep command ids, view ids, and webview message contracts centralized and typed instead of scattering raw string literals.
- Message passing between
CustomTextEditorProviderandWebviewViewProvidermust remain typed and must preserve CSP and nonce protections. - This POC simulates AI desktop integration only; do not directly couple it to a real LLM provider, cloud service, or VSCodium fork-specific patch unless the spec is explicitly expanded.
- Changes are not complete unless
npm run compile,npm run lint, andnpm run testpass from the repository root. - If local debug configuration is changed, keep VS Code Extension Host as the primary development and demo workflow.