b2c-plugin-catalog-reducer

Bonsai-backed official documentation and web research workflow. Use before technical changes that depend on platform behavior, when fetching documentation or web pages, when listing/pruning the local research cache, or when importing manually gathered notes.

Create and extend Salesforce B2C Developer Tooling CLI plugins (commands, hooks, middleware, scaffolds). Use when building the target B2C plugin for this repo, registering hooks, or troubleshooting plugin loading during the catalog reducer migration.

Guidance for adding or modifying product selection filters in the current catalog reducer under tmp/, while preserving ordering semantics, statistics, and XML compatibility. Use when implementing or reviewing changes in tmp/lib/filters, tmp/lib/filterManager.js, tmp/lib/parser.js, or config-driven selection behavior.

Verification playbook for catalog reducer behavior changes, including run commands, output checks, and regression signals across catalog, inventory, and pricebook XML outputs under tmp/. Use after modifying reducer logic, filters, parser flow, or config-driven selection settings.

Design stable oclif command output contracts with clean --json stdout, stderr diagnostics, and structured error codes. Use when defining plugin command output, exit behavior, or automation-facing error handling during the catalog reducer migration.

Build, configure, and troubleshoot oclif CLI plugins (commands, hooks, plugin bundles). Use when structuring the future catalog reducer plugin, wiring package.json, or linking plugins for local development.

Create new Agent Skills for GitHub Copilot with proper structure, frontmatter, and bundled resources. Use when asked to "create a skill", "make a new skill", "scaffold a skill", or when building specialized AI capabilities. Generates SKILL.md files following the agentskills.io specification with Forward best practices for Salesforce development.

Apply maintainability guardrails for TypeScript Node CLI code during the catalog reducer migration: small modules, explicit contracts, adapter boundaries, and automation-safe errors. Use when refactoring reducer logic into a plugin-oriented codebase.

Write reliable Vitest tests for oclif command paths, migration adapters, and JSON/error contracts. Use when adding plugin command tests, refactoring mocks, or fixing flaky test isolation during the catalog reducer migration.