find-simplifications

Installation
SKILL.md

Finding simplifications

Find changes that remove maintained obligations: APIs, representations, lifecycle states, configuration paths, dependencies, tests, or documentation. It is guidance, not a checklist: prefer a few well-proven candidates over a count of deletions, and distinguish a survey from permission to implement its proposals.

Start with repo context

  • Read the root AGENTS.md — the pre-release stance when present, and conventions such as tests-are-not-golden-truth and Agent Notes-are-not-golden-truth doctrines — plus the repository's defensive-patterns and testing docs when they exist.
  • Skim the architecture doc before judging core code; simplifications that fight the service map or event taxonomy need extra evidence.
  • Use the Agent Note tree and its rules to understand intentional architecture; a recorded decision needs new evidence to overturn, not a "looks complex" flag. Start with high-signal implemented examples — capability seams, twin adapters, and persistence notes — when the tree has them.
  • Treat the repository's recorded adapter, persistence, and extension boundaries as intentional. Removing unused members within one can be valid when it preserves the recorded obligation; changing that obligation needs explicit scope and evidence.

What counts as a strong candidate

A strong simplification removes, folds, or demotes something real and has clear evidence that the current design costs more than it buys:

Installs
30
First Seen
Aug 19, 2026