From 29f33c4b0351bc2e23ab265d70b8616f4a66203c Mon Sep 17 00:00:00 2001 From: reachableceo Date: Mon, 10 Aug 2026 16:03:57 -0500 Subject: [PATCH] =?UTF-8?q?fix(policy):=20ban=20harness=20question=20tools?= =?UTF-8?q?=20=E2=80=94=20questions-v(N).md=20only?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Harness "ask user"/question tools (structured prompts, modal forms) are not portable across harnesses, don't version history, and bypass the git-tracked record. Make the existing questions-v(N).md rule explicit and non-negotiable in both BASELINE-PROMPT.md §10 and AGENTS.md. 💘 Generated with Crush Assisted-by: Crush:glm-5.2 --- AGENTS.md | 6 ++++++ BASELINE-PROMPT.md | 10 +++++++++- 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 33cdfb2..4c1df27 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -123,6 +123,12 @@ docker run --rm --env-file ~/.creds/discourse.env \ ## Questions +- **NEVER use a harness "question"/"ask user" tool** (structured prompts, + modal forms, tabbed questions). Banned across every project, every + harness. Not portable, not version-controlled, bypasses the git record. + Non-negotiable. (See `BASELINE-PROMPT.md` §10.) +- **All questions go in the git-tracked `questions-v(N).md` file.** The + human edits the answer inline in the same file; version up per round. - Capture questions for the human in a git-tracked `questions-v(N).md` file. - The human reviews and edits it inline. Version up when a round of answers lands. - Questions, answers, and the reasoning behind decisions are often more important than the code. Synthesize resolved Q&A into Discourse (decisions) and Redmine (work items). diff --git a/BASELINE-PROMPT.md b/BASELINE-PROMPT.md index 4bacc24..a15aff9 100644 --- a/BASELINE-PROMPT.md +++ b/BASELINE-PROMPT.md @@ -97,7 +97,15 @@ do not require per-change Redmine approval. ## 10. Questions file — `questions-v(N).md` -- Capture questions in a git-tracked, versioned file: `questions-v1.md`, `questions-v2.md`, … +- **NEVER use a harness "question"/"ask user" tool** (structured prompts, + modal forms, tabbed questions, etc.). Ever. They are banned across every + project. They are not portable across harnesses, they don't version + history, and they bypass the git-tracked record. This is non-negotiable. +- **All questions go in the git-tracked `questions-v(N).md` file.** Write + the question; the human edits the answer inline in the same file. This + preserves history, works under every harness, and keeps reasoning next + to the answer. Version up (`questions-v2.md`, …) when a round lands. +- Capture questions in a versioned file: `questions-v1.md`, `questions-v2.md`, … - The human reviews and edits it inline. Version it when a round of answers goes in. - Synthesize resolved Q&A into Discourse (decisions/rationale) and Redmine (work items).