docs: correct all owned docs against the shipped mirror-shell app - #269
Open
kevinthelago wants to merge 1 commit into
Open
docs: correct all owned docs against the shipped mirror-shell app#269kevinthelago wants to merge 1 commit into
kevinthelago wants to merge 1 commit into
Conversation
Every owned doc described an earlier version of the app (a standalone git-editing IDE with a 5-tab Files/Find/Edit/Git/Run shell) that no longer exists — it was superseded by the read-only mirror-shell redesign, and CLAUDE.md's own folder structure, data flows, and Known Issues no longer matched a single real path. - CLAUDE.md: reconciled against origin/main's current state (folder structure, data flows, orphaned-code table) — fixes residual drift in the prior refresh (#260): fleet/ and screens/ files it still listed were already deleted (#262), and the Planner tab's live/blueprints segment strip was removed (#250), orphaning LivePlanBoard/BlueprintsSection/plannerBoard.ts. - docs/tunnel-live-planning.md: documents that the dedicated live-plan protocol (read AND write sides) is now fully orphaned; the desktop's live planning session is reached today via plain session chat (findPlannerPane + SessionChat). - docs/redesign-migration-plan.md: replaced the fully-shipped M1-M9 standalone-IDE plan (historical, condensed) with the current in-flight redesign — umbrella #233 (shell reprioritisation) and #234 (store_state payload-contract drift), with live per-domain status pulled from the issue tracker. - docs/git-feature-handoff.md: rewritten from a "finish this" TODO for a Git tab that no longer exists into a reference for the current git/GitHub layer — the file-push/pull path is complete but UI-orphaned; the Planner's GitHub-publish path is the one live consumer today. - docs/kit-bindings.md: created new, then replaced with a verified version of the already-existing (but unlinked-from-here) designer-spec wiring contract for the data-driven `kit` system, after confirming my first-pass guess (a components/themes mirror-domain contract) targeted the wrong feature. - docs/planner-sync-protocol.md: light-touch update — the wire contract was already accurate; added the app-level wiring (PlannerSyncContext, the sync conflict editor) the doc never described. - .github/PROJECT_PLAN.md: corrected mobile's architecture/stack/test-gate description (pre-tunnel-server, pre-mirror-redesign stale); left the shared roadmap/version tables untouched as a planner-owned call (noted for the director). - README.md: fixed repo casing in badge/issue links, the actual branch-naming convention (`{number}-slug`, not `issue-{number}/slug`), a non-existent workflow filename, and a tagline describing the old standalone-IDE framing. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015FXK8tKCMEbEd4obFsqhDs
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Every doc in this stream's lane (
CLAUDE.md,README.md,.github/PROJECT_PLAN.md, and thefour
docs/*.mdprotocol/handoff docs) described an earlier version of the app — a standalonegit-editing IDE with a 5-tab Files/Find/Edit/Git/Run shell — that no longer exists. It was
superseded by the read-only mirror-shell redesign, and none of the docs, including CLAUDE.md's
own folder structure and data-flow sections, matched a real code path anymore.
orphaned-code table). This also fixes residual drift in the prior refresh (CLAUDE.md is stale: documents a shell, a workflow, and a tech-debt list that no longer exist #260): the
fleet//screens/files it still listed were already deleted (24 source files are unreachable from any route — triage and clear the orphans #262), and the Planner tab'slive/blueprints segment strip was removed (App Store submission: standalone demo mode for review completeness (2.1) #250), orphaning
LivePlanBoard/BlueprintsSection/plannerBoard.ts.and write sides) is now fully orphaned; the desktop's live planning session is reached today
via plain session chat (
findPlannerPane+SessionChat), not a structured stepper view.(condensed as history) with the current in-flight redesign: umbrella Umbrella: reprioritised shell — Glance · Planner · Studio · Skills · Automations #233 (shell
reprioritisation) and Umbrella: resync store_state payloads with base-studio-code develop (contract v2 drift) #234 (
store_statepayload-contract drift), with live per-domain statuspulled from the issue tracker.
longer exists into a reference for the current git/GitHub layer: the file push/pull path is
complete but UI-orphaned; the Planner's GitHub-publish path is the one live consumer today.
already-existing (but previously unlinked-from-here) designer-spec wiring contract for the
data-driven
kitsystem, after confirming my first-pass guess (a components/themesmirror-domain contract) targeted the wrong feature entirely.
added the app-level wiring (
PlannerSyncContext, the sync conflict editor) it never described.(pre-tunnel-server, pre-mirror-redesign stale); left the shared roadmap/version tables
untouched as a planner-owned call.
(
{number}-slug, notissue-{number}/slug), a non-existent workflow filename, and a taglinestill describing the old standalone-IDE framing.
Note on base branch
This repo's remote has no
developbranch — every prior merge in its history went straight intomain(confirmed viagh api repos/.../branches), so this PR targetsmainto match that.Retarget if a
developbranch exists elsewhere I'm not seeing.Test plan
git diff --statconfirms only the 7 owned doc files changed (0.ts/.tsx/.jsontouched) —
tsc --noEmit/npm testoutcomes are unaffected by construction.verified against the actual current source (
origin/main), not assumed from memory.Co-Authored-By: Claude Sonnet 5 noreply@anthropic.com