samwise-x/elon-flow
A first-principles engineering operating system for deciding what should exist, proving what is true, building the minimum correct implementation, and improving the mechanism that produces the work.
Use when domain vocabulary, module shape, interface design, seam placement, ownership, or testability materially affects an engineering decision.
Use when validated work repeats, the same correction recurs, coordination cost dominates, or a manual process is ready to become deterministic and cheaper to execute.
Use when software is broken, failing, regressed, flaky, or unexpectedly slow and the task requires a reproducible root-cause diagnosis before fixing it.
Use when the user explicitly asks for Elon-Flow, first-principles engineering, or wants a nontrivial engineering problem routed through the Elon-Flow operating doctrine.
Use when an engineering question can be answered by observation, measurement, a prototype, a benchmark, a comparison, or direct verification of the real artifact.
Use when an engineering goal, requirement, inherited assumption, cost structure, dependency, or governing constraint must be challenged before implementation.
Use when required behavior is sufficiently known and the task is to implement the smallest correct change without speculative abstraction or dependency growth.