simplify
Installation
SKILL.md
Simplify
Produce the smallest clear implementation that fully satisfies the required behavior. Minimize concepts and moving parts, not line count.
Cadence
- During construction, apply the priorities locally while discovering behavior. Allow clearly temporary instrumentation or scaffolding when it accelerates learning.
- At convergence, once a logical behavior slice passes, simplify that slice, remove superseded attempts, and rerun focused validation.
- Before handoff or merge, compare the full branch with its merge base and reconcile code, tests, comments, documentation, configuration, and relevant history.
Workflow
- Identify the required behavior, invariants, constraints, and non-goals.
- Inspect the relevant diff and separate it into logical concepts. For a final branch audit, compare the full branch with its merge base and check history for superseded attempts when relevant.
- Inspect the existing owners, sources of truth, common path, and decision points before adding anything.
- Choose the design with the fewest necessary concepts and the least work at runtime.
- When changes are requested, implement directly and reuse existing mechanisms where they fit.
- Validate behavior with checks proportional to the risk.
- Review the final code, tests, names, comments, documentation, configuration, and relevant history for anything that no longer earns its complexity.