You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AGENTS.md
+12-15Lines changed: 12 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,12 @@
1
1
# AGENTS.md
2
2
3
-
Version: 0.26 (2026-02-10)
3
+
Version: 0.27 (2026-03-17)
4
4
5
-
Start: say hi + 1 motivating line.
6
5
Work style: Be radically precise. No fluff. Pure information only (drop grammar; min tokens).
7
6
8
7
## Agent Protocol
9
-
- Contact: Robin Ebers (@robinebers, rob@robinebers.com).
10
8
- “Make a note” => edit AGENTS.md (Ignore `CLAUDE.md`, symlink for AGENTS.md).
9
+
- "Remember" (or similar) -> edit AGENTS.md under "User Notes"
11
10
- Editor: `cursor <path>`.
12
11
- New deps: quick health check (recent releases/commits, adoption).
13
12
- 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;
19
18
- Use `mv` / `cp` to move and copy files.
20
19
- Bugs: add regression test when it fits.
21
20
- 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.
23
22
- New functionality: small OR absolutely necessary.
24
23
- 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
27
25
28
26
## 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.
32
29
- 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.
34
31
35
32
## Git
36
33
- Always use `gh` to communicate with GitHub.
@@ -45,17 +42,16 @@ Work style: Be radically precise. No fluff. Pure information only (drop grammar;
45
42
- Avoid manual `git stash`; if Git auto-stashes during pull/rebase, that’s fine (hint, not hard guardrail).
46
43
- If user types a command (“pull and push”), that’s consent for that command.
47
44
- Big review: `git --no-pager diff --color=never`.
48
-
- Before creating a PR, run `bun run test:coverage`; coverage minimums must pass.
49
45
50
46
## Error Handling
51
47
- Expected issues: explicit result types (not throw/try/catch).
52
48
- Exception: external systems (git, gh) → try/catch ok.
-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.
59
55
60
56
## Critical Thinking
61
57
- Fix root cause (not band-aid).
@@ -86,6 +82,7 @@ Work style: Be radically precise. No fluff. Pure information only (drop grammar;
86
82
## Useful Tidbits
87
83
- When using Vercel AI Gateway, use a single API key across the project, not individual providers.
88
84
- 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.
89
86
90
87
## Before Creating Pull Request
91
88
- 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;
97
94
Use below list to store and recall user notes when asked to do so.
98
95
99
96
- 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