7814
Ta
tiny-c-agent / files
tiny-c-agent / AGENTS.md
1.9 KB
1# Project file for agents 2 3## tiny-c-agent (`tiny` for short) 4 5A fast, minimal and config first agent for your terminal. 6 7## References 8 9- `../mini-coder` - A very similar implementation in typescript. An example do not blindly copy. 10 11## Some guardrails 12 13- **Write original code.** Other coding agents are behavioral references only. 14- **No loop limits.** No max turns, tool calls, token budgets, or agent-imposed 15 timeouts. The user's ability to interrupt is the limit. 16- **Config-first.** Every user-facing behavior that can vary comes from config 17 with a sane default. 18- **Minimal context.** The model sees the configured system prompt plus 19 explicitly opted-in resource files — never reminders, hidden blocks, or 20 harness meta-text. 21- **The agent never imports the TUI.** Headless and TUI are two projections of 22 the same agent events; the TUI owns no agent or provider semantics. 23- **Respect linux/unix coventions**. Both for storing configs and state, as well as making sure the head 24 less mode is scriptable. 25 26## Invariants 27 28- Sessions are append-only JSONL, one message per line, fsynced on 29 write. Never rewrite or delete committed lines. A persistence failure stops 30 the turn. 31- The loop has no compaction, no retries, and no meta-messages between steps. 32 Provider errors surface as-is, never masked or summarized. 33- Three LLM tools, matching mini-coder: `read`, `edit`, and `bash`. 34- Interruption: ESC politely pauses at the next step boundary; Ctrl+C cancels the 35 turn (abort the request, kill the tool's process group, persist the aborted 36 message); Ctrl+C (or CTRL+D) exits on an empty draft. Completed side effects are never 37 undone. 38- Diagnostics are local only. No telemetry, no hidden stalls. 39 40## Working agreement 41 42- Trace the real data flow before designing; apply guards at the narrowest 43 boundary. 44- Keep the diff small. Do not opportunistically refactor or harden adjacent code. 45- Do not add tests unless explicitly asked; verify manually.