From e1463d43001c97d341d34f0ff6587452e597702e Mon Sep 17 00:00:00 2001 From: Drew T <50529377+Druthulu@users.noreply.github.com> Date: Mon, 7 Sep 2026 18:12:31 -0600 Subject: [PATCH] =?UTF-8?q?docs(phase-33.5):=20S90=20checkpoint=20?= =?UTF-8?q?=E2=80=94=20decision-log=20entry=20'P33.5=20S90'=20(the=20re-ch?= =?UTF-8?q?arter,=20the=20three=20audits=20+=20the=20adversarial=20review,?= =?UTF-8?q?=20the=20six=20owner=20decisions,=20what=20tasks=200=E2=80=939?= =?UTF-8?q?=20measured,=20the=20hindsight=20path);=20CURRENT=5FPHASE=20che?= =?UTF-8?q?ckpoint=20refreshed=20for=20a=20fresh=20session=20(tasks=200?= =?UTF-8?q?=E2=80=939=20done,=20NEXT=20=3D=20task=2010=20at=20Max;=20the?= =?UTF-8?q?=20decision-log=20item=20of=20task=2014=20already=20banked)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/decision-log.md | 43 +++++++++++++++++++++++++++++++++++++ phase-ends/CURRENT_PHASE.md | 13 ++++++++--- 2 files changed, 53 insertions(+), 3 deletions(-) diff --git a/docs/decision-log.md b/docs/decision-log.md index ce214e159..efb46f3af 100644 --- a/docs/decision-log.md +++ b/docs/decision-log.md @@ -3504,3 +3504,46 @@ register lever (accelerators (16)), and treat "PROVED" as "proved against this l - **Hindsight path.** Ask before offering: "what does this maintainer's workflow need?" — an interactive tool's author does not want a mode for unattended search; a short issue describing the floor with the two numbers, in Drew's voice, asking whether a symbol rename would be the intended fix, would have got the same technical answer at a tenth of everyone's cost and no ill will. + +## P33.5 S90 (2026-09-07) — the docs sub-phase before the flip: the wiki becomes the source of truth, the tracked scratch is pruned, and the day-one kit is chartered as a Phase-0.5 overlay on ProjectArchitect 2.0 + +- **Context and belief.** Phase 33 closed at v1.32.0 with the flip gated on GitHub Support; the wiki (13 pages + 13 chapters) had + been written in P33 F3 as a summary layer OVER `docs/`, linking back into it. The belief at the P33 close was that the docs tree + was publishable as it stood. Drew's review of the folder on 2026-09-07 found otherwise: ~100 authored files from 33 phases — + a hindsight study written at 78% with a commission nobody had fulfilled, two distillation ledgers whose banners said "never + applied" (both HAD landed, as cookbook §265–§269), a 216 KB raw agent-research JSON, eleven per-session tool designs, frontier + reports and worklists for sessions long closed — beside the live references; no page on how `docs/` or `.run/` are used, no + gitignore template, no AI-conduct rules on the wiki, nothing on Gen3; 1,086 tracked `.run/` files visible on GitHub, 172 of them + tracked by index inertia alone; and 81 memory files under `~/.claude` that no future project could inherit. +- **The three audits (read-only agents) measured the gap** rather than guessing it: every `docs/` file classified (45 KEEP-LIVE, 12 + generated, 6 INTEGRATE, ~60 SUNSET incl. 6 frozen frontier snapshots and 12 orphaned per-binary reports); the `.run/` tree by group + with its live readers (and one firewall gap — two tracked disassembly listings of one matched function, invisible to a path-and-hash + audit); the memory store by class (52 already in the repo, 14 portable-not-in-repo, 9 project-specific, 7 stale, 1 off-project). + An adversarial review of the plan then caught six ordering and design hazards before execution — the forward-link race with the + link checker, the purge set doubling as the history gate's census, regenerating snapshots into empty documents, a content-check regex + that would not have matched its own offenders, a kit that could not write into a constitution ProjectArchitect had already frozen, + and a dry-run that could write into the real tree. +- **The pivot (Drew, 2026-09-07).** Re-charter the next work as **Phase 33.5**, a docs sub-phase BEFORE the flip: (1) the wiki is the + single source of truth — every `docs/` file is KEEP (listed in a Reference index, the only sanctioned wiki→docs link site), + INTEGRATE (folded into a page) or SUNSET (moved with history into `docs/sunset/`, indexed, for Drew's review — deletion is his); + in-repo documents link wiki pages, not `docs/` files; (2) prune only the TRACKED `.run/` (what GitHub shows) — the untracked + 29 GB is out of scope; (3) the wiki carries the conventions (docs, scratch, the ROM firewall with a copyable gitignore); (4) the + day-one kit `decomp-architect/` is built IN-TREE now and split out after the flip as xsig was — and, from the review, it runs AFTER + ProjectArchitect 2.0 as the project's Phase 0.5, shipping an intake document for PA's own interview instead of writing the + constitution; (5) the memory store is reconciled but stays outside git (kit seed only — no `.claude-state/` retrofit for a repo + about to go public); (6) the two disassembly listings are untracked and named in an audit-only rules file, with NO second history + rewrite — the tracked C and the pinned compiler reproduce those bytes, and another force-push would add another set of old tips to + the open Support ticket. Rules R74–R83 (the P33 candidates) ratified at the gate. +- **Measured through task 9 (S90):** ten commits; 17 wiki pages + 13 chapters, all reachable; the six INTEGRATE documents folded + (the hand-matching guide's five signature moves, the wave ledger's per-wave prices and instruction-weight metric, the portable + workflow's six residual items, the hindsight study's permuter-failure track); 59 files archived with history; `doc_links` grew + from one check to six (archive refusal, the index-derived allow-list, docs coverage 64 of 64, git-based citation classification with a + "(not kept)" declaration, wiki-first warnings); the render selftest asserts reachability; the timeline was found STALE at HEAD and + wired into report/audit-digest; tracked `.run/` 1,086 → 868 with `audit_public` gaining a content check whose first cut the + negative control caught (`nop` broke the run at 60 < 64); the history gate still PASS; the project memory store 80 rows == 80 + files with seven stale memories corrected in place; the kit's 16-seed memory pack written with zero project literals. +- **Hindsight path.** Write the wiki as the source of truth FIRST and the summary pages second — P33 built the pages over the + records and left the records as the reference, so the consolidation had to be its own phase. Two instruments that should have + existed from the first wiki commit: a link policy the checker enforces (wiki-first, no links into an archive) and a content check + in the ROM audit — both were one-day builds. And run the referrer census and the pending-list mechanism as a habit for every + document move; the one-shot audits found nothing the checks would not have found continuously. diff --git a/phase-ends/CURRENT_PHASE.md b/phase-ends/CURRENT_PHASE.md index df57fb5bb..1e07a5401 100644 --- a/phase-ends/CURRENT_PHASE.md +++ b/phase-ends/CURRENT_PHASE.md @@ -452,9 +452,16 @@ WAIT for Drew. Rebuild the harness task list (16 rows, R28) marking tasks 0–9 **Phase 33.5** (sub-phase; v1.32.0 → v1.32.1), gate 1 approved 2026-09-07 by Drew in plan mode at Max; effort follows the plan's column (Max for tasks 10, 12, 15 — prompt at each transition, R27). Baseline HEAD `80d45b29b`; task 0 = `39d524991`; task 1 = `a0cf302e5`; task 2 = `d06923a06`; task 3 = `5d10a0d12`; task 4 = `9970f1e62`; task 5 = `a0d4ae836`; task 6 = `6ec4786bd`; task 7 = -`21c98ed5a`; task 8 = `ae71efe56`; task 9 = the commit after it (the seed). No build input changed; the fleet is 218/218 at the -Phase-33 close. Tracked `.run/` = 868; `audit_public` OK; `gate_scan` PASS; `doc_links --strict` green; pending list empty. The kit -directory so far holds ONLY `decomp-architect/memory-seed/` (16 seeds + MEMORY.md). Tasks 10–13 build the rest of the kit; 14–15 close. +`21c98ed5a`; task 8 = `ae71efe56`; task 9 = `caefe9872`; the S90 checkpoint commit follows it (this file + the decision-log entry). +No build input changed; the fleet is 218/218 at the Phase-33 close. Tracked `.run/` = 868; `audit_public` OK; `gate_scan` PASS; +`doc_links --strict` green; pending list empty; tree clean. The kit directory so far holds ONLY `decomp-architect/memory-seed/` +(16 seeds + MEMORY.md). Tasks 10–13 build the rest of the kit; 14–15 close. **Already banked for task 14 (R31, done at the S90 +checkpoint):** the `docs/decision-log.md` entry "P33.5 S90" — task 14 must NOT write a second one; it still owes the wiki page, the +README/Tools rows, the SETUP rows for the kit and any accelerators entry. **Session S90 (2026-09-07) ended here at 85% context**; +the next session is S91. Drew's effort at the end of S90 was xHigh (toggled to Max for task 3 and back); task 10 is Max — prompt. +Nothing is running in the background; the SessionEnd hook stops the headless Ghidra MCP (no RE work happened; nothing under +`ghidra/` is tracked). The plan file `~/.claude/plans/max-effort-set-plan-encapsulated-muffin.md` is a copy of the "Approved plan" +section at the end of this file — this file is the one that counts. ### 2. What NEXT does (task 10, **Max**) — exact steps (plan D5) Read first: `/mnt/z/Storage/git/ProjectArchitect/README.md` (the install ritual, "What gets installed"), `…/project-architect-2.0/SETUP.md`