Skip to content

Commit 19937ad

Browse files
committed
docs(skills): back up critical config before mutating — undo-path discipline in SKILL.md
1 parent eace839 commit 19937ad

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

skills/flashduty/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,8 @@ Configuration, permission-model, enrichment, monitor, and on-call questions are
4747

4848
Read verbs (`list`, `get`, `info`, `detail`, `timeline`) are free. Mutating verbs (`create`, `update`, `delete`, `merge`, `ack`, `close`, `assign`, `move`, …) change state — recommend the action and get explicit per-target confirmation first. `merge` / `delete` are **irreversible** — double-check IDs. `create` notifies responders/subscribers. `list` before any bulk mutate to confirm the IDs.
4949

50+
**Keep an undo path — back up before overwriting.** Before `update` / `upsert` / `delete` on critical config (escalation policies, schedules, integrations, routing, status pages, alert rules, notification templates), fetch the current object with the matching read verb and save it to `backups/<resource>_<id>_<timestamp>.json` in your workspace. Your completion report must state: what changed, where the backup file is, and how to restore (re-upsert the saved JSON / delete the created IDs). For `create`-only changes skip the backup — report the undo (delete) instead. This is the only undo path for resources without server-side history: one read call buys recoverability.
51+
5052
## Compound flows — bundled scripts
5153

5254
Some asks span several commands. For those the skill ships a script that fetches everything in one call — run it as your **first action** for that ask, rather than hand-picking commands and writing the rest from memory:

0 commit comments

Comments
 (0)