diff --git a/AGENTS.md b/AGENTS.md index 54ae185..7d6cc5d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -102,7 +102,7 @@ traceable to an approved ticket. There is no "I thought it would help." 1. **Set up the environment:** `bash scripts/setup-hooks.sh` (installs git hooks — idempotent). 2. **Read this file** (`AGENTS.md`) — project policy and domain knowledge. -3. **Read [questions-v1.md](questions-v1.md)** — open questions awaiting human input. +3. **Read the latest questions file** (`questions-v*.md`) — open questions awaiting human input. The version number increments each round (v1, v2, v3...). 4. **Check for understanding — GATE.** In your own words, summarize ALL the rules back to the user before doing any work: Agent Authority (ticket-governed, propose-never-implement), Access-Channel SSH-only policy, Remote access @@ -164,10 +164,13 @@ for a full audit or `--fast` for pre-commit speed. Bypass with `--no-verify` **NEVER use a harness "question"/"ask user" tool** (structured prompts, modal forms, tabbed questions). Banned across every project, every harness. They are not portable, not version-controlled, and bypass the git record. -**All questions go in [questions-v1.md](questions-v1.md)** — write the -question; the human edits the answer inline in the same file. Version up -per round. Synthesize resolved Q&A into Discourse (decisions) and Redmine -(work items). See `BASELINE-PROMPT.md` §10. +**All questions go in the current `questions-v(N).md` file** — write the +question; the 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. Synthesize resolved Q&A into +Discourse (decisions) and Redmine (work items). See `BASELINE-PROMPT.md` +§10. ## Documentation policy (IMPORTANT)