From 751a7708a019675944f5a05fbc856c933b5e7f9b Mon Sep 17 00:00:00 2001 From: Keysat Date: Fri, 19 Jun 2026 23:00:37 -0500 Subject: [PATCH] Handoff: record refactor-scout validated on keysat --- AGENTS.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 8d71245..9469a4c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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` + `refactor-scout` (substance in `guides/`, thin wrappers in `adapters/claude/`, symlinked into `~/.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 - sibling: read-only technical-debt surveyor that finds code smells, dead code, duplication, and - over-complexity in *existing* code (not a diff), prioritizes by churn × complexity, leans on the - repo's own analyzers, and recommends a **disposition** per finding (refactor / delete / defer / - accept) designed to feed `/triage`. Test-net status + risk-to-change are first-class so a refactor - is only ever recommended when behavior preservation can be proven. **Untested on a real repo** — - the first run should sanity-check that it stays opinionated/tiered (≤~12 findings, not a dump) and - honest about test coverage. The risky auto-apply half is deliberately **not built** (deferred + - gated — see item 11). Good first targets: recap, keysat. -- **`/adjudicate` shipped this session (ROADMAP item 10).** Debates parked P2/P3 backlog to +- **`refactor-scout` shipped + validated this session (ROADMAP item 11).** The janitor's + source-code sibling: read-only technical-debt surveyor over *existing* code (not a diff) — finds + smells/dead code/duplication/over-complexity, ranks by churn × complexity, leans on the repo's own + analyzers, and buckets each finding by **disposition** (refactor / delete / defer / accept) to feed + `/triage`. Test-net status + risk-to-change are first-class. **Test-driven on keysat** + (`licensing-service-startos`): stayed tiered (12 findings), honest about coverage, top finding (a + divergent `html_escape`) verified accurate — **no guide tuning needed**; the 4 actionable findings + are queued in `INBOX.md` `(keysat)`. The risky auto-apply half is deliberately **deferred + gated** + (item 11). +- **`/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. **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 @@ -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" open item is **closed**. Residual is per-project execution (ten31-database mobile build, being scoped in that repo — not standards work). -- **Next steps:** (1) first real `refactor-scout` run on recap/keysat to calibrate the tiering + - test-net honesty (item 11); (2) first real `/adjudicate` run on keysat/recap to calibrate the - drop-bias (item 10); (3) Stage-1 `onboarding-tester` harness in a keysat session (item 9); - (4) cross-repo quality-gate standard + `/harden` (item 1); (5) non-git-folder sweep under - `~/Projects` (item 6 residual). -- Queued in `INBOX.md` for other repos' `/triage`: keysat design cleanup (P2) + onboarding Path-2 - (P3); `ten31-transcripts` mini-retrofit; `ten31-database` networking/icon/intake; (standards) - operator-onboarding agent (P3). +- **Next steps:** (1) first real `/adjudicate` run on keysat/recap to calibrate the drop-bias + (item 10); (2) Stage-1 `onboarding-tester` harness in a keysat session (item 9); (3) cross-repo + quality-gate standard + `/harden` (item 1); (4) non-git-folder sweep under `~/Projects` (item 6 + residual). Optional: a second `refactor-scout` run on recap (JS/TS) as a cross-stack data point — + keysat (Rust/TS) already validated item 11. +- Queued in `INBOX.md` for other repos' `/triage`: keysat refactor-scout findings (P2 html-escape + bug + 3× P3 chores) + design cleanup (P2) + onboarding Path-2 (P3); `ten31-transcripts` + mini-retrofit; `ten31-database` networking/icon/intake; (standards) operator-onboarding agent (P3).