From 11a611e07211854876d30721c269e0f87e594afa Mon Sep 17 00:00:00 2001 From: ReachableCEO Date: Wed, 17 Sep 2025 11:29:53 -0500 Subject: [PATCH] governance: make quiet/no-streaming mandatory (no toggle) across system prompts and templates; log in DevLog --- docs/devlog/DEVLOG_LLM.md | 7 +++++++ meta/AGENTS.seed.llm.md | 3 ++- meta/AGENTS.seed.md | 3 ++- prompts/global/system.llm.md | 1 + prompts/global/system.md | 1 + templates/project/_shared/AGENTS.md | 3 ++- 6 files changed, 15 insertions(+), 3 deletions(-) diff --git a/docs/devlog/DEVLOG_LLM.md b/docs/devlog/DEVLOG_LLM.md index 4c8b170..75c00ee 100644 --- a/docs/devlog/DEVLOG_LLM.md +++ b/docs/devlog/DEVLOG_LLM.md @@ -238,3 +238,10 @@ This log is concise and structured for quick machine parsing and summarization. - Added audit advisory to flag usage of `cat`/`sed -n` in scripts - next: - Avoid printing file contents via shell; log details to DevLog when needed + +## 2025-09-17T17:40Z +- context: Quiet is now mandatory (no toggle) +- actions: + - Updated system prompts and AGENTS templates to state quiet is required +- next: + - Continue with quiet operations and filesystem-first logging diff --git a/meta/AGENTS.seed.llm.md b/meta/AGENTS.seed.llm.md index 773a8b6..5e4b5bb 100644 --- a/meta/AGENTS.seed.llm.md +++ b/meta/AGENTS.seed.llm.md @@ -4,7 +4,8 @@ - Gates: human `.md` must include exact phrases — Questions: "Approved for Proposal"; Proposal: "Approved for Plan"; Plan: "Approved to Implement". - Read `.llm.md` only; write both `.md` and `.llm.md` siblings for collab artifacts. - Chat ≤5 lines; default “Updated …”; no diffs; announce only collab file changes; log details in `docs/devlog/`. - - Quiet shell: avoid `cat`/`sed` outputs; use silent checks; log details to DevLog files. +- Quiet shell: avoid `cat`/`sed` outputs; use silent checks; log details to DevLog files. + - Quiet is mandatory (no toggle) for this tool. - Keep changes minimal and focused; adopt TDD (tests first); require unit/integration tests for all features; consistent style. - Git: Conventional Commits; branch `main`; optional tags `YYYY-MM-DD-HHMM`. - Tools: file-first; use `rg`; read ≤250 lines; respect sandbox/approvals; preface grouped commands. diff --git a/meta/AGENTS.seed.md b/meta/AGENTS.seed.md index 28f4918..1dd413b 100644 --- a/meta/AGENTS.seed.md +++ b/meta/AGENTS.seed.md @@ -38,7 +38,8 @@ Note: This is a template copied into generated projects. Customize as needed for - Default message: `Updated . Read/edit and let me know.` - Keep chat ≤5 lines; no diffs or large pastes. - Only announce changes to collaboration files in `collab/`; log details in DevLog. - - Quiet shell: avoid streaming file contents/diffs; prefer silent checks and log details to DevLog. +- Quiet shell: avoid streaming file contents/diffs; prefer silent checks and log details to DevLog. + - Quiet is mandatory (no toggle) for this tool’s workflows. ## Tooling and Safety - Use filesystem-first workflow; prefer `rg` for search; read files in ≤250-line chunks. diff --git a/prompts/global/system.llm.md b/prompts/global/system.llm.md index cba45e3..d719aeb 100644 --- a/prompts/global/system.llm.md +++ b/prompts/global/system.llm.md @@ -52,3 +52,4 @@ -- Quiet Shell/No Streaming -- - Never stream file contents/diffs in chat. Avoid `cat`/`sed` outputs. - Use silent checks (exit codes, `grep -q`); log details in DevLog files. + - Quiet is mandatory (no toggle); default to minimal, non-chat output. diff --git a/prompts/global/system.md b/prompts/global/system.md index 5355ecb..bf878ff 100644 --- a/prompts/global/system.md +++ b/prompts/global/system.md @@ -35,6 +35,7 @@ You are a coding agent running in the Codex CLI (terminal-based). Be precise, sa - Do not stream file contents or diffs into chat. Avoid `cat`/`sed` output in chat. - Prefer silent checks (e.g., `grep -q`, exit codes) and write details to DevLog files if needed. - If content must be inspected, avoid printing it to chat; summarize findings in DevLog and reference the file. + - Quiet is mandatory (no toggle). Tools and scripts should default to minimal, non-chat output. ## Dev Logs and Docs - Maintain `docs/devlog/DEVLOG_LLM.md` and `docs/devlog/DEVLOG_HUMAN.md`. Add an entry for each meaningful change. diff --git a/templates/project/_shared/AGENTS.md b/templates/project/_shared/AGENTS.md index 661666b..e277e5e 100644 --- a/templates/project/_shared/AGENTS.md +++ b/templates/project/_shared/AGENTS.md @@ -19,7 +19,8 @@ This file is copied by scaffolding into new projects. Edit to suit the project w ## Chat Output Policy - Default: `Updated . Read/edit and let me know.` - Keep chat ≤5 lines; no diffs; announce only collab file changes; log details in DevLog. - - Quiet shell: avoid printing file contents/diffs; prefer silent checks and DevLog summaries. +- Quiet shell: avoid printing file contents/diffs; prefer silent checks and DevLog summaries. + - Quiet is mandatory (no toggle) in this workflow. ## Coding, Tests, and Git - Minimal, focused changes; adopt TDD (write tests first) and require unit/integration tests for all features; consistent style.