mr-onion

Phase 29 — Skills Maintenance: Close the crawl-and-classify-pages Gaps

Version: 1.0 Date: 2026-09-24 Status: Draft — for review, not yet started

Context

skills/ROADMAP.md’s own entry for crawl-and-classify-pages already states its status honestly: “built, unverified live” — the skill has never been driven against a real connected browser-automation tool, and that’s flagged in the doc, not hidden. This phase formalizes that already-known caveat into an actionable ticket (TFP-102) rather than leaving it as a status line nobody is assigned to close.

The second finding is new, not previously flagged anywhere in the repo: the skill was built by directly reproducing src/lib/introspect/dom-snapshot.ts’s classification logic at a point in time (per skills/ROADMAP.md’s own “Generalizes” note). That file has since picked up four real commits the skill never absorbed:

None of this appears in skills/ROADMAP.md’s Known Gaps section or the skill’s own SKILL.md — confirmed by direct grep against both files on 2026-09-24. The skill’s classification output no longer matches what TestForge’s own introspection actually reports for the same page, silently.

Scope

In scope

  1. Diff dom-snapshot.ts’s current classification logic against skills/testing/crawl-and-classify-pages/SKILL.md’s Step B algorithm; port the four gaps above into the skill’s worked-through rules.
  2. Add a “last synced against commit X” marker to the skill so future drift is visible without another full audit.
  3. Formalize the already-flagged live-verification gap into a real ticket with a named target and a worked example, closing the “unverified live” status line in skills/ROADMAP.md.

Out of scope

Backlog

Ticket numbers continue from Phase 21’s above (TFP-098–100) — confirm against the live backlog before filing.

TFP-101 — Sync crawl-and-classify-pages with dom-snapshot.ts’s drift

TFP-102 — Validate crawl-and-classify-pages against a live browser tool

  1. TFP-101 (no dependencies, start anytime)
  2. TFP-102 (independent of TFP-101, but doing 101 first means 102 validates the corrected version rather than the stale one)

Suggested Milestone Gate

Gate — Phase 29 complete