xonecas.io
64875
Mc

mini-coder / commit 3beb946

chore: AGENTS.md changes

xonecas2026-04-18 3beb9462f5956580f920c46ade2727ad9d08f827 parent 7beda02

1 file changed

AGENTS.md+3−19
@@ -7,17 +7,10 @@
77
88 ## Session bootstrap
99
10-- Read `spec.md`, then `TODO.md`, then inspect `git status --short` / `git diff`.
11-- Treat `TODO.md` as the current verified work queue. For spec-alignment work, confirm the mismatch in code before editing.
10+- Check `PROGRESS.md` to check if there are any ongoing tasks.
1211 - For audits, treat open `TODO.md` items as already-known issues and focus findings on new gaps unless the user asks to re-check known debt.
1312 - Keep `TODO.md` minimal and current; remove completed items instead of accumulating history.
1413
15-## Planning and design mode
16-
17-- In planning, debugging, and research sessions, optimize for the correct design first. Do not let patch size, dirty-tree caution, or implementation anxiety distort the recommendation.
18-- Minimal diffs are a delivery concern, not a design goal. If the current architecture is wrong, say so plainly and propose the proper refactor.
19-- When implementation starts, prefer the correct refactor over a band-aid. Use tactical workarounds only when the user explicitly asks for them or hard constraints make the proper fix impractical.
20-
2114 ## Code map
2215
2316 - `src/index.ts` — startup, providers, settings, AGENTS.md/skills/plugins loading, theme assembly, shared app state.
@@ -40,7 +33,7 @@
4033 - All exports need JSDoc; interface fields get single-line JSDoc. See `session.ts` for the pattern.
4134 - Dependency references:
4235 - pi-ai: `~/src/pi-mono/packages/ai/` (`src/types.ts`, `src/stream.ts`, `src/utils/oauth/`, `src/providers/faux.ts`)
43- - cel-tui: `~/src/cel-tui/` (`~/src/cel-tui/spec.md`, `examples/chat.ts`, `packages/components/src/markdown.ts`)
36+ - cel-tui: `~/src/cel-tui/` (`~/src/cel-tui/spec.md`, `examples/chat.ts`)
4437
4538 ## Release process
4639
@@ -82,6 +75,7 @@
8275
8376 - No inline `import` calls, duplicated helpers, dead code, or speculative abstractions.
8477 - Performance matters. Prefer fast paths.
78+- Don't over-optimize, let the problems reveal themselves first.
8579 - Study dependency examples, types, and tsconfig before integrating them. Match their patterns instead of fighting them.
8680 - Use dependency-defined types, not weaker substitutes. Do not hide type/config mismatches with casts or ignores.
8781 - For UI work, verify both light/dark terminal legibility and let the layout engine size things.
@@ -103,13 +97,3 @@
10397 - Stay within the agreed TODO scope. Do not pull in adjacent items without discussion.
10498 - Don't write tests that call real git commands.
10599 - Don't add brittle tests that pin incidental wording, formatting, colors, layout, or other implementation-shaped output unless that exact output is the actual contract.
106-
107-## Testing strategy
108-
109-- Test boundaries, not dependencies. Use real Bun/git/sqlite/pi-ai faux behavior. No mocks or stubs.
110-- `tools.ts`: edit exact-match/create/path/newline preservation; shell exit/abort/truncation/cwd; readImage mime/errors/path handling.
111-- `session.ts`: CRUD, turn numbering, undo/fork, truncation, prompt history, cumulative stats.
112-- `prompt.ts` / `skills.ts`: prompt assembly order, AGENTS.md ordering/scan-root behavior, skill discovery/catalog, conditional `readImage` omission.
113-- `agent.ts`: faux-provider end-to-end loop tests for tool execution, ordering, interrupts, and errors.
114-- UI tests live in `src/ui*.test.ts` plus focused `src/ui/*.ts` module tests; TUI rendering/input changes still need manual terminal validation.
115-- `input.ts` and `theme.ts`: command/skill/image priority, theme completeness, merge semantics.