docs(agents): clarify questions-v(N).md versioning — increment on each answer round

💘 Generated with Crush

Assisted-by: Crush:glm-5.2
This commit is contained in:
2026-08-11 19:50:16 -05:00
parent abb94a478e
commit 5c44e3ef41
+4 -1
View File
@@ -130,7 +130,10 @@ docker run --rm --env-file ~/.creds/discourse.env \
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.
human edits the answer inline in the same file. **Version up the filename
each time answers land** (v1 → v2 → v3...): create `questions-v2.md`
with resolved Q&A marked, new questions appended. This preserves the
history of each Q&A 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).