From 0a9849de52425ada808004ece37fbe8bcf8fa3e7 Mon Sep 17 00:00:00 2001 From: ReachableCEO Date: Wed, 17 Sep 2025 09:58:14 -0500 Subject: [PATCH] docs: add strict chat output policy (five-line max, no diffs) to AGENTS.md and SeedPrompt.md; log in devlog --- AGENTS.md | 7 +++++++ SeedPrompt.md | 7 +++++++ docs/devlog/DEVLOG_LLM.md | 7 +++++++ 3 files changed, 21 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 8df8678..6c3cb5c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -46,3 +46,10 @@ Scope: Applies to the entire repository unless overridden by a deeper AGENTS.md. - Incremental artifacts: start a new `NN-.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. + +## Chat Output Policy +- Default message: `Updated . Read/edit and let me know.` +- Keep chat to five lines or fewer. +- Do not paste diffs or file contents in chat; write to files instead. +- Aggregate multiple updates in a short bulleted list of filepaths. +- Push detailed reasoning/status to `docs/devlog/` and reference it when needed. diff --git a/SeedPrompt.md b/SeedPrompt.md index 1f788e6..2f75298 100644 --- a/SeedPrompt.md +++ b/SeedPrompt.md @@ -68,3 +68,10 @@ Commit/push everything in the repo now before we get started on the project. - 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. + +### Chat Output Policy + +- Default chat line: `Updated . Read/edit and let me know.` +- Limit chat to five lines or fewer; avoid explanations in chat. +- Never paste diffs or large content in chat; commit to files and reference paths. +- Log detail in `docs/devlog/` and keep the chat terminal clean. diff --git a/docs/devlog/DEVLOG_LLM.md b/docs/devlog/DEVLOG_LLM.md index 2e4e415..3a4cfa8 100644 --- a/docs/devlog/DEVLOG_LLM.md +++ b/docs/devlog/DEVLOG_LLM.md @@ -46,3 +46,10 @@ This log is concise and structured for quick machine parsing and summarization. - Removed old `devlog/` files - next: - Continue detailed logging here; keep chat terse + +## 2025-09-17T15:10Z +- context: Strict chat output policy adopted +- actions: + - Added Chat Output Policy to AGENTS.md and SeedPrompt.md (five-line max; default message format; no diffs in chat) +- next: + - Use filesystem-first workflow; keep chat to update notices