repo-integration

Place and sequence Revenue Cloud metadata, data plans, and UX templates in the repository.

5|3|Updated Sep 9, 2026
One-click install
npx skills add https://github.com/SalesforceLabs/revenue-cloud-foundations --skill repo-integration-salesforcelabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-integration
Source: https://github.com/SalesforceLabs/revenue-cloud-foundations/tree/main/.cursor/skills/repo-integration
Command: npx skills add https://github.com/SalesforceLabs/revenue-cloud-foundations --skill repo-integration-salesforcelabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding new features to a Salesforce Revenue Cloud repository requires knowing exactly where each artifact belongs and in what order it must deploy. This Skill removes the guesswork by mapping every artifact type to its correct directory and enforcing dependency ordering across metadata deploys, data loads, and UX assembly. ## Core Features & Use Cases - Directory Placement Rules: Maps each artifact type (Apex, LWC, flexipages, layouts, profiles, SFDMU data plans, Robot tests, context plans) to its correct location across force-app/, unpackaged/, templates/, and datasets/. - Dependency Ordering: Defines the full prepare_rlm_org step sequence, data load order (PCM before pricing, billing, rating), and reverse-order deletion rules to avoid foreign-key constraint failures. - UX Drift Capture: Guides the capture-and-writeback workflow that syncs org-side UX changes back into templates/ via capture_ux_drift and apply_ux_drift flows. - Use Case: When adding a new feature, follow the checklist to create a feature flag in cumulusci.yml, place metadata, register CCI tasks, wire a prepare_<feature> sub-flow, and regenerate CCI references. ## Quick Start Ask the agent to read the repo-integration skill and tell you where to place a new flexipage, data plan, and permission set for a feature you are adding.

Frequently Asked Questions about repo-integration

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

FAQPage Schema
How do I add a new feature to a Salesforce CumulusCI repository?

Add a boolean feature flag under project.custom in cumulusci.yml, place metadata in the correct directory, register insert/delete/extract CCI tasks, create a prepare_<feature> sub-flow, and wire it into prepare_rlm_org. Then regenerate CCI references with the provided Python script.

Where should flexipages and layouts go in a Salesforce repo?

Flexipages go in templates/flexipages/standalone/<feature>/ for new overrides or patches/<feature>/ for additive changes. Layouts go in templates/layouts/base/ or templates/layouts/<feature>/, never directly in force-app/.

What is the correct data load order for Revenue Cloud data plans?

Load products (qb-pcm) first, then pricing, DRO, tax, billing, CLM, rating, and rates. Deletion runs in reverse dependency order, starting with rates, to avoid foreign-key constraint violations.

Can I edit unpackaged/post_ux files directly?

No. The unpackaged/post_ux/ directory is fully regenerated by the assemble_and_deploy_ux task. Edit the source templates/ directory instead, or use the capture_ux_drift and apply_ux_drift flows to write org changes back to templates.

Why does my deploy fail when a feature flag is off?

The failure happens when a base or always-on template references metadata that only exists under a feature-gated unpackaged/post_<feature>/ path. Move the reference into that feature's patch directory so it only assembles when the flag is enabled.