PranavNagrecha/AwesomeSalesforceSkills / skills/admin/configuration-workbook-authoring
configuration-workbook-authoring
VerifiedAuthor the Salesforce Configuration Workbook — the structured, reviewable handoff document an admin uses to execute a feature across Objects/Fields, Page Layouts, Profiles/PSGs, Sharing, Validation, Automation, List Views, Reports, Integrations, and Data. Triggers: 'salesforce configuration workbook', 'admin handoff document', 'implementation workbook'. NOT for object design itself (use admin/custom-field-creation, admin/lookup-and-relationship-design, agents/object-designer/AGENT.md), NOT for permission set design (use admin/permission-set-architecture, agents/permission-set-architect/AGENT.md), NOT for Flow construction (use skills/flow/* and agents/flow-builder/AGENT.md), and NOT for the deployment manifest (use skills/devops/metadata-api-retrieve-deploy). More triggers: workbook row schema, recommended_agent, recommended_skills, row_id, source_req_id, RTM linkage block, not-in-scope-this-release, descope ledger, version-lock the workbook, check_workbook.py.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 27.2 KB |
| references/examples.md | markdown | 8.7 KB |
| references/gotchas.md | markdown | 15.9 KB |
| references/llm-anti-patterns.md | markdown | 6.1 KB |
| references/well-architected.md | markdown | 6.9 KB |
| references/worked-examples.md | markdown | 20.4 KB |
| scripts/check_workbook.py | script | 33.3 KB |
| templates/config-workbook.md | markdown | 8.2 KB |
| templates/configuration-workbook-authoring-template.md | markdown | 2.7 KB |
templates/config-workbook.md
View on GitHub# Configuration Workbook — `<Release_Name>`
> Canonical 10-section workbook template. Copy to
> `docs/workbooks/<release>/cwb.md` and fill. Empty sections stay in the file
> with a single row whose `target_value` is `not-in-scope-this-release`.
>
> Authoritative skill: `skills/admin/configuration-workbook-authoring`.
> Validate before sprint commit (exit code 1 on any finding, so it drops
> straight into a hook or a CI step; do not pass `--allow-empty-section` at
> commit time):
> `python3 skills/admin/configuration-workbook-authoring/scripts/check_workbook.py --workbook <path>`
---
## Header
| Field | Value |
|---|---|
| Release | `<release-id>` |
| Sprint commit date | `YYYY-MM-DD` |
| Author | `<name>` |
| Reviewers | `<name>, <name>` |
| RTM source | `<path or URL>` |
| Status | `draft` \| `committed` \| `executed` |
---
## RTM Linkage Block
Cross-reference table — every row in this workbook traces back to a fit-gap
row and a user story, and forward to a single downstream agent.
| row_id | source_req_id | source_story_id | recommended_agent | status |
|---|---|---|---|---|
| CWB-OBJ-001 | FG-014 | US-2031 | object-designer | proposed |
---
## Per-Row Schema
Every row in every section uses this schema:
| Field | Required | Notes |
|---|---|---|
| `row_id` | yes | Stable, unique within the workbook (e.g. `CWB-FIELDS-014`). |
| `section` | yes | Must match one of the 10 canonical section names below. |
| `target_value` | yes | The configurable value (API name, formula, picklist set, sharing rule criterion, etc.). |
| `owner` | yes | Named human accountable for this row. Not a team alias. |
| `source_req_id` | yes | The RTM `req_id` (`REQ-XXX`), immutable and never reused. |
| `source_story_id` | yes | User-story id (e.g. `US-2031`). |
| `recommended_agent` | yes | Exactly ONE runtime agent id, optionally followed by `--flag` arguments. Must resolve to `agents/<id>/AGENT.md` whose frontmatter `status` is not `deprecated`. |
| `recommended_skills[]` | yes (≥ 1) | Skill ids the executing agent must consult; every entry resolves on disk (`<domain>/<slug>`, `<domain>/<slug> -> references/<file>.md`, or a repo-relative `templates/…` / `standards/…` path). |
| `status` | yes | One of `proposed`, `committed`, `in-progress`, `executed`, `verified`, `change-requested`. |
| `notes` | optional | Risks, ADR links, decision-tree branches cited. |
---
## Section 1 — Objects + Fields
| row_id | target_value | owner | source_req_id | source_story_id | recommended_agent | recommended_skills | status | notes |
|---|---|---|---|---|---|---|---|---|
| CWB-OBJ-001 | | | | | object-designer | | proposed | The object's `sharingModel` (OWD) is a row here, not in Section 4. |
---
## Section 2 — Page Layouts + Lightning Pages
| row_id | target_value | owner | source_req_id | source_story_id | recommended_agent | recommended_skills | status | notes |
|---|---|---|---|---|---|---|---|---|
| CWB-PG-001 | | | | | audit-router --domain=lightning_record_page | | proposed | `path-designer` instead for Path + Guidance rows. |
---
## Section 3 — Profiles + Permission Sets + PSGs
| row_id | target_value | owner | source_req_id | source_story_id | recommended_agent | recommended_skills | status | notes |
|---|---|---|---|---|---|---|---|---|
| CWB-PSG-001 | | | | | permission-set-architect | | proposed | |
---
## Section 4 — Sharing Settings
| row_id | target_value | owner | source_req_id | source_story_id | recommended_agent | recommended_skills | status | notes |
|---|---|---|---|---|---|---|---|---|
| CWB-SHR-001 | | | | | audit-router --domain=sharing | | proposed | Required: cite `sharing-selection.md` and the `Q<n>` branch that resolved it. OWD (`sharingModel`) belongs in Section 1, not here. |
---
## Section 5 — Validation Rules
| row_id | target_value | owner | source_req_id | source_story_id | recommended_agent | recommended_skills | status | notes |
|---|---|---|---|---|---|---|---|---|
| CWB-VR-001 | | | | | audit-router --domain=validation_rule | | proposed | Bypass infrastructure (Custom Permission + Custom Setting) is its own row. |
---
## Section 6 — Automation (Flow / Apex / Approvals)
| row_id | target_value | owner | source_req_id | source_story_id | recommended_agent | recommended_skills | status | notes |
|---|---|---|---|---|---|---|---|---|
| CWB-AUT-001 | | | | | flow-builder | | proposed | Required: cite `automation-selection.md` and the `Q<n>` branch that resolved it. `apex-builder` / `apex-refactorer` / `assignment-and-auto-response-rules-designer` per the branch. |
---
## Section 7 — List Views + Search
| row_id | target_value | owner | source_req_id | source_story_id | recommended_agent | recommended_skills | status | notes |
|---|---|---|---|---|---|---|---|---|
| CWB-LV-001 | | | | | audit-router --domain=list_view_search_layout | | proposed | |
---
## Section 8 — Reports + Dashboards
| row_id | target_value | owner | source_req_id | source_story_id | recommended_agent | recommended_skills | status | notes |
|---|---|---|---|---|---|---|---|---|
| CWB-RPT-001 | | | | | audit-router --domain=report_dashboard | | proposed | |
---
## Section 9 — Integrations
| row_id | target_value | owner | source_req_id | source_story_id | recommended_agent | recommended_skills | status | notes |
|---|---|---|---|---|---|---|---|---|
| CWB-INT-001 | | | | | integration-catalog-builder | | proposed | Reference Named Credentials by alias only. Never inline secrets. |
---
## Section 10 — Data + Migration
| row_id | target_value | owner | source_req_id | source_story_id | recommended_agent | recommended_skills | status | notes |
|---|---|---|---|---|---|---|---|---|
| CWB-DAT-001 | | | | | data-loader-pre-flight | | proposed | Cutover order for the whole release lives in this row's notes. |
---
## JSON Envelope Schema
The workbook's machine-readable companion (`cwb.json`) conforms to:
```json
{
"release": "string (release id)",
"sprint_commit_date": "YYYY-MM-DD",
"author": "string",
"reviewers": ["string"],
"rtm_source": "string (path or URL)",
"status": "draft | committed | executed",
"rows": [
{
"row_id": "string (unique)",
"section": "Objects+Fields | Page Layouts+Lightning Pages | Profiles+Permission Sets+PSGs | Sharing Settings | Validation Rules | Automation | List Views+Search | Reports+Dashboards | Integrations | Data+Migration",
"target_value": "string",
"owner": "string (named human)",
"source_req_id": "string (RTM id)",
"source_story_id": "string (story id)",
"recommended_agent": "string (one of the runtime roster)",
"recommended_skills": ["string (skill id)"],
"status": "proposed | committed | in-progress | executed | verified | change-requested",
"notes": "string (optional)"
}
]
}
```
---
## CSV Schema
Flat one-row-per-row export at `cwb.csv`:
```
row_id,section,target_value,owner,source_req_id,source_story_id,recommended_agent,recommended_skills,status,notes
```
`recommended_skills` is pipe-delimited within the cell:
`admin/object-creation-and-design|admin/custom-field-creation`.
---
## Hand-off Block
After sprint commit, hand off rows to downstream agents:
| row_id | recommended_agent | invocation |
|---|---|---|
| CWB-OBJ-001 | object-designer | `Follow agents/object-designer/AGENT.md to execute row CWB-OBJ-001 from this workbook.` |
| CWB-PSG-001 | permission-set-architect | `Follow agents/permission-set-architect/AGENT.md in design mode to execute row CWB-PSG-001.` |
| CWB-AUT-001 | flow-builder | `Follow agents/flow-builder/AGENT.md to execute row CWB-AUT-001.` |
| CWB-SHR-001 | audit-router | `Follow agents/audit-router/AGENT.md --domain=sharing to verify row CWB-SHR-001.` |
---
## Descope / Defer Ledger
Requirements that deliberately produced no row. Keep it: a missing row is
invisible without it, and `agents/config-workbook-author/AGENT.md` Step 3
refuses (`REFUSAL_DESCOPE_BREACH`) if a descoped story reappears as a row.
| source_req_id | source_story_id | fit-gap decision | Recorded as | Rationale | Decided by | Date |
|---|---|---|---|---|---|---|
| `REQ-XXX` | `US-XXXX` | `descope` \| `defer` \| `escalate` | No workbook row / carried to `<release>` / ADR required | `<why>` | `<forum>` | `YYYY-MM-DD` |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |