daniel/reasampler
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(phase-q): settle Q-10 (audit-report home) and Q-11 (pitch-remediation depth)

Browse Source
This commit is contained in:
Daniel Harvey
2026-07-27 14:36:57 -04:00
parent bbfb033819
commit 25c77a5de3
3 changed files with 62 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CONTEXT.md
+13 -5
View File
@@ -3280,11 +3280,19 @@ Q-W1..Q-W6 points (e.g. an algorithm rewrite that changes a module's shape, or a
that changes a payload). Those reshapes are folded in before Q-W1 begins. Q-W0 is thus both the entry
point and a scoping input to the rest of the phase.
**Report home (fork — Daniel's call):** whether the findings report lives as a committed doc under
`docs/product/` (e.g. `code-quality-audit.md`, alongside the SOLID/naming audit that already lives in
`docs/product/code-organization.md`) or as a tracked issue list is Daniel's call — see the fork note
in `docs/product/code-organization.md` §2c. The recommendation is a committed doc: it sits beside the
existing audit, travels with the tree, and each finding's disposition is reviewable in one place.
**Report home (Q-10 — SETTLED, Daniel 2026-07-27): a committed doc.** The findings report lives as a
committed doc under `docs/product/` — `code-quality-audit.md`, alongside the SOLID/naming audit that
already lives in `docs/product/code-organization.md`. It sits beside the existing audit, travels with
the tree, and each finding's disposition is reviewable in one place. A tracked issue list was set
aside — the audit is a one-shot pre-reorg sweep, not an ongoing backlog. The Q-W0 "Triage + report"
step writes this file. See `docs/product/code-organization.md` §2c.3.
**Pitch-remediation depth (Q-11 — SETTLED, Daniel 2026-07-27): defer to findings.** How deep the OLA
pitch-preserve remediation goes is decided by what Q-W0 finds, not pre-committed. Default is
**document-and-defer**; only if the audit surfaces artifacts that matter is a **bounded fix** (tune
window/overlap/edge handling) weighed **before** a **technique replacement** (phase-vocoder / WSOLA).
A technique replacement reshapes `pitch_shift`, would spill a downstream Q-wave point, and is
therefore **a Daniel decision at triage time, not an automatic Q-W0 action**. See §2c.4.
## The quality bar — Vital (read from its actual `src/` tree)