You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The current root roadmap contains status wording that can drift behind the living native/Core documents. In particular, broad statements equivalent to Rust Core prerequisite work being “not yet started” are no longer precise once the Core Migration Ledger records multiple CI-proven or in-progress Rust proofs/adapters.
This issue owns documentation truth reconciliation only so roadmap readers do not infer a contradictory execution state.
Goal
Make planning documents form a hierarchy of truth rather than competing roadmaps:
ROOT ROADMAP
= strategic product direction / milestone summary
NATIVE ROADMAP
= binding Qt/GPUI admission sequence
CORE MIGRATION LEDGER
= live capability authority/evidence state
GITHUB ISSUES
= executable durable work owners
TODO
= current operational/human checklist
Each higher-level document should link to the lower-level live authority instead of duplicating volatile details unnecessarily.
Required audit
Review at minimum:
v2.0 Foundation status labels in ROADMAP.md;
Rust Core wording versus CORE-MIGRATION-LEDGER.md;
Qt/GPUI wording versus ROADMAP-QT-GPUI-DESKTOP.md;
TODO items that reference completed/merged predecessor work or stale execution anchors.
Issue/PR-number hygiene
Do not rely on historical shorthand like #NNN = topic without checking the live GitHub object.
Issue and PR numbers share the repository namespace and older planning notes can become misleading if a remembered number actually refers to a merged/closed PR or a different subject.
Where roadmap docs cite a numbered object, verify:
current title
issue vs pull request
open/closed/merged state
actual scope
Prefer descriptive link text plus the number when ambiguity matters.
Status vocabulary
Use a small consistent status vocabulary, for example:
PLANNED
PROOF / SHADOW
IN PROGRESS
ADMISSION GATED
PRODUCTION AUTHORITY
DEFERRED
DONE
Do not call a capability “implemented” merely because a shadow Rust proof exists, and do not call it “not started” when CI-proven migration work already exists.
For Qt/GPUI preserve the binding native-roadmap distinction:
Qt = primary native target after Core admission gates;
GPUI = deferred/exploratory, not a current numbered implementation commitment;
Tauri = transitional until acceptance/retirement gates are met;
PWA = independent first-class product surface.
TODO relationship
TODO.md may intentionally contain operational or human-only actions that do not deserve durable engineering issues, such as manual release checks or external badge/account registration.
Do not mechanically convert every TODO checkbox into a GitHub issue. Instead, ensure durable architecture/product work points to an issue/roadmap owner and transient operational work remains clearly classified.
Acceptance criteria
Root roadmap status is consistent with the current native roadmap and Core Migration Ledger.
Rust Core work is described by actual authority maturity rather than binary started/not-started wording.
Qt/GPUI/Tauri/PWA strategic roles are consistent across current planning docs.
Major v2 roadmap bullets link to durable issue owners where execution tracking is appropriate.
Context
WorldScript Studio intentionally has multiple planning/evidence documents with different scopes:
ROADMAP.md— high-level product/v2 direction;TODO.md— current operational/sprint/human tasks;docs/native/ROADMAP-QT-GPUI-DESKTOP.md— binding native renderer strategy/admission gates;docs/native/CORE-MIGRATION-LEDGER.md— living capability-by-capability Core authority state;The current root roadmap contains status wording that can drift behind the living native/Core documents. In particular, broad statements equivalent to Rust Core prerequisite work being “not yet started” are no longer precise once the Core Migration Ledger records multiple CI-proven or in-progress Rust proofs/adapters.
This issue owns documentation truth reconciliation only so roadmap readers do not infer a contradictory execution state.
Goal
Make planning documents form a hierarchy of truth rather than competing roadmaps:
Each higher-level document should link to the lower-level live authority instead of duplicating volatile details unnecessarily.
Required audit
Review at minimum:
ROADMAP.md;CORE-MIGRATION-LEDGER.md;ROADMAP-QT-GPUI-DESKTOP.md;Issue/PR-number hygiene
Do not rely on historical shorthand like
#NNN = topicwithout checking the live GitHub object.Issue and PR numbers share the repository namespace and older planning notes can become misleading if a remembered number actually refers to a merged/closed PR or a different subject.
Where roadmap docs cite a numbered object, verify:
Prefer descriptive link text plus the number when ambiguity matters.
Status vocabulary
Use a small consistent status vocabulary, for example:
Do not call a capability “implemented” merely because a shadow Rust proof exists, and do not call it “not started” when CI-proven migration work already exists.
For Qt/GPUI preserve the binding native-roadmap distinction:
TODO relationship
TODO.mdmay intentionally contain operational or human-only actions that do not deserve durable engineering issues, such as manual release checks or external badge/account registration.Do not mechanically convert every TODO checkbox into a GitHub issue. Instead, ensure durable architecture/product work points to an issue/roadmap owner and transient operational work remains clearly classified.
Acceptance criteria
TODO.mddistinguishes durable engineering work from operational/human-only tasks without creating issue spam.Non-goals