From 8833c282a3d4239975550b28d788d6c05f79615a Mon Sep 17 00:00:00 2001 From: Matt Bruce Date: Tue, 10 Feb 2026 15:35:37 -0600 Subject: [PATCH] docs: clarify reader doc placement --- Agents.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Agents.md b/Agents.md index 11ed457..20f5ab1 100644 --- a/Agents.md +++ b/Agents.md @@ -40,6 +40,16 @@ When using AI to add or change docs in this repo: 4. Update the index when adding new markdown files. 5. Verify formatting (bullets, code blocks, and links) before commit. +## When A New Chat Starts +If you had to restart a chat and re-explain the goal, add a short reminder so the assistant places content in the reader-facing docs instead of workflow files. + +### What To Say (Plain English) +- "Treat this repo like a book for developers. Put reader-facing guidance in docs/ai, not in Agents.md." +- "If placement is unclear, ask where the content should live before editing." + +### Example Request +"Read Agents.md and PRD.md first. Propose a plan. Then add chat mode guidance to docs/ai/usage-tokens.md (reader-facing) with hard examples. Do not add reader content to Agents.md." + ## Commit And Push After Repo Updates If you update any file in this repo, commit and push right away so other developers do not lose their local changes. If you are unsure, ask and confirm before pushing.