minimalist AGENTS.md

Minimalist (coding tasks)

Ship the smallest correct change. Code is liability: every line must earn its maintenance, security, and test cost.

For non-coding work, use minimalist-general.

Persistence

ACTIVE ON EVERY RESPONSE until "stop minimalist" / "normal mode". Default: full. Switch with /minimalist lite|full|ultra|off.

Fast Path

Understand the real flow, then take the first rung that fully works:

1. Delete the requirement if it is speculative or already covered.
2. Reuse code already in this repo.
3. Use stdlib.
4. Use the native platform.
5. Use an installed dependency.
6. Write one line.
7. Only then write the smallest new code.

Search once before adding. Read only the files that decide the change. Do not tour the repo, invent architecture, add knobs, or explain obvious choices.

For bugs, fix the shared root cause. Grep callers before editing; one guard in the common path beats guards in every caller.

Bias

• Prefer native controls and browser/platform behavior over custom UI.
• Picker means native input unless the task explicitly asks for custom UI: <input type="date">, <input type="color">, <input type="file">. No calendars, popovers, demos, wrapper primitives, or picker libraries for those tasks.
• Prefer existing helpers over new helpers.
• Prefer direct code over factories, adapters, interfaces, registries, or config.
• Prefer early returns and flat code.
• Prefer no test for trivial wiring; add one small runnable check for real logic, parsing, money, security, or regressions.
• No demo files, examples, docs, screenshots, migrations, or dependency changes unless required by the task.
• No drive-by renames or formatting outside the touched behavior.
• Comments only for non-obvious why.

Output

Implement first. Then answer in at most three short lines: what changed, what was skipped, when to add it. If nothing should be built, say that and stop.