Skip to content

docs: backlog + plans/specs cleanup (verified, restructured, detail files)#383

Merged
rulkens merged 4 commits into
mainfrom
worktree-docs-cleanup
Jun 29, 2026
Merged

docs: backlog + plans/specs cleanup (verified, restructured, detail files)#383
rulkens merged 4 commits into
mainfrom
worktree-docs-cleanup

Conversation

@rulkens

@rulkens rulkens commented Jun 29, 2026

Copy link
Copy Markdown
Owner

Docs-only cleanup of the plan/spec tree and BACKLOG.md.

Plans & specs

BACKLOG verification

Ran a background-agent pass over every open item against the current tree. Removed items confirmed shipped: settings-store RTK Phase 2, incremental intent-migration, GLADE shell artifact, the add-data-source skill, and the structure-DRY visibility-default + markerBearing sub-items. Narrowed partials to their open remainder (mobile→StatusBar, MW deep-link→encode, thumbnail→in-scene path, tour→reusable structure-visit clip, GPU-handle→post-RFS follow-on). Also removed all previously-~~DONE~~ entries per the "shipped work is absent" convention.

Restructure

  • Index regrouped by subsystem area with a readiness tag (ready/needs-design/deferred/manual/process/blocked) + checkbox + one-line title per item. ADR-status table refreshed.
  • The ~15 design-bearing items got docs/backlog/<slug>.md detail files (problem + verified current state with file:line evidence + options), each linked from the index and ready to promote into a spec/plan.

🤖 Generated with Claude Code

rulkens and others added 3 commits June 29, 2026 17:26
The two active plans and two active specs were all resolved, not in-flight:

- camera-intent-slice (plan + spec) shipped via PR #357 (+#358/#359);
  the plan checkboxes just never got ticked. Verified every later-phase
  symbol exists (cameraSlice, pickWinner, deriveFrameContext,
  commitCameraPose, beginDrag/endDrag). Relocated to */completed/.
- The tour-animation spec + splash-screen-02-stub-tour plan were
  superseded by the animation clips+saga system that actually shipped the
  tour (PRs #364/#366/#367/#373/#375). The TourStore seed they describe
  was never built (zero refs in src/). Relocated to */completed/ with a
  SUPERSEDED banner pointing at the real docs.

BACKLOG.md reconciled: camera-intent marked DONE, tour plan/spec marked
superseded, the dead stub-tour links re-pointed at the shipped animation
plans, "Tour feature (full)" rewritten to reflect shipped-via-animation +
remaining per-structure choreography, and "Debug-panel clip triggers"
marked DONE (#369). Both active plan/spec dirs are now empty.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Per the convention (shipped work is intentionally absent from BACKLOG),
drop the fully-done top-level entries: fade-ownership, camera-intent,
SpaceMouse removal, debug-panel clip triggers, state.bias, galaxy-catalog
isFirstLoad proxy, extract-settings-literal, cluster→structure rename.
The "Plans ready to pick up" section is now empty (active plans/ dir is
empty) — replaced with a None note, matching "Specs awaiting plans".
The Milky-Way first-class entry collapses to just its open follow-up
(URL deep-linking). Still-open multi-phase trackers (RTK migration,
selection fold, structure-DRY) keep their ✅ sub-bullets as progress
context.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… files

Ran a background-agent verification pass over every open backlog item
against the current tree. Removed items confirmed shipped: settings-store
RTK Phase 2, incremental intent-migration, GLADE shell artifact (default
path no longer produces it), the add-data-source skill, and the
structure-DRY visibility-default + markerBearing sub-items. Narrowed
partials to their open remainder (mobile→StatusBar, MW deep-link→encode,
thumbnail→in-scene path, tour→reusable structure-visit clip, DRY→just
hasBulkCatalog, GPU-handle→post-RFS follow-on).

Restructured the index by subsystem area (Engine & State / Rendering /
Data pipeline / UI & UX / Docs & process / External / Outreach) with a
readiness tag + checkbox + one-line title per item, and refreshed the
stale ADR-status table.

Moved the verbose context for the ~15 design-bearing items into
docs/backlog/<slug>.md detail files (problem + verified-current-state
with file:line evidence + options), each linked from the index and ready
to promote into a spec/plan. Nothing lost — the trimmed prose plus the
agents' code evidence lives in the detail files.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 29, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
skymap b3998cf Commit Preview URL

Branch Preview URL
Jun 29 2026, 03:49 PM

Match the plans/specs naming convention. Renamed the 15 docs/backlog/
detail files to 2026-06-29-<name>.md and repointed every index link +
the three internal cross-links.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@rulkens rulkens merged commit 06c8ce0 into main Jun 29, 2026
1 of 2 checks passed
@rulkens rulkens deleted the worktree-docs-cleanup branch June 29, 2026 20:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant