Core engineering beliefs¶
The constitution remains the authority for product principles. These beliefs guide implementation within those principles.
- Repository evidence is discoverable. Keep decisions beside code and link them from an index.
- Small entry points preserve attention. Keep rules brief and load task-specific detail through links.
- Contracts stabilize change. Use typed boundaries, published schemas, and focused regression tests.
- Failures improve the environment. Turn repeated mistakes into a useful check or clearer documentation.
- Verification follows risk. Exercise the changed behavior and shared contracts it can affect.
- Existing code is evidence, not automatic precedent. Preserve useful patterns and record known exceptions.
- Humans set intent. Agents complete authorized work and surface decisions that require human judgment.
Keep new rules here only when they express a durable tradeoff. Put commands in contributing and known gaps in technical debt.