repair-or-replace

Repair or Replace

Don't guess. Score it.

Repair or Replace is a skill that helps you decide whether to fix a broken item, buy a replacement, or recycle it. It builds a weighted decision matrix across five factors — repair cost, replacement cost, remaining lifespan, sentimental value, and environmental impact — then outputs a clear, score-backed recommendation with reasoning.

When to Use

Activate this skill when:

• An appliance, device, or tool is broken and you're unsure whether to fix it
• You have a repair estimate and want to compare it against replacement
• You want to factor environmental impact into a purchasing decision
• You're helping someone else decide what to do with a broken item
• You want a structured, defensible decision rather than a gut call

How It Works

The script takes structured input about the item and its condition:

It then scores the decision across five dimensions, applies weights, and produces a recommendation: Repair, Replace, or Recycle/Donate.

Decision Matrix

See references/decision-matrix.md for the full scoring algorithm.

Quick Reference

Recommendations

The script outputs one of three recommendations:

• Repair — the item is worth fixing. Cost-effective, has remaining lifespan, or has sentimental/environmental value.
• Replace — buying new is the better choice. Repair cost is too high relative to replacement, or the item is near end-of-life.
• Recycle/Donate — the item is beyond economic repair. Dispose of it responsibly or donate if still partially functional.

Each recommendation includes a confidence score (0-100) and itemized reasoning.

Files

• references/decision-matrix.md — full scoring algorithm and weight rationale
• references/item-lifespans.md — expected lifespan data for common items
• references/environmental-impact.md — e-waste and sustainability considerations
• scripts/repair_or_replace.py — the main decision engine
• scripts/sample_run.sh — example invocations for different item types

Common Pitfalls

1. Ignoring hidden repair costs. The repair estimate often excludes diagnosis fees, shipping, or secondary issues discovered during repair. Add 15-20% to the estimate for a realistic comparison.

2. Overestimating remaining lifespan. An 8-year-old washing machine with a 12-year expected lifespan doesn't have 4 "good" years left — the last quarter of lifespan tends to have escalating failure rates.

3. Forgetting energy efficiency. A new appliance may be significantly more energy-efficient, saving money over time. Factor this into the replacement cost (see references/environmental-impact.md).

4. Sentimental bias. It's easy to over-value items with emotional attachment. Be honest with the --sentimental score.

5. Not considering safety. Some failures (gas appliances, electrical) carry safety risks if repaired poorly. If in doubt, replace.

Verification Checklist

• Repair estimate is realistic (includes diagnosis, parts, labor)
• Replacement cost reflects a comparable-quality item
• Expected lifespan matches the item type (see references/item-lifespans.md)
• Condition score accounts for wear beyond the current fault
• Environmental factor considered (especially for large appliances)

License

MIT © Denis Voronin