Never create sidecar checkpoint files, suffixed variants, or backup files as active state. If checkpoint state is conflicted, stale, or belongs to another mission, stop and report the conflict instead of renaming or backing up the active checkpoint.
Required Checkpoint Fields
objective
change_budget_estimate
path_selected (small or large)
promotion-type
short-name
relativeFile
long-name
issue-num
feature-folder
work-mode (minor-audit, full-feature, or full-bug; normalize legacy full to full-feature before persistence)
plan-path (minimal or full plan path)
completed_steps
next_step
last_updated
For short-path runs, also persist:
small_path_qc_summary
small_path_audit_artifacts
bootstrap_mode (manual-bootstrap or auto-small-dev)
phase0_execution_summary
resume_after_manual_bootstrap (next step token)
Update Protocol
Write checkpoint after every completed orchestration sub-step.
Treat checkpoint as source-of-truth for progress state.
Never claim mission completion until checkpoint marks final state.
Resume Protocol
On invocation:
Read checkpoint if it exists.
If incomplete, resume from next_step without re-running completed_steps.
If missing or completed, start at phase-0 intake.
If user explicitly requests restart, reset checkpoint and start phase-0.
1---2name: powershell-orchestration-state-machine-63description: Converted skill4---5# Converted skill67Applied rewrites:8- None910---11name: powershell-orchestration-state-machine12description: Checkpoint schema and resume protocol for long-running PowerShell orchestration workflows.13---1415# PowerShell Orchestration State Machine1617Canonical checkpoint and resume behavior for orchestration agents running multi-step PowerShell delivery flows.1819## When to Use This Skill2021Use this skill when:22- A workflow spans multiple delegations and commands.23- Execution may be interrupted and must resume deterministically.24- An orchestrator must avoid repeating completed steps.2526## Canonical Checkpoint Location2728- `artifacts/orchestration/powershell-orchestrator-state.json`2930Never create sidecar checkpoint files, suffixed variants, or backup files as active state. If checkpoint state is conflicted, stale, or belongs to another mission, stop and report the conflict instead of renaming or backing up the active checkpoint.3132## Required Checkpoint Fields3334- `objective`35- `change_budget_estimate`36- `path_selected` (`small` or `large`)37- `promotion-type`38- `short-name`39- `relativeFile`40- `long-name`41- `issue-num`42- `feature-folder`43- `work-mode` (`minor-audit`, `full-feature`, or `full-bug`; normalize legacy `full` to `full-feature` before persistence)44- `plan-path` (minimal or full plan path)45- `completed_steps`46- `next_step`47- `last_updated`4849For short-path runs, also persist:50- `small_path_qc_summary`51- `small_path_audit_artifacts`52- `bootstrap_mode` (`manual-bootstrap` or `auto-small-dev`)53- `phase0_execution_summary`54- `resume_after_manual_bootstrap` (next step token)5556## Update Protocol5758- Write checkpoint after every completed orchestration sub-step.59- Treat checkpoint as source-of-truth for progress state.60- Never claim mission completion until checkpoint marks final state.6162## Resume Protocol6364On invocation:651) Read checkpoint if it exists.662) If incomplete, resume from `next_step` without re-running `completed_steps`.673) If missing or completed, start at phase-0 intake.684) If user explicitly requests restart, reset checkpoint and start phase-0.
Run npx get-skill add drmoisan/powershell-orchestration-state-machine-6 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Converted skill It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
drmoisan (@drmoisan) published this skill. Their other Agent Skills are listed on their SkillMD profile.