principle-make-operations-idempotent

What problem does it solve? Commands, lifecycle steps, and processing loops that run amid crashes, restarts, and retries often leave partial state behind, turning every restart into a debugging session. This Skill provides a design principle for making operations converge to the correct end state regardless of how many times they run or where they start from. ## Core Features & Use Cases - Convergent Startup Pattern: Scan for existing state, clean stale artifacts, and adopt live sessions instead of assuming a clean slate. - Content-Based Cleanup: Compare artifacts by content equivalence rather than creation order to avoid duplicate or orphaned resources. - Self-Healing Locks and Scheduling: Use PID-based stale lock detection and respawn failed work cleanly with fresh input regenerated after each cycle. - Use Case: When writing a CLI command that provisions resources or a worker loop that processes a queue, apply the three-question test (runs twice, crashed midway, converges?) to identify where reconciliation steps are needed. ## Quick Start Ask the AI to review your command or processing loop using the principle-make-operations-idempotent skill to check whether it converges after crashes and retries.