# Agent instructions **Start:** read this file, then use the skills in this repo's `.agents/skills/` by name. Repo specifics follow the house rules. ## House rules These rules are identical in every edbfi rewrite app. ### Working principles Ambitious ideas, simple systems, software that feels obvious. - **The smallest design that makes correct behaviour unsurprising.** Find the real constraint first, then fight for the simplest design that meets it. Don't keep complexity because it's already there, and don't add machinery because it looks architecturally impressive. Simplifying code outside the task is a note or a proposal, not a drive-by edit. - **Measure twice, cut once; YAGNI.** Think a change through before writing it, then build what the approved spec and the task need now, nothing for a future that may not come. Fight scope creep both ways: no extras, and no silently dropped requirements; scope changes go through the spec. Honour the owner's intent in the smallest form that is still realistic, not a stub. - **Defaults, not dogma.** The owner can override anything in this file. For agents, the explicit rules below (Always / Ask first / Never, Code structure, the cleanup procedures) hold; everything else is a good default for navigating and changing the codebase, and these principles guide the judgement calls. Precedence: the owner's explicit instruction, then `.agents/rules/*.md`, then this file, then the skills' defaults. The orchestrator approves ground-floor specs and task lists (Gates) but can't set a rule aside. When the owner overrides a rule, the PR body says which. ### Stack and tools **Follow this repo's tech stack** (README, `package.json`) and run every JavaScript tool through Bun with `--bun`: bun/bunx instead of npm/npx/node, installers included. The skills' examples use other stacks and package managers; treat them as illustrations, never as instructions. | Skill examples say | Do this | |---|---| | `npm install`, `npm ci` | `bun install`; frozen: `bun ci` or `bun install --frozen-lockfile` | | `npm install ` | `bun add ` (`bun add -d ` for dev) | | `npm run