Idempotent Redundancy

by parcadeid07ff4b06b62No license3.9K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 8 months ago

Idempotent Redundancy

Instructions onlySoftware Development
AI-generated overview

Guidance for making redundant fallback paths idempotent to avoid loops, churn, or data corruption.

What it does
This skill provides a short set of instructions on designing redundant paths such as fallbacks and belt-and-suspenders mechanisms so they are idempotent. It lists recommended practices, including conditional writes, atomic write or rename operations, and reconciliation steps that are safe to repeat, along with practices to avoid. It produces guidance only and ships no scripts or assets.
When to use it
Use it when adding fallback or redundant logic to a system and you want to prevent repeated writes, repair loops, or conflicting writers. It is also relevant when reviewing reconciliation or repair steps that may run more than once.
Requirements
None beyond the agent; it is instructions only and ships no scripts.

Idempotent Redundancy

When adding redundant paths (fallbacks, belt-and-suspenders), make them idempotent.

Pattern

Redundancy without idempotency causes loops, churn, or data corruption.

DO

  • Use _is_merge: true for Braintrust updates
  • Check if value exists before writing (fallback only if missing)
  • Use atomic write/rename for file operations
  • Make reconciliation steps safe to run repeatedly

DON'T

  • Write unconditionally in fallback paths
  • Allow multiple writers to overwrite each other
  • Fire "repair" actions that can trigger more repairs

Source Sessions

  • a541f08a: "Redundancy is good only if idempotent"
  • 1c21e6c8: "Belt-and-suspenders, but make it idempotent"
  • 6a9f2d7a: "Idempotent repair hooks"

Source and attribution

Source:parcadei/continuous-claude-v3in.claude/skills/idempotent-redundancyat commitd07ff4b

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal