docs(backlog): add BACKLOG + QA plan template

Synthesize the five 2026-06-13 design specs and session memory into a
single outstanding-work list. Header rules: resolved items move to
RETRO.md; every finished feature gets a live-QA plan before it counts as
resolved. Add docs/qa/TEMPLATE.md as the observable-evidence QA form.
This commit is contained in:
2026-06-14 14:51:22 +04:00
parent 02e963d6cc
commit b1c0f88dee
2 changed files with 222 additions and 0 deletions
+53
View File
@@ -0,0 +1,53 @@
# QA Plan: <feature> — <commits>
<!--
Copy this file to docs/qa/QA-<feature>.md and fill it in.
Generated by /qa-plan, or written by hand.
This plan is the artifact that authorizes the BACKLOG -> RETRO move.
-->
**Status:** DRAFT | RUNNING | PASSED | FAILED
**Run date / operator:**
**BACKLOG item:** <link/quote the §F entry this closes>
---
## Preconditions
- [ ] **server build/branch:** <jar/branch> — _rebuild only with the server stopped (lazy classloading breaks otherwise)_
- [ ] **llama-server + model:** <model id> — _note model-dependent behavior (strict templates, prompt-block emission)_
- [ ] **external deps:** <SearXNG / network / real router model / none>
- [ ] **config synced:** `~/.config/correx` matches `examples/*` + `docs/schemas/*`_stale copies cause silent bugs_
- [ ] **fixtures/seed:** <workspace, .correx/project.toml, prior session to resume, etc.>
## Acceptance gate (one sentence)
> The feature is correct **iff** <single observable outcome>.
## Checks
Every row must name a **recorded, observable signal** — an event in the log, a CLI/log
line, a TUI render, a file on disk, or the *absence* of an event. "It worked" is not
evidence.
| # | Action | Expected observable evidence | Result |
|---|--------|------------------------------|--------|
| 1 | | | |
| 2 | | | |
| 3 | | | |
Evidence sources: `correx events <id>` / `GET /sessions/{id}/events` (the log is the
truth), server logs (MDC sessionId), the TUI render, files under the workspace, and
`correx replay <id>` for determinism.
## Out of scope (explicitly NOT covered this pass)
-
## Disposition
- **PASS** → MOVE the BACKLOG entry into `RETRO.md` with this plan's run date + the
evidence cited above. Set Status: PASSED.
- **FAIL** → file each failure as a numbered finding back into `BACKLOG.md` (action +
exact repro + the signal that was wrong/missing), fix, then re-run only the failed
checks. Set Status: FAILED until green.