PranavNagrecha/AwesomeSalesforceSkills / skills/admin/client-onboarding-design
client-onboarding-design
VerifiedUse this skill when designing the FSC client onboarding process — mapping document collection touchpoints, approval steps, compliance checkpoint sequencing, and welcome journey handoffs. Trigger keywords: client onboarding design, onboarding workflow requirements, document collection flow, compliance checkpoint, welcome journey, intake process design. NOT for configuring the Action Plan template itself — use admin/fsc-action-plans. NOT for OmniScript screen and branching requirements — use admin/omniscript-flow-design-requirements.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.9 KB |
| references/examples.md | markdown | 8.1 KB |
| references/gotchas.md | markdown | 8.0 KB |
| references/llm-anti-patterns.md | markdown | 7.8 KB |
| references/metadata-examples.md | markdown | 13.8 KB |
| references/well-architected.md | markdown | 6.5 KB |
| scripts/check_client_onboarding_design.pyexecutable | script | 6.3 KB |
| templates/client-onboarding-design-template.md | markdown | 4.9 KB |
references/metadata-examples.md
View on GitHub# Metadata Examples: Client Onboarding Design
The deployable form of the wealth onboarding design in `examples.md` Example 1: an Action Plan template whose compliance gate is an item dependency, the document types the onboarding collects, and the document checklist settings.
Grounding: Metadata API Developer Guide, ActionPlanTemplate fields, dependencies, and sample (`api_meta L15080-15365`), DocumentChecklistSettings (`api_meta L55674-55735`), DocumentType (`api_meta L55744-55800`); Object Reference, ActionPlan, ActionPlanTemplateItem, and ActionPlanTemplateVersion (`object_reference L21594-22765`); FSC Developer Guide, DocumentChecklistItem (`fsc_dev_guide L14520-14740`). Element names not found in those guides are marked UNVERIFIED.
Licence gate: creating or accessing Action Plan templates needs the Customize Application permission and the IndustriesActionPlans license.
## 1. Action Plan template with dependency gates
The KYC check releases the compliance review, and the compliance review releases the funding instructions. Every item is required; the dependencies create the order.
`force-app/main/default/actionPlanTemplates/Wealth_Onboarding_v1.apt-meta.xml`
```xml
<?xml version="1.0" encoding="UTF-8"?>
<ActionPlanTemplate xmlns="http://soap.sforce.com/2006/04/metadata">
<actionPlanTemplateItem>
<actionPlanTemplateItemValue>
<name>Subject</name>
<valueLiteral>Run KYC and AML identity check</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>Priority</name>
<valueLiteral>High</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>ActivityDate</name>
<valueFormula>StartDate + 2</valueFormula>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<displayOrder>1</displayOrder>
<isRequired>true</isRequired>
<itemEntityType>Task</itemEntityType>
<name>Run KYC check</name>
<uniqueName>WOB_Run_KYC_Check</uniqueName>
</actionPlanTemplateItem>
<actionPlanTemplateItem>
<actionPlanTemplateItemValue>
<name>Subject</name>
<valueLiteral>Capture beneficial ownership disclosure</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>Priority</name>
<valueLiteral>High</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>ActivityDate</name>
<valueFormula>StartDate + 2</valueFormula>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<displayOrder>2</displayOrder>
<isRequired>true</isRequired>
<itemEntityType>Task</itemEntityType>
<name>Capture beneficial ownership</name>
<uniqueName>WOB_Beneficial_Ownership</uniqueName>
</actionPlanTemplateItem>
<actionPlanTemplateItem>
<actionPlanTemplateItemValue>
<name>Subject</name>
<valueLiteral>Compliance officer review</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>Priority</name>
<valueLiteral>High</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>ActivityDate</name>
<valueFormula>StartDate + 4</valueFormula>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<displayOrder>3</displayOrder>
<isRequired>true</isRequired>
<itemEntityType>Task</itemEntityType>
<name>Compliance officer review</name>
<uniqueName>WOB_Compliance_Review</uniqueName>
</actionPlanTemplateItem>
<actionPlanTemplateItem>
<actionPlanTemplateItemValue>
<name>Subject</name>
<valueLiteral>Send account funding instructions</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>Priority</name>
<valueLiteral>Normal</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>ActivityDate</name>
<valueFormula>StartDate + 5</valueFormula>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<displayOrder>4</displayOrder>
<isRequired>true</isRequired>
<itemEntityType>Task</itemEntityType>
<name>Send funding instructions</name>
<uniqueName>WOB_Send_Funding_Instructions</uniqueName>
</actionPlanTemplateItem>
<actionPlanTemplateItemDependencies>
<name>Review after KYC</name>
<creationType>OnPreviousItemCompleted</creationType>
<previousTemplateItem>
<actionPlanTemplateItemValue>
<name>Subject</name>
<valueLiteral>Run KYC and AML identity check</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>Priority</name>
<valueLiteral>High</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>ActivityDate</name>
<valueFormula>StartDate + 2</valueFormula>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<displayOrder>1</displayOrder>
<isRequired>true</isRequired>
<itemEntityType>Task</itemEntityType>
<name>Run KYC check</name>
<uniqueName>WOB_Run_KYC_Check</uniqueName>
</previousTemplateItem>
<templateItem>
<actionPlanTemplateItemValue>
<name>Subject</name>
<valueLiteral>Compliance officer review</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>Priority</name>
<valueLiteral>High</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>ActivityDate</name>
<valueFormula>StartDate + 4</valueFormula>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<displayOrder>3</displayOrder>
<isRequired>true</isRequired>
<itemEntityType>Task</itemEntityType>
<name>Compliance officer review</name>
<uniqueName>WOB_Compliance_Review</uniqueName>
</templateItem>
</actionPlanTemplateItemDependencies>
<actionPlanTemplateItemDependencies>
<name>Funding after compliance review</name>
<creationType>OnPreviousItemCompleted</creationType>
<previousTemplateItem>
<actionPlanTemplateItemValue>
<name>Subject</name>
<valueLiteral>Compliance officer review</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>Priority</name>
<valueLiteral>High</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>ActivityDate</name>
<valueFormula>StartDate + 4</valueFormula>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<displayOrder>3</displayOrder>
<isRequired>true</isRequired>
<itemEntityType>Task</itemEntityType>
<name>Compliance officer review</name>
<uniqueName>WOB_Compliance_Review</uniqueName>
</previousTemplateItem>
<templateItem>
<actionPlanTemplateItemValue>
<name>Subject</name>
<valueLiteral>Send account funding instructions</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>Priority</name>
<valueLiteral>Normal</valueLiteral>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<actionPlanTemplateItemValue>
<name>ActivityDate</name>
<valueFormula>StartDate + 5</valueFormula>
<itemEntityType>Task</itemEntityType>
</actionPlanTemplateItemValue>
<displayOrder>4</displayOrder>
<isRequired>true</isRequired>
<itemEntityType>Task</itemEntityType>
<name>Send funding instructions</name>
<uniqueName>WOB_Send_Funding_Instructions</uniqueName>
</templateItem>
</actionPlanTemplateItemDependencies>
<actionPlanType>Industries</actionPlanType>
<category>Onboarding</category>
<description>Wealth client onboarding v1: KYC, beneficial ownership, compliance review, funding</description>
<isAdHocItemCreationEnabled>false</isAdHocItemCreationEnabled>
<name>Wealth Onboarding v1</name>
<targetEntityType>Account</targetEntityType>
<uniqueName>Wealth_Onboarding_v1</uniqueName>
</ActionPlanTemplate>
```
| Element | Notes |
|---|---|
| `targetEntityType` | `Account`. Test Financial Account anchoring separately; it is in the plan parent list from API 48.0 but not in the Metadata API's template parent list (gotcha 3) |
| `actionPlanTemplateItemDependencies` | API 59.0. `previousTemplateItem` is the prerequisite, `templateItem` the dependent. `OnPreviousItemCompleted` is the value in the guide's sample |
| `valueFormula` | `StartDate + N` is the due date; no `DaysFromStart` field exists |
| `isRequired` | Records that the task must be done; does not by itself create order |
| `category` | `Onboarding` (API 64.0); object reference picklist values are `Onboarding` and `Application` |
| `isAdHocItemCreationEnabled` | Required from API 59.0; `false` keeps the regulated sequence closed to ad hoc tasks |
| `uniqueName` | Required on the template and every item; keep stable across versions |
UNVERIFIED (2026-10-03): as in the guide's sample, each dependency repeats the full item definition; the guide does not say whether a shorter reference is accepted. UNVERIFIED (2026-10-03): a document checklist item can be a template item (`ItemEntityType` includes Document Checklist Item; the plan item API value is `DocumentChecklistItem`), but the item-value names for a document item are not in the Metadata API sample, so documents are kept out of this template and tracked as document checklist items on the account.
## 2. Document types
`force-app/main/default/documentTypes/Signed_Account_Agreement.documentType-meta.xml`
```xml
<?xml version="1.0" encoding="UTF-8"?>
<DocumentType xmlns="http://soap.sforce.com/2006/04/metadata">
<description>Client-signed account agreement collected before funding</description>
<isActive>true</isActive>
<masterLabel>Signed Account Agreement</masterLabel>
</DocumentType>
```
`force-app/main/default/documentTypes/Investment_Policy_Statement.documentType-meta.xml`
```xml
<?xml version="1.0" encoding="UTF-8"?>
<DocumentType xmlns="http://soap.sforce.com/2006/04/metadata">
<description>Investment policy statement agreed with the advisor</description>
<isActive>true</isActive>
<masterLabel>Investment Policy Statement</masterLabel>
</DocumentType>
```
## 3. Document checklist settings
`force-app/main/default/settings/DocumentChecklist.settings-meta.xml`
```xml
<?xml version="1.0" encoding="UTF-8"?>
<DocumentChecklistSettings xmlns="http://soap.sforce.com/2006/04/metadata">
<dciCustomSharing>false</dciCustomSharing>
<deleteDCIWithFiles>false</deleteDCIWithFiles>
</DocumentChecklistSettings>
```
`deleteDCIWithFiles` stays `false` so compliance evidence is not deleted with an uploaded file. `dciCustomSharing` enables custom sharing rules for document checklist items when set to `true`; leave it off unless the sharing model needs it.
## 4. package.xml
```xml
<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
<types>
<members>Wealth_Onboarding_v1</members>
<name>ActionPlanTemplate</name>
</types>
<types>
<members>Investment_Policy_Statement</members>
<members>Signed_Account_Agreement</members>
<name>DocumentType</name>
</types>
<types>
<members>DocumentChecklist</members>
<name>Settings</name>
</types>
<version>67.0</version>
</Package>
```
## Deploy order
1. `Settings: DocumentChecklist` and `DocumentType`.
2. `ActionPlanTemplate`, deployed by a user with the IndustriesActionPlans license.
3. Publish the template version in Setup if the deploy leaves it in `Draft` (the guide's sample deploys `status` `Draft`), so plans can be created from it.
## Verification
- Launch a plan on a test Account: only "Run KYC check" and "Capture beneficial ownership" tasks exist at launch.
- Complete the KYC task: "Compliance officer review" appears. Complete it: "Send funding instructions" appears.
- `SELECT Status, Version FROM ActionPlanTemplateVersion WHERE ActionPlanTemplate.UniqueName = 'Wealth_Onboarding_v1'` shows the published version. UNVERIFIED (2026-10-03): `UniqueName` as a queryable field on `ActionPlanTemplate` is inferred from the metadata field `uniqueName`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |