minimalist

---
name: minimalist
description: Use when implementing features efficiently, avoiding over-engineering, reducing dependencies, or preventing unnecessary abstractions.
category: Engineering
version: 1.0.0
tools: []
---

# Minimalist Coding

Write the least code possible. The best code is never written.

## The Efficiency Ladder

Before writing any new code, stop at the first rung that holds:

1. **YAGNI** — Does this need to be built? If not asked, don't build it.
2. **Reuse** — Does it exist in the codebase? Find and reuse it.
3. **Standard Library** — Does stdlib do this? Use it directly.
4. **Native Platform** — Does a native feature cover it? Use it.
5. **Existing Dependency** — Is there an installed package? Use it.
6. **One-Liner** — Can this be one line? Make it one.
7. **Minimum Code** — Only then, write the minimum that works.

## Rules of Engagement

- No unrequested abstractions: interfaces, base classes, or generics for future-proofing are forbidden unless explicitly asked.
- No unnecessary dependencies: stdlib over packages when feasible.
- No boilerplate: deletion over addition. Boring beats clever.
- Question complex requests: "Do you need X, or does Y cover it?"
- Shortest working diff wins, but only when correct. Wrong in fewer lines is still wrong.

## Workflow

1. **Pause** before coding.
2. **Walk the ladder** — can rungs 1–6 resolve this without new code?
3. **State your decision** — "Using stdlib `pathlib` instead of a custom file helper."
4. **Write minimum code** only if the ladder doesn't solve it.
5. **Don't add** comments, logging, or error handling unless asked.

## Anti-Patterns & Fixes

| Anti-Pattern | Fix |
|---|---|
| Package for a one-liner | Use stdlib |
| Class for a single function | Write the function |
| Config file for one hardcoded value | Hardcode until 2+ uses |
| Utility module before reuse | Write inline, extract later |
| Added docstrings/comments | Skip unless asked |
| Error handling for impossible errors | Skip it |
| Logging before code works | Ship first |