Skip to content

RUNBOOK.md

Latest commit

 

History

History
56 lines (43 loc) · 2.07 KB

RUNBOOK.md

File metadata and controls

56 lines (43 loc) · 2.07 KB
Raw

Development and Release Runbook

Prerequisites

  • Node.js 20 or newer
  • npm
  • VS Code 1.96 or newer

Checks

npm ci
npm run format:check
npm run lint
npm run typecheck
npm test
npm run test:webview
npm run bundle
npm run package

The VSIX is created at the repository root. Production bundling excludes source maps; .vscodeignore excludes source, tests, fixtures, documentation, development configuration, and local data.

End users should install the published extension from the Visual Studio Marketplace or run:

code --install-extension spmisha134.skillops

The local VSIX installation below is for clean-profile verification before a new version is published.

Manual clean-profile verification

  1. Create a disposable VS Code profile.
  2. Install the generated VSIX with Extensions: Install from VSIX....
  3. Open a disposable multi-root workspace.
  4. Verify all six Command Palette commands and Explorer menu entries: Create Skill and Show Run Insights for Codex, Claude, and Gemini.
  5. Create Codex, Claude, and Gemini skills and compare their contents with the fixtures.
  6. Confirm duplicate creation is rejected and cancellation writes nothing.
  7. Point skillops.insights.codexHome, skillops.insights.claudeHome, and skillops.insights.geminiHome to representative synthetic sessions.
  8. For each provider, verify skill runs, No skill, malformed lines, empty state, warnings, and refresh. Verify light, dark, high-contrast dark, and high-contrast light themes, resizing, and keyboard navigation across both webviews.
  9. Inspect the VSIX contents and confirm no sessions, credentials, test fixtures, or source maps are included.

Post-publication verification

After an authorized release, confirm that the Marketplace page lists the expected version and that a clean Visual Studio Code profile can install spmisha134.skillops. Repeat the six primary command checks against the Marketplace build.

Do not publish, tag, or push a release without explicit authorization.