Handoff: record refactor-scout validated on keysat

This commit is contained in:
Keysat
2026-06-19 23:00:37 -05:00
parent ccae956ccb
commit 751a7708a0
+18 -18
View File
@@ -92,16 +92,16 @@ should carry this so any vendor's agent surfaces pending items at session start:
/full-eval /design /adjudicate`; subagents incl. `design-checker`, `onboarding-tester` + /full-eval /design /adjudicate`; subagents incl. `design-checker`, `onboarding-tester` +
`refactor-scout` (substance in `guides/`, thin wrappers in `adapters/claude/`, symlinked into `refactor-scout` (substance in `guides/`, thin wrappers in `adapters/claude/`, symlinked into
`~/.claude`). Dogfoods its own standard. Latest `/roundup`: `STATUS.md` 2026-06-16. `~/.claude`). Dogfoods its own standard. Latest `/roundup`: `STATUS.md` 2026-06-16.
- **`refactor-scout` shipped this session (ROADMAP item 11).** The janitor's source-code - **`refactor-scout` shipped + validated this session (ROADMAP item 11).** The janitor's
sibling: read-only technical-debt surveyor that finds code smells, dead code, duplication, and source-code sibling: read-only technical-debt surveyor over *existing* code (not a diff) — finds
over-complexity in *existing* code (not a diff), prioritizes by churn × complexity, leans on the smells/dead code/duplication/over-complexity, ranks by churn × complexity, leans on the repo's own
repo's own analyzers, and recommends a **disposition** per finding (refactor / delete / defer / analyzers, and buckets each finding by **disposition** (refactor / delete / defer / accept) to feed
accept) designed to feed `/triage`. Test-net status + risk-to-change are first-class so a refactor `/triage`. Test-net status + risk-to-change are first-class. **Test-driven on keysat**
is only ever recommended when behavior preservation can be proven. **Untested on a real repo** — (`licensing-service-startos`): stayed tiered (12 findings), honest about coverage, top finding (a
the first run should sanity-check that it stays opinionated/tiered (≤~12 findings, not a dump) and divergent `html_escape`) verified accurate — **no guide tuning needed**; the 4 actionable findings
honest about test coverage. The risky auto-apply half is deliberately **not built** (deferred + are queued in `INBOX.md` `(keysat)`. The risky auto-apply half is deliberately **deferred + gated**
gated — see item 11). Good first targets: recap, keysat. (item 11).
- **`/adjudicate` shipped this session (ROADMAP item 10).** Debates parked P2/P3 backlog to - **`/adjudicate` shipped (ROADMAP item 10).** Debates parked P2/P3 backlog to
DROP/DO/ESCALATE verdicts; recommend-only v1, autonomy gated by blast radius, ROADMAP-only. DROP/DO/ESCALATE verdicts; recommend-only v1, autonomy gated by blast radius, ROADMAP-only.
**Untested on a real backlog** — the first run should eyeball the judge's drop-bias before **Untested on a real backlog** — the first run should eyeball the judge's drop-bias before
trusting it (tune the tie-break rule in `guides/adjudicate.md` if it over-drops). Best first trusting it (tune the tie-break rule in `guides/adjudicate.md` if it over-drops). Best first
@@ -116,11 +116,11 @@ should carry this so any vendor's agent surfaces pending items at session start:
notes promoted to `guides/design.md` (`176eebe`). The "confirm export internals + tune Phase-C" notes promoted to `guides/design.md` (`176eebe`). The "confirm export internals + tune Phase-C"
open item is **closed**. Residual is per-project execution (ten31-database mobile build, being open item is **closed**. Residual is per-project execution (ten31-database mobile build, being
scoped in that repo — not standards work). scoped in that repo — not standards work).
- **Next steps:** (1) first real `refactor-scout` run on recap/keysat to calibrate the tiering + - **Next steps:** (1) first real `/adjudicate` run on keysat/recap to calibrate the drop-bias
test-net honesty (item 11); (2) first real `/adjudicate` run on keysat/recap to calibrate the (item 10); (2) Stage-1 `onboarding-tester` harness in a keysat session (item 9); (3) cross-repo
drop-bias (item 10); (3) Stage-1 `onboarding-tester` harness in a keysat session (item 9); quality-gate standard + `/harden` (item 1); (4) non-git-folder sweep under `~/Projects` (item 6
(4) cross-repo quality-gate standard + `/harden` (item 1); (5) non-git-folder sweep under residual). Optional: a second `refactor-scout` run on recap (JS/TS) as a cross-stack data point —
`~/Projects` (item 6 residual). keysat (Rust/TS) already validated item 11.
- Queued in `INBOX.md` for other repos' `/triage`: keysat design cleanup (P2) + onboarding Path-2 - Queued in `INBOX.md` for other repos' `/triage`: keysat refactor-scout findings (P2 html-escape
(P3); `ten31-transcripts` mini-retrofit; `ten31-database` networking/icon/intake; (standards) bug + 3× P3 chores) + design cleanup (P2) + onboarding Path-2 (P3); `ten31-transcripts`
operator-onboarding agent (P3). mini-retrofit; `ten31-database` networking/icon/intake; (standards) operator-onboarding agent (P3).