Skip to content

PranavNagrecha/AwesomeSalesforceSkills / skills/admin/fsl-scheduling-optimization-design

fsl-scheduling-optimization-design

Verified

Use this skill to design, configure, and troubleshoot the Field Service Lightning (FSL) Optimizer — including selecting optimization type (Global, In-Day, Resource Schedule), understanding the priority-score model, configuring travel mode (Aerial vs Street-Level Routing), and tuning optimizer behavior for specific scheduling objectives. NOT for work rules and service-objective weights on a scheduling policy — use admin/fsl-scheduling-policies. NOT for ESO adoption and territory sizing — use architect/fsl-optimization-architecture.

templates/fsl-scheduling-optimization-design-template.md

View on GitHub
# FSL Scheduling Optimization Design — Work Template

Use this template when designing, configuring, or troubleshooting the Field Service Lightning Optimizer.

## Scope

**Skill:** `fsl-scheduling-optimization-design`

**Request summary:** (fill in what the user or project needs)

---

## Context Gathered

Record answers to the Before Starting questions before proceeding.

| Question | Answer |
|---|---|
| FSL Optimizer license confirmed active? | ☐ Yes / ☐ No / ☐ Unknown |
| Current optimization type in use | Global / In-Day / Resource Schedule / None |
| Geographic territory profile | Rural / Suburban / Urban / Mixed |
| Travel mode currently configured | Aerial (default) / Street-Level Routing (add-on) |
| Predictive traffic needed? | ☐ Yes / ☐ No |
| Scheduling decision context | Pre-day bulk planning / Same-day disruption / Single resource |
| % of appointments with null DueDate | (run SOQL report — see data quality check below) |
| % of appointments with null Priority | (run SOQL report) |

---

## Data Quality Pre-Check

Run this SOQL before any optimizer configuration or troubleshooting:

```soql
SELECT Id, Subject, DueDate, Priority, Status, ServiceTerritoryId
FROM ServiceAppointment
WHERE Status NOT IN ('Completed', 'Cancelled', 'Cannot Complete')
  AND (DueDate = null OR Priority = null)
ORDER BY CreatedDate DESC
```

**Result count:** ___________

If result count > 0: resolve data quality issues before proceeding with optimizer configuration.

---

## Optimization Type Selection

| Decision Factor | Your Situation |
|---|---|
| Planning horizon | Same-day / Next day / 2–7 days |
| When decisions are made | Pre-shift / During shift / Ad-hoc |
| Who triggers optimization | Automated (Flow/API) / Dispatcher manual / Scheduled job |
| Should existing confirmed appointments be moved? | ☐ Yes (Global OK) / ☐ No (use In-Day or lock appointments) |

**Selected optimization type:** ___________________________

**Justification:** (explain why this type fits the use case)

---

## Priority Tier Model

Define the priority tiers for this org before configuring the optimizer:

| Priority Value | Score (approx.) | Use Case | SLA Response Window |
|---|---|---|---|
| 1 | ~25,500 pts | Emergency / SLA breach imminent | < 4 hours |
| 2 | | Urgent | < 8 hours |
| 3 | | High — next business day | 1 business day |
| 4 | | Standard | 2–5 business days |
| 5–7 | | Routine maintenance | Flexible window |
| 8–10 | | Lowest urgency | Background / batch |

**How Priority is set on appointment creation:** (Flow / Apex / default value / manual)

---

## Travel Mode Decision

| Factor | Assessment |
|---|---|
| Territory density | Rural / Suburban / Urban |
| Road deviation from straight-line | Low / High |
| Traffic variation during workday | Minimal / Significant |
| Street-Level Routing license available? | ☐ Yes / ☐ No |

**Selected travel mode:** Aerial / Street-Level Routing

**Justification:**

---

## Optimization Run Configuration

| Setting | Value |
|---|---|
| Optimization job name | |
| Scheduling policy assigned | |
| Time horizon | ___ days |
| Trigger mechanism | Scheduled job / Flow invocable / Manual dispatcher |
| Trigger time (if scheduled) | |
| Territory scope | All territories / Specific territory list |

---

## Approach

Which pattern from SKILL.md applies?

- [ ] Weekly Global Optimization at Start of Day
- [ ] In-Day Optimization Triggered by Cancellation Event
- [ ] Resource Schedule Optimization for Single Technician Resequencing
- [ ] Other: ___________________________

**Justification:**

---

## Checklist

- [ ] FSL Optimizer license confirmed active
- [ ] Data quality pre-check run — null DueDate and Priority count is 0 or remediation plan is in place
- [ ] Correct optimization type selected and documented with justification
- [ ] Travel mode selected (Aerial or Street-Level Routing) with justification documented
- [ ] Scheduling policy assigned to optimizer run has Service Resource Availability work rule
- [ ] Time horizon set appropriately for optimization type
- [ ] Priority tier model defined — Priority 1 reserved for genuine emergencies
- [ ] Optimization run tested in sandbox with representative data
- [ ] Post-run unscheduled appointment rate reviewed and acceptable (<5% target)
- [ ] Optimizer job logs checked for errors after first production run
- [ ] Dispatcher runbook created for reviewing and confirming optimizer output

---

## Notes

Record any deviations from standard patterns and why:
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall