forcedotcom/salesforcedx-vscode

effect-best-practices

Enforces Effect-TS patterns for services, errors, layers, and atoms. Use when writing code with Effect.Service, Schema.TaggedError, Layer composition, or effect-atom React components.

لغة النص الأصلي: الإنجليزية

services-extension-consumption

Consume the salesforcedx-vscode-services extension API. Use when an extension depends on salesforcedx-vscode-services and you are registering commands, calling its services (Workspace, Connection, Project, Settings, FS, Channel, Media, prompts), watching…

لغة النص الأصلي: الإنجليزية

changelog

Polish the automated CHANGELOG on develop before the next stable build. Removes GUS refs, categorizes under-the-cover changes, improves customer-facing descriptions. Use when preparing/reviewing the changelog after a weekly prerelease promotion, or when user…

لغة النص الأصلي: الإنجليزية

drivable-vscode

Operate a real VS Code instance through drivable-vscode. Use for drivable VS Code, exploratory testing, customer bug reproduction, feature verification, screenshots, videos, or other evidence from VS Code.

لغة النص الأصلي: الإنجليزية

lit-webview-architecture

Design or refactor a Lit webview's package boundary, Effect service contract, host adapter, lifecycle, registration, or browser bundle. Use for VS Code webviews that separate browser-safe UI from extension-host APIs and message protocols.

لغة النص الأصلي: الإنجليزية

lit-webview-testing

Write or review browser component tests for Lit webviews and VSCode Elements. Use for Playwright component harnesses, fake Effect services, accessibility locators, shadow DOM boundaries, lifecycle tests, and deciding what belongs in component tests versus VS…

لغة النص الأصلي: الإنجليزية

vscode-elements-webviews

Integrate @vscode-elements/elements controls into Lit webviews. Use when adding or changing VSCode Elements selects, text fields, checkboxes, buttons, form association, controlled values, accessibility state, or VS Code theme styling.

لغة النص الأصلي: الإنجليزية

command-ui

Command palette, CodeLens, context menus, package.nls titles, and NotificationModeService. Use when adding a command, editing package.nls command titles, wiring success/progress, or calling vscode.commands.registerCommand / vscode.window.withProgress /…

لغة النص الأصلي: الإنجليزية

i18n-messages

Editing extension i18n message files and their consumers. Use when editing packages/*/src/messages/i18n.ts, adding/changing nls.localize strings, or choosing placeholder tokens (%s/%d/...).

لغة النص الأصلي: الإنجليزية

packagejson

package.json conventions for this repo. Use when editing/reviewing a package.json — name, types, browser, files, dependencies, devDependencies, packaging, scripts, or vscode contributes.

لغة النص الأصلي: الإنجليزية

announce-prerelease

Compose and send Slack announcement for pre-release builds. Summarizes changes compared to current marketplace version.

لغة النص الأصلي: الإنجليزية

release

Run the VS Code extension release workflow end-to-end. Use when publishing a release, running prerelease, verifying the release branch, polishing changelog for release, or installing release vsixes for verification.

لغة النص الأصلي: الإنجليزية

lit-components

Create or edit Lit components in this repository, including reactive properties and internal state.

لغة النص الأصلي: الإنجليزية

playwright-e2e

writing, running, and debugging Playwright tests; creating and recreating scratch orgs (Dreamhouse, minimal, non-tracking); working with their output from github actions

لغة النص الأصلي: الإنجليزية

external-consumers

Known external consumers of APIs from this monorepo's extensions. Use when changing public API surfaces (activate return types, exported types, services sub-objects), evaluating breaking changes, removing exports, or checking if anything uses a given API…

لغة النص الأصلي: الإنجليزية

gus-cli

Interact with the Gus Salesforce org via CLI (sf). Query, create, update work items; query team epics. Use when user mentions Gus, work items, epics, or GUS/Git2Gus workflows.

لغة النص الأصلي: الإنجليزية

feature-branch

Create feature branches for all work. Use when creating branches, checking out, or pushing. Prevents accidental pushes to protected branches.

لغة النص الأصلي: الإنجليزية

backlog-grooming

Triage the team's open GUS backlog — propose closing done-but-open work items (with code/test citations), flag under-specified items for grilling, catch wrong-epic / orphan / unpointed / dead-link items, and close completed epics. User-invoked.

لغة النص الأصلي: الإنجليزية

concise

Writing style for AI-consumed docs. Proactively apply when creating or editing any md file in .claude/skills/ or .claude/rules/ or .cursor/rules/ or .claude/plans/.

لغة النص الأصلي: الإنجليزية

core-extension-api

Public API exported by salesforcedx-vscode-core activate(). Use when modifying SalesforceVSCodeCoreApi, the api object in activate(), exports from core index.ts, services sub-object, or evaluating whether a change to core is breaking. Also use when someone…

لغة النص الأصلي: الإنجليزية

dependabot-alerts

Triage GitHub Dependabot security alerts into one-point GUS work items that bump the outermost consumer. User-invoked only.

لغة النص الأصلي: الإنجليزية

grill-me

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and…

لغة النص الأصلي: الإنجليزية

icons-src

Add custom SVG icons to salesforcedx-vscode-services for font generation. Use when adding new icons to media/icons-src, creating SVG icons for VS Code extension, or defining font-based icons.

لغة النص الأصلي: الإنجليزية

lsp-custom-requests

Serialize URIs correctly across LSP custom requests. Use when defining custom LSP requests/notifications with URI params, sending a `URI` over `Connection.sendRequest`, or debugging `[object Object]` / `EntryNotFound` /…

لغة النص الأصلي: الإنجليزية

paths

Prefer vscode-uri over node:path. Use when .ts files in /src import node:path or use path.join/basename/dirname/resolve, URI.file, or memfs paths.

لغة النص الأصلي: الإنجليزية

pr-draft

Draft PRs with trailing " - W-XXXXXXXX" in titles, conventional commit-style before it, GUS refs in body. Use when drafting PRs, PR titles, PR descriptions, opening PRs, or Git2Gus workflows.

لغة النص الأصلي: الإنجليزية

query-app-insights

Query Azure Application Insights telemetry data for command usage, extension activity, and performance metrics

لغة النص الأصلي: الإنجليزية

shipped-issues

Find open GitHub issues whose linked GUS work item is closed AND whose issue number appears in CHANGELOG.md, then close them. Use when user invokes /shipped-issues or asks to clean up shipped issues.

لغة النص الأصلي: الإنجليزية

span-file-export

Use file-based span/log export for AI consumption. Where it lives, how to enable/clear, record format for Node and Web. Use when enabling span file dump, debugging traces for AI, or configuring local observability.

لغة النص الأصلي: الإنجليزية

thermo-nuclear-code-quality-review

Run an extremely strict maintainability review for abstraction quality, giant files, and spaghetti-condition growth. Use for a thermo-nuclear code quality review, thermonuclear review, deep code quality audit, or especially harsh maintainability review.

لغة النص الأصلي: الإنجليزية

ts1261-filename-casing

Fix TS1261 when TypeScript reports two paths that differ only in casing (import vs include vs git index). Use when compile shows error 1261 or "Already included file name ... differs from file name ... only in casing".

لغة النص الأصلي: الإنجليزية

ts4023-effect-errors

Fix TS4023 errors when exporting Effect-based functions. Use when TypeScript reports "has or is using name 'X' from external module but cannot be named" for Effect error types, or when knip flags error type exports as unused.

لغة النص الأصلي: الإنجليزية

typescript

TypeScript coding standards — apply when writing, reviewing, or refactoring .ts/.tsx, or naming/renaming .ts files (camelCase casing).

لغة النص الأصلي: الإنجليزية

verification

Verification steps for code changes. Use after ANY code change to ensure quality, or when creating plans because those should include verification steps.

لغة النص الأصلي: الإنجليزية

vscode-window-messages

Guidelines for using vscode.window.show*Message methods. Use when working with showInformationMessage, showWarningMessage, showErrorMessage.

لغة النص الأصلي: الإنجليزية

wireit

Author and use Wireit scripts for npm. Use when working with Wireit configuration, npm scripts, build pipelines, or when the user mentions Wireit.

لغة النص الأصلي: الإنجليزية

work-item-sequencing

Numbering convention for ordering GUS work items within an epic. Numeric prefixes in Subject__c express sequencing (do X before Y) and parallelism. Use when planning an epic, when the user states a dependency between work items, or when asked what's…

لغة النص الأصلي: الإنجليزية