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).