productionos-pause

ProductionOS Pause — Save Pipeline State

Save the current pipeline state so work can be resumed in a new session.

What Gets Saved

Write .productionos/CHECKPOINT.json:

{
  "command": "<active command name>",
  "step": "<current step number and name>",
  "iteration": "<current iteration if recursive>",
  "timestamp": "<ISO 8601>",
  "grade": {
    "before": "<BEFORE grade if available>",
    "current": "<latest grade>"
  },
  "artifacts": ["<list of .productionos/*.md files that exist>"],
  "uncommitted_files": ["<output of git diff --name-only>"],
  "pending_batches": "<number of unexecuted batches if mid-execution>",
  "context_notes": "<brief description of what was happening>"
}

Execution

1. Detect the active pipeline state:

   • Read .productionos/CONVERGENCE-LOG.md for iteration history
   • Read .productionos/CONVERGENCE-DATA.json for current scores
   • Check git status for uncommitted work
   • Count remaining batches from OMNI-PLAN.md or UPGRADE-PLAN.md

2. Write the checkpoint file

3. Display confirmation:

[ProductionOS] Pipeline paused.
  Command: {command}
  Step: {step}
  Grade: {current_grade}
  Uncommitted: {N} files

  Resume with: /productionos-resume

1. Do NOT commit or push — preserve the working state exactly as-is

Notes

• This is a lightweight state save, not a full context serialization
• The checkpoint is sufficient for a new session to pick up where this one left off
• Resume reads the checkpoint and routes to the appropriate command step