Skip to content

Commit 73fe349

Browse files
committed
Update AGENTS.md to version 0.27
1 parent 459647c commit 73fe349

1 file changed

Lines changed: 12 additions & 15 deletions

File tree

AGENTS.md

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
11
# AGENTS.md
22

3-
Version: 0.26 (2026-02-10)
3+
Version: 0.27 (2026-03-17)
44

5-
Start: say hi + 1 motivating line.
65
Work style: Be radically precise. No fluff. Pure information only (drop grammar; min tokens).
76

87
## Agent Protocol
9-
- Contact: Robin Ebers (@robinebers, rob@robinebers.com).
108
- “Make a note” => edit AGENTS.md (Ignore `CLAUDE.md`, symlink for AGENTS.md).
9+
- "Remember" (or similar) -> edit AGENTS.md under "User Notes"
1110
- Editor: `cursor <path>`.
1211
- New deps: quick health check (recent releases/commits, adoption).
1312
- When asked to update the `AGENTS.md` to the latest version:
@@ -19,18 +18,16 @@ Work style: Be radically precise. No fluff. Pure information only (drop grammar;
1918
- Use `mv` / `cp` to move and copy files.
2019
- Bugs: add regression test when it fits.
2120
- Keep files <~400 LOC; split/refactor as needed.
22-
- Simplicity first: handle only important cases; no enterprise over-engineering.
21+
- Simplicity first: handle only important cases; no enterprise over-engineering/fallbacks.
2322
- New functionality: small OR absolutely necessary.
2423
- NEVER delete files, folders or other data unless explicilty approved or part of a plan.
25-
- Before writing code, stricly follow the blow research rules
26-
- Always start with "Executive Summary" and summarize the plan for a non-technical reader in a few short bullets (what will change, behavior outcomes, intent, etc), avoiding jargon and implementation details. After that, show the full technical plan with details needed to implement.
24+
- Before writing code, stricly follow the below research rules
2725

2826
## Research
29-
- Always create a spec in-memory (no files), even if minimal
30-
- Prefer skills if available over research
31-
- Prefer researched knowledge over existing knowledge when skills are unavailable
27+
- Prefer skills if available over research.
28+
- Prefer researched knowledge over existing knowledge when skills are unavailable.
3229
- Research: Exa to websearch early, and Ref to seek specific documention or web fetch.
33-
- Best results: Quote exact errors; prefer 2025-2026 sources.
30+
- Best results: Quote exact errors; prefer 2025-2026+ sources.
3431

3532
## Git
3633
- Always use `gh` to communicate with GitHub.
@@ -45,17 +42,16 @@ Work style: Be radically precise. No fluff. Pure information only (drop grammar;
4542
- Avoid manual `git stash`; if Git auto-stashes during pull/rebase, that’s fine (hint, not hard guardrail).
4643
- If user types a command (“pull and push”), that’s consent for that command.
4744
- Big review: `git --no-pager diff --color=never`.
48-
- Before creating a PR, run `bun run test:coverage`; coverage minimums must pass.
4945

5046
## Error Handling
5147
- Expected issues: explicit result types (not throw/try/catch).
5248
- Exception: external systems (git, gh) → try/catch ok.
5349
- Exception: React Query mutations → throw ok.
54-
- Unexpected issues: fail loud (throw/console.error + toast.error); NEVER add fallbacks.
50+
- Unexpected issues: fail LOUD (throw/console.error + toast.error); NEVER add fallbacks.
5551

5652
## Backwards Compat
57-
- Local/uncommitted: none needed; rewrite as if fresh.
58-
- In main: probably needed, ask user.
53+
- Always minimum only, you typically overthink this. Keep things simple.
54+
- When in doubt, ask the user before you overengineer solutions.
5955

6056
## Critical Thinking
6157
- Fix root cause (not band-aid).
@@ -86,6 +82,7 @@ Work style: Be radically precise. No fluff. Pure information only (drop grammar;
8682
## Useful Tidbits
8783
- When using Vercel AI Gateway, use a single API key across the project, not individual providers.
8884
- When using Convex, run `bunx convex dev --once` to verify, not `bunx convex codegen`.
85+
- When tasked to use the computer, prefer simple screenshot/mouse pointer events over accessibility.
8986

9087
## Before Creating Pull Request
9188
- Before creating a PR or pushing to main, ensure that `README.md` is updated with what plugins are supported.
@@ -97,4 +94,4 @@ Work style: Be radically precise. No fluff. Pure information only (drop grammar;
9794
Use below list to store and recall user notes when asked to do so.
9895

9996
- Tauri IPC: JS must use camelCase (`{ batchId, pluginIds }`), Tauri auto-converts to Rust's snake_case. Never send snake_case from JS—params silently won't match.
100-
- tauri-action `latest.json`: Parallel matrix builds are safe—action fetches existing `latest.json`, merges platform entries, re-uploads. No `max-parallel: 1` needed.
97+
- tauri-action `latest.json`: Parallel matrix builds are safe—action fetches existing `latest.json`, merges platform entries, re-uploads. No `max-parallel: 1` needed.

0 commit comments

Comments
 (0)