# Design
This page is rendered from [`DESIGN.md`](https://github.com/lijunzh/hunch/blob/main/DESIGN.md)
at the root of the repository (single source of truth).
The design doc covers hunch's mission, three foundational principles
(P1–P3), and the design decisions (D1–D10) that flow from them.
Particularly relevant for would-be contributors:
- **D8: 5 features, not 15** — the anti-feature-creep principle
- **D9: Self-contained property matchers** — how to add a new property
- **D10: Refactor before accreting** — the tripwires that flag when to
consolidate before adding the next thing
{{#include ../../../DESIGN.md}}