# Agent Instructions
Read [`CONTRIBUTING.md`](CONTRIBUTING.md) first — it maps the repository, the `tmp/` rule, the gates, and the deliberate waivers.
The house rules are codified in [`dkorolev/principles`](https://github.com/dkorolev/principles) and apply here in full: [`ENG-PRINCIPLES.md`](https://github.com/dkorolev/principles/blob/main/ENG-PRINCIPLES.md) governs engineering doctrine (typing, CLI ergonomics, testing, error handling, git, config, publishing), and [`WEB-UI-PRINCIPLES.md`](https://github.com/dkorolev/principles/blob/main/WEB-UI-PRINCIPLES.md) governs the session browser. The rare, deliberate waivers are listed at the end of `CONTRIBUTING.md` — everything else is binding.