Philosophy

4 principles that changed everything

1. Hooks for enforcement, CLAUDE.md for guidance

Hooks fire 100% of the time. Instructions are followed ~80%. If it MUST happen, make it a hook.

2. Agent-scoped knowledge, not global bloat

Security patterns live in the security-reviewer agent. Not in every session's context window.

3. Context is currency

Every token loaded into context is a token not available for your code. Keep it lean. Load on-demand.

4. Battle-tested over theoretical

Every rule exists because something went wrong without it. The WHY matters more than the WHAT.