sessions

Guides implementation and review of Agents Window code under src/vs/sessions.

10|1|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/KevinHuangIsLearning/shortestpath-ide --skill sessions-kevinhuangislearning
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sessions
Source: https://github.com/KevinHuangIsLearning/shortestpath-ide/tree/main/.github/skills/sessions
Command: npx skills add https://github.com/KevinHuangIsLearning/shortestpath-ide --skill sessions-kevinhuangislearning

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working on the Agents Window in a VS Code-based codebase requires respecting strict layering rules, provider-neutral contracts, and observable-based state models. This Skill routes contributors to the correct specification and enforces architectural boundaries so changes to src/vs/sessions stay consistent and reviewable. ## Core Features & Use Cases - Core principles enforcement: Preserves layer direction (vs/sessions may import vs/workbench, never the reverse), keeps shared code provider-neutral, and models session state with observables rather than events. - Specification routing: Maps each change area (layout, automations, providers, mobile, sessions list) to its authoritative specification file so you read only what is relevant. - Proportional validation and spec edit gate: Directs you to run the smallest applicable checks (unit tests, valid-layers-check, type checking) and blocks specification edits unless an ownership, interface, lifecycle, or persistence contract genuinely changes. - Use Case: When adding a new Sessions sidebar grouping feature, use this Skill to identify SESSIONS_LIST.md as the owning spec, trace existing tests, implement through the correct sessions.*.main.ts entry point, and run focused unit tests plus the layer check. ## Quick Start Use the sessions skill to plan and implement my change to the Agents Window sidebar under src/vs/sessions.

Frequently Asked Questions about sessions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make changes to the Agents Window in src/vs/sessions?▼

Start with src/vs/sessions/README.md, then read only the specification matching your change area, such as SESSIONS.md for the session model or LAYOUT.md for workbench parts. Trace existing implementations and tests before editing, and keep changes within the owning layer.

What layering rules apply between vs/sessions and vs/workbench?▼

The vs/sessions layer may import vs/workbench and lower layers, but vs/workbench must never import vs/sessions. Run npm run valid-layers-check whenever imports or module ownership change to verify the boundary holds.

When should I update an architecture specification document?▼

Update a specification only when component ownership, an interface or lifecycle contract, a state machine, persistence, or a cross-component invariant changes. Bug fixes, styling, copy, telemetry fields, and settings defaults belong in code and focused tests, not specifications.

How should session and chat state be modeled in Sessions code?▼

Model mutable session and chat state with observables so consumers derive UI state reactively. Use events only for notifications, never as a parallel state model or for control flow.

Which tests should I run after a Sessions change?▼

Run the smallest checks covering the change: focused unit tests for affected behavior, npm run valid-layers-check for import or ownership changes, and targeted type checking for TypeScript edits. Documentation-only changes need link and path checks rather than a full build.