docs: add token/context hygiene rules to AGENTS.md and SeedPrompt addendum

This commit is contained in:
2025-09-17 09:55:13 -05:00
parent f91f3814e8
commit ac36dd8654
2 changed files with 15 additions and 0 deletions

View File

@@ -38,3 +38,11 @@ Scope: Applies to the entire repository unless overridden by a deeper AGENTS.md.
- Ask clarifying questions in `collab/<...>-questions.md`.
- Propose in `collab/<...>-proposal.md`, plan in `collab/<...>-plan.md`, then implement.
- Respect repository structure and this AGENTS.md across all changes.
## Token/Context Hygiene
- Chat minimalism: keep messages short; prefer pointers to files over inline dumps.
- Use `.llm.md` files for concise, machine-friendly summaries; avoid duplicating full human docs.
- No large pastes in chat: never paste large code or markdown; write to files and reference paths/sections.
- Incremental artifacts: start a new `NN-<subject>.md` per round to avoid long single files.
- Status style: one-line updates before tool calls; rely on devlog for detail.
- Avoid re-reading large files in chat; reference exact file paths and sections instead.

View File

@@ -61,3 +61,10 @@ Commit/push everything in the repo now before we get started on the project.
- Use multiple files per round rather than growing a single document.
- Naming: `collab/<type>/NN-<subject>.md` (human) and `collab/<type>/NN-<subject>.llm.md` (LLM-optimized).
- Start a new `NN` for each major round; keep subject consistent across types.
### Token Discipline
- Keep chat output extremely concise; use the filesystem for details.
- Summarize for the model in `.llm.md` companions; keep human-readable detail in the primary `.md`.
- Do not paste large content into chat; write to files and reference paths.
- Prefer starting new numbered files per round to keep each doc short.