Activación diferida, nunca bloquear el editor, cada ajuste documentado.
Constitution — VS Code extension
Version 1.0.0 · Ratified 2026-11-10
These principles hold for every spec, plan and task of the extension. A spec may add rules; it never weakens these.
-
Activate lazily. The extension declares narrow activation events (a language, a command, a workspace file) and never
*oronStartupFinishedwithout a reason in the plan. Activation takes under 100 ms as measured by Developer: Show Running Extensions. -
Never block the editor. Heavy work runs asynchronously, in a language server or a worker, with cancellation tokens honoured. No synchronous file system or network call runs on the extension host's main path.
-
Every setting documented. Every setting in
contributes.configurationhas a type, a default and amarkdownDescription, and changes are picked up without reloading the window. A setting missing from the README fails the review. -
Clean up what you register. Every command, listener, provider and watcher is added to
context.subscriptionsor disposed explicitly. Deactivating the extension leaves no running timers or processes. -
Small and fast to install. The extension is bundled with esbuild or webpack into one file, and the packaged
.vsixhas a size budget in the plan. Unused dependencies are not shipped. -
Tested in the editor. Integration tests run with
@vscode/test-electronor@vscode/test-cliagainst the minimum supported VS Code version inenginesand the latest stable, in CI. A red test blocks the release.