sf-workflow-orchestration

Orchestrates Salesforce delivery through five waves of parallel agents with deterministic gates.

2|Updated Sep 12, 2026
One-click install
npx skills add https://github.com/grzmol/vibe-force --skill sf-workflow-orchestration-grzmol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sf-workflow-orchestration
Source: https://github.com/grzmol/vibe-force/tree/main/skills/sf-workflow-orchestration
Command: npx skills add https://github.com/grzmol/vibe-force --skill sf-workflow-orchestration-grzmol

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Coordinating multiple AI agents on a Salesforce feature often leads to file collisions, half-finished edits, unvalidated deploys, and broken work reaching production. This Skill structures Salesforce delivery as a five-wave workflow where parallel agents build on disjoint paths, machine-checked gates block failing work, and production deploys require validation before quick deploy. ## Core Features & Use Cases - Five-wave delivery model: scope and contract (wave 0), parallel build across Apex, LWC, metadata, and integration agents (wave 1), parallel checks (wave 2), serial validate-then-quick-deploy (wave 3), and post-deploy org verification (wave 4). - Collision-free parallelism: path ownership rules enforced by hooks so no two agents write the same file, with contracts fixing shared signatures before any code is written. - Blocking quality gates: vf-check commands for static analysis, Jest, Apex coverage, deploy validation, and smoke verification that must exit 0 before the next wave starts. - Use Case: A story asks to add renewal reminders to Opportunity, touching Apex, an LWC, a permission set, and a flow. The orchestrator scouts the impact, writes a contract, dispatches four engineers in one batch, gates the result, validates and quick-deploys to UAT, then verifies the feature in the org. ## Quick Start Ask the assistant to run the story workflow for your change, for example: run the five-wave Salesforce delivery workflow for the story "Add renewal reminders to Opportunity" starting with an impact map and contract.

Frequently Asked Questions about sf-workflow-orchestration

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

FAQPage Schema
How do I run a Salesforce story with parallel agents without file conflicts?

Dispatch all wave-1 build agents in a single batch with disjoint owned paths defined in the wave-0 contract. The pre-edit-guard hook denies any cross-slice or already-claimed write, so Apex, LWC, metadata, and integration agents cannot collide.

How do I safely deploy Salesforce metadata to production?

Run vf-check deploy-validate against the target org first, which records a validated job id, then run vf-check deploy-quick to deploy that exact job. Direct sf project deploy start against a production alias is denied by the pre-bash-guard hook.

When should I skip the full five-wave workflow?

Skip it for single-file typo fixes or one-attribute metadata changes; just edit and run vf-check static --changed. Bugs with unknown root cause need only wave 0 scouting first, and pure refactors need only waves 1-2 plus a diff review.

What happens when a quality gate fails during a wave?

The wave aborts and findings route back to the owning wave-1 agent for a source fix, then the gate re-runs. Thresholds are never lowered, assertions never weakened, and findings never suppressed to force a pass.

Can Salesforce metadata deploys be rolled back after a failure?

Salesforce has no native rollback; options are a forward fix, a destructive change, or re-deploying the previous git tag's source through validate plus quick deploy. Data written by defective code, deleted fields, and published platform events are not undone by a source rollback.

Why does the workflow forbid running project-wide checks during the build wave?

Wave-1 agents edit concurrently, so a project-wide gate would fail on a sibling's half-written files and block everyone. Agents run only narrow checks on their own files; the composite local gate runs in wave 2 after all builds finish.