Skip to content

Find code by asking what it does. A CLI for coding agents that uses Jev to discover relevant files and source context.

AGENTS.md: spend margin on simplicity

David Zhang17b0620942ec
diff --git a/.agents/skills/audit-agents/assets/example-agents.md b/.agents/skills/audit-agents/assets/example-agents.md
index 6c911e1..f82bbe2 100644
--- a/.agents/skills/audit-agents/assets/example-agents.md
+++ b/.agents/skills/audit-agents/assets/example-agents.md
@@ -53,7 +53,9 @@ Before proposing or changing one of these rules, invoke <skill: the project's ow
Use what the repo already chose before writing your own. Find the existing owner of a concept before creating another.
-Prefer one general rule to a special case, and a simple structure to an abstraction nobody needs yet. When something replaces an old mechanism, delete the old one. When a change exposes a duplicate or a stale owner, invoke <skill: refactor-clean>.
+Prefer one general rule to a special case, and a simple structure to an abstraction nobody needs yet.
+
+Spend margin on simplicity. When something has room to spare against its budget (frame time, startup, memory, bandwidth), use that room to keep the design simple. Don't add machinery to make a thing faster than it needs to be, and take such machinery out when the margin shows it wasn't needed. When something replaces an old mechanism, delete the old one. When a change exposes a duplicate or a stale owner, invoke <skill: refactor-clean>.
## Parallel work stays cheap
diff --git a/AGENTS.md b/AGENTS.md
index 5948ac5..b81e5f6 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -56,7 +56,9 @@ A published claim is a measured one. A baseline is never rerun to improve a comp
Use what the repo already chose before writing your own. Find the existing owner of a concept before creating another.
-Prefer one general rule to a special case, and a simple structure to an abstraction nobody needs yet. When something replaces an old mechanism, delete the old one. When a change exposes a duplicate or a stale owner, invoke [`refactor-clean`](.agents/skills/refactor-clean/SKILL.md).
+Prefer one general rule to a special case, and a simple structure to an abstraction nobody needs yet.
+
+Spend margin on simplicity. When something has room to spare against its budget (response time, startup, memory, bandwidth), use that room to keep the design simple. Don't add machinery to make a thing faster than it needs to be, and take such machinery out when the margin shows it wasn't needed. When something replaces an old mechanism, delete the old one. When a change exposes a duplicate or a stale owner, invoke [`refactor-clean`](.agents/skills/refactor-clean/SKILL.md).
## Parallel work stays cheap