repo-integration

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

33|12|Updated Sep 24, 2024
One-click install
npx skills add https://github.com/bgaldino/rlm-base-dev --skill repo-integration-bgaldino
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-integration
Source: https://github.com/bgaldino/rlm-base-dev/tree/main/.cursor/skills/repo-integration
Command: npx skills add https://github.com/bgaldino/rlm-base-dev --skill repo-integration-bgaldino

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 rules. ## Core Features & Use Cases - Directory Placement Rules: Maps metadata, data plans, Apex scripts, Robot tests, and UX templates to their correct repository locations such as force-app/, unpackaged/post_*/, and templates/. - Dependency Ordering: Defines deploy and data-load sequences, including the 34-step prepare_rlm_org flow and reverse-order deletion rules. - UX Drift Capture: Guides capture and writeback of org UX changes into templates using capture_ux_drift and apply_ux_drift flows. - Use Case: When adding a new feature, follow the checklist to create a feature flag, place metadata, register CCI tasks, build a data plan, and wire a sub-flow into prepare_rlm_org. ## Quick Start Ask the agent to read the repo-integration skill and tell you where to place a new flexipage and its data plan for a new Revenue Cloud feature.

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 Revenue Cloud repository?

Add a feature flag in cumulusci.yml, place metadata in the correct directory, create an SFDMU data plan if needed, register CCI tasks, and wire a prepare_<feature> sub-flow into prepare_rlm_org. The skill provides a full checklist with YAML templates.

Where should I put flexipages and layouts in a Salesforce repo?

New flexipage overrides go in templates/flexipages/standalone/<feature>/ and additive patches in templates/flexipages/patches/<feature>/. Layouts go in templates/layouts/base/ or templates/layouts/<feature>/, never edited directly in unpackaged/post_ux/.

What is the correct order to load Salesforce Revenue Cloud data?

Load products (PCM) first, then pricing, DRO, tax, billing, CLM, rating, and rates. Deletion runs in reverse dependency order: rates, rating, billing, pricing, then PCM products last.

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?

Deploys fail when base or always-on templates reference feature-gated fields or components that only exist under unpackaged/post_<feature>/. Move those references into the feature's patch path so they only assemble when the flag is on.