thinking-margin-of-safety
Agent skill fromtjboudreaux/cc-thinking-skills
When provisioning, setting a limit, or committing an estimate under uncertainty, size a buffer to residual error and the cost of breach—not to the optimistic edge.
How to install thinking-margin-of-safety
install thinking-margin-of-safety
# install the cc-thinking-skills pack with the skills CLI
npx skills add tjboudreaux/cc-thinking-skills# or add only this skill to Claude Code: copy the folder
skills/thinking-margin-of-safety/
# into
~/.claude/skills/thinking-margin-of-safety/ (all projects)
.claude/skills/thinking-margin-of-safety/ (one project)
1# Margin of Safety23Core rule: commit a buffered number when residual uncertainty plus breach cost can cause ruin or costly failure. Margin covers estimation error; it is not free slack for laziness.45## When to Use67- Capacity, timeouts, pool sizes, queue depths, storage, or SLA numbers under load uncertainty8- Timeline or budget commitments where underestimation is costly9- Architecture headroom when scaling or recovery is slow10- Any public or production commitment where being wrong has asymmetric downside1112## When NOT to Use1314- Breach is detected immediately and fixed near-zero cost (fast auto-scale, live-tunable limit)—static fat buffers waste resources15- `cost(buffer) > P(breach) × cost(breach)`—right-size or measure instead of maxing out16- Uncertainty is eliminable by measurement or lookup—get the real number first17- Stopping-criterion / search budget problems—use bounded rationality, not padding18- Fully known parameters and low stakes where edge optimization is the goal1920## Procedure21221. **Point estimate without padding.** State the base requirement in explicit units (RPS, weeks, GB, ms) and confidence (high / medium / low).232. **Uncertainty and breach cost.** List drivers (spike, growth, unknowns, dependency variance). State what fails if undershot: outage, missed launch, data loss, reputation—and whether failure is recoverable or ruinous.24…
Excerpt shown under the repository's MIT license.
