Update roadmap.md

This commit is contained in:
PSBigBig + MiniPS 2026-03-29 21:50:46 +08:00 committed by GitHub
parent 47ce322b7e
commit b570a539e5
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -7,27 +7,27 @@ This page is the roadmap document for WFGY 4.0 Twin Atlas Engine.
What this page is for:
1. Explain the current stage of the Twin Atlas project.
2. Show what has already been built at the public effective-layer level.
3. Show what comes next in the MVP, coupling, runtime, demo, and formalization tracks.
3. Show what comes next in the public stack, coupling, runtime, evidence, demo, and formalization tracks.
4. Help readers understand the difference between current readiness and future ambition.
How to use this page:
1. Read this page after the Twin Atlas README if you want the big-picture plan.
2. Use it to understand what is already present, what is in progress, and what is future work.
3. Use it to navigate between public docs, runtime surfaces, demo surfaces, and future implementation direction.
3. Use it to navigate between public docs, runtime surfaces, evidence surfaces, and future implementation direction.
4. Treat this page as a roadmap and planning surface, not as proof that every listed item is already complete.
Important boundary:
This page explains the public roadmap of Twin Atlas.
It does not expose hidden internal reasoning substrate details.
It also does not claim that every future closed-loop runtime or formalization layer is already complete.
This roadmap mixes current MVP work, near-term coupling work, and longer-term formalization work in one navigable place.
This roadmap mixes current public-stack work, near-term coupling work, and longer-term formalization work in one navigable place.
Recommended reading path:
1. Twin Atlas README
2. FAQ
3. Bridge README
4. Demos README
5. Runtime README
2. Quickstart
3. Related Documents
4. Runtime README
5. Evidence Hub
6. This roadmap
AI_NOTE_END
@ -43,10 +43,12 @@ It already has:
- a product identity
- a public architecture frame
- a Bridge specification direction
- a demo layer
- a runtime layer
- a growing documentation surface
- a Bridge clarification layer
- a runtime documentation spine
- a visible evidence surface
- a visible demo surface
- a figure layer
- raw experiment assets
That means the roadmap now needs to do something more serious than say “interesting work ahead.”
@ -54,7 +56,7 @@ It needs to answer three real questions:
1. **what already exists**
2. **what comes next**
3. **how the project moves from architecture into actual coupling and stronger runtime behavior**
3. **how the project moves from public architecture into stronger coupling and more operational behavior**
This page exists to answer those questions cleanly.
@ -65,16 +67,28 @@ This page exists to answer those questions cleanly.
| Section | Link |
|---|---|
| Twin Atlas Home | [Twin Atlas](./README.md) |
| Quickstart | [Quickstart](./quickstart.md) |
| Related Documents | [Related Documents](./related-documents.md) |
| Status and Boundaries | [Status and Boundaries](./status-and-boundaries.md) |
| FAQ | [FAQ](./faq.md) |
| Release Notes | [Release Notes](./release-notes.md) |
| Bridge Home | [Bridge README](./Bridge/README.md) |
| Bridge v1 Spec | [Bridge v1 Spec](./Bridge/bridge-v1-spec.md) |
| Bridge Examples | [Bridge v1 Examples](./Bridge/bridge-v1-examples.md) |
| Bridge Eval Notes | [Bridge v1 Eval Notes](./Bridge/bridge-v1-eval-notes.md) |
| Demos Home | [Demos README](./demos/README.md) |
| Why Bridge Exists | [Why Bridge Exists](./Bridge/why-bridge-exists.md) |
| Runtime Home | [Runtime README](./runtime/README.md) |
| Basic Runtime | [Twin Atlas Basic](./runtime/twin-atlas-basic.txt) |
| Advanced Runtime | [Twin Atlas Advanced](./runtime/twin-atlas-advanced.txt) |
| Strict Runtime | [Twin Atlas Strict](./runtime/twin-atlas-strict.txt) |
| Runtime Constitution | [Twin Atlas Runtime Constitution](./runtime/twin-atlas-runtime-constitution.md) |
| Inverse Governance Contract | [Inverse Governance Contract](./runtime/inverse-governance-contract.md) |
| State Machine and Output | [State Machine and Output](./runtime/state-machine-and-output.md) |
| Seal and Audit | [Seal and Audit](./runtime/seal-and-audit.md) |
| Evidence Hub | [Evidence Hub](./evidence/README.md) |
| Results Summary | [Results Summary](./evidence/results-summary.md) |
| Governance Stress Suite | [Governance Stress Suite](./evidence/governance-stress-suite.md) |
| Basic Repro Demo | [Basic Repro Demo](./evidence/basic-repro-demo.md) |
| Advanced Clean Protocol | [Advanced Clean Protocol](./evidence/advanced-clean-protocol.md) |
| Flagship Cases | [Flagship Cases](./evidence/flagship-cases.md) |
| Methodology Boundary | [Methodology Boundary](./evidence/methodology-boundary.md) |
| Raw Runs | [Raw Runs](./evidence/raw-runs/) |
| Figures | [Figures README](./figures/README.md) |
| Demos | [Demos README](./demos/README.md) |
| Forward Atlas | [Problem Map 3.0 Troubleshooting Atlas](../wfgy-ai-problem-map-troubleshooting-atlas.md) |
| Inverse Atlas Home | [Inverse Atlas README](../Inverse_Atlas/README.md) |
@ -84,11 +98,12 @@ This page exists to answer those questions cleanly.
If you only remember one thing, remember this:
**Twin Atlas is moving in three layers at once:**
**Twin Atlas is now moving in four tracks at once:**
1. **public engine identity**
2. **runtime and coupling maturation**
3. **longer-term formalization**
1. **public engine stack**
2. **coupling maturation**
3. **runtime hardening**
4. **longer-term formalization**
That means the roadmap is not one straight line.
@ -100,36 +115,47 @@ It is a staged build.
## ✅ What already exists
At the current stage, the following pieces already exist in meaningful form:
At the current stage, the following pieces already exist in meaningful public form:
### Product layer
- Twin Atlas engine identity
- README-level framing
- quickstart layer
- related-documents layer
- status-and-boundaries layer
- FAQ layer
- public roadmap layer
- release-notes layer
- roadmap layer
### Bridge layer
- Bridge role definition
- Bridge v1 technical specification
- Bridge examples
- Bridge evaluation notes
### Demo layer
- demos entry page
- killer demo specification
- Case 01
- baseline vs Twin Atlas comparison table
- evaluator notes
- Why Bridge Exists clarification
- public Bridge entry surface
### Runtime layer
- runtime entry page
- basic runtime starter
- advanced runtime
- strict runtime
- runtime constitution page
- inverse governance contract
- state machine and output page
- seal and audit page
### Evidence layer
- evidence entry page
- results summary
- methodology boundary
- governance stress suite
- flagship cases
- Basic Repro Demo
- Advanced Clean Protocol
- raw experiment assets
### Demo and figure layer
- demos entry page
- figures entry page
That means the project is already beyond pure concept mode.
It already has a public effective-layer skeleton strong enough to support MVP development.
It already has a public effective-layer stack strong enough to support meaningful MVP release behavior.
---
@ -138,45 +164,48 @@ It already has a public effective-layer skeleton strong enough to support MVP de
At the current stage, the following are still incomplete or still evolving:
### Coupling layer implementation
- actual runtime-facing Bridge behavior
- stronger public runtime handoff logic
- more concrete coupling between route preservation and authorization behavior
- more implementation-facing Bridge behavior
- tighter runtime-facing handoff logic
- stronger explicit coupling between route preservation and authorization behavior
### Demo expansion
- more demo cases
- stronger multi-family coverage
- richer comparison assets
- optional screenshot-ready proof packs
### Evidence and demo deepening
- richer case expansion
- stronger side-by-side assets
- more polished public proof packs
- more screenshot-ready and figure-ready proof surfaces
### Runtime maturity
- stronger variant separation testing
- more implementation-facing runtime notes
- more explicit mode transition behavior
- stronger forward-route runtime page
- tighter relation between runtime docs and actual usage paths
- more implementation-facing mode-selection notes
### Formalization
- stronger state-machine language
- stronger legality-language formalization
- more rigorous future mathematical packaging
- stronger state-language precision
- stronger legality-language precision
- future mathematical packaging preparation
So the architecture is already real, but the deeper loop is still under construction.
So the public architecture is already real, but the deeper loop is still under construction.
---
# 🧱 Section 2 · Roadmap Structure
Twin Atlas should be understood as progressing through four major tracks.
Twin Atlas should be understood as progressing through five major tracks.
## 1. 📘 Public engine track
This track defines identity, documentation, entry points, and external legibility.
## 1. 📘 Public stack track
This track defines identity, navigation, onboarding, and external legibility.
## 2. 🌉 Coupling track
This track strengthens the internal handoff between forward mapping and inverse governance.
## 3. ⚙️ Runtime track
This track turns the architecture into more usable public runtime forms and later stronger operating behavior.
This track turns the architecture into a stronger usable public runtime surface and later more operational behavior.
## 4. 🧠 Formalization track
This track pushes the engine toward stronger structural rigor, state logic, and eventually deeper mathematical packaging.
## 4. 🧪 Evidence and proof track
This track strengthens before/after visibility, raw assets, cases, demos, and figure support.
## 5. 🧠 Formalization track
This track pushes the engine toward stronger structural rigor, state logic, legality logic, and eventually deeper mathematical packaging.
These tracks overlap, but they do not move at the same speed.
@ -190,43 +219,54 @@ That is normal.
The MVP goal is not to prove that every future Twin Atlas operating detail is already complete.
The MVP goal is to make three things true at the same time:
The MVP goal is to make four things true at the same time:
### 1. The product is legible
A serious reader should understand what Twin Atlas is and why it matters.
### 2. The coupling direction is real
Bridge should feel like a real architectural layer, not a naming flourish.
### 2. The architecture is navigable
A new reader should be able to move from identity to runtime to evidence without getting lost.
### 3. The difference is visible
The demo layer should make the engines value legible without requiring a long philosophical defense.
The evidence and demo layers should make the WFGY 4.0 shift legible without requiring a long philosophical defense.
### 4. The next development zone is obvious
It should be clear that the next step is deeper coupling and runtime maturation, not more identity invention.
That is the correct MVP bar.
---
## ✅ MVP public-surface checklist
## ✅ MVP public-stack checklist
The MVP public-surface layer should include at minimum:
- `README.md`
- `quickstart.md`
- `related-documents.md`
- `status-and-boundaries.md`
- `faq.md`
- `release-notes.md`
- `roadmap.md`
- `Bridge/README.md`
- `Bridge/bridge-v1-spec.md`
- `Bridge/bridge-v1-examples.md`
- `Bridge/bridge-v1-eval-notes.md`
- `demos/README.md`
- `demos/killer-demo-spec.md`
- `demos/case-01-thin-evidence-f5-vs-f6.md`
- `demos/baseline-vs-twin-atlas-table.md`
- `demos/evaluator-notes.md`
- `Bridge/why-bridge-exists.md`
- `runtime/README.md`
- `runtime/twin-atlas-basic.txt`
- `runtime/twin-atlas-advanced.txt`
- `runtime/twin-atlas-strict.txt`
- `runtime/twin-atlas-runtime-constitution.md`
- `runtime/inverse-governance-contract.md`
- `runtime/state-machine-and-output.md`
- `runtime/seal-and-audit.md`
- `evidence/README.md`
- `evidence/results-summary.md`
- `evidence/methodology-boundary.md`
- `evidence/governance-stress-suite.md`
- `evidence/flagship-cases.md`
- `evidence/basic-repro-demo.md`
- `evidence/advanced-clean-protocol.md`
- `evidence/raw-runs/`
- `demos/README.md`
- `figures/README.md`
At the documentation level, that is already close to a meaningful MVP stack.
At the public documentation level, that is already a meaningful MVP stack.
---
@ -234,13 +274,13 @@ At the documentation level, that is already close to a meaningful MVP stack.
Recommended near-term additions:
- `release-notes.md`
- one architecture figure page
- one compact launch-summary page
- one Bridge implementation-facing notes page
- at least one additional demo after Case 01
- `runtime/forward-route-contract.md`
- `implementation-plan.md`
- stronger demo subpages
- stronger figure subpages
- one compact launch-summary page if needed
These are not required for identity, but they strongly improve launch quality.
These are not required for identity, but they strongly improve launch quality and operational clarity.
---
@ -267,11 +307,9 @@ This is where Bridge matters most.
Already present:
- Bridge role definition
- Bridge v1 contract
- direct field mapping examples
- reject logic direction
- evaluation posture
- clear advisory-only law
- Why Bridge Exists public clarification
- advisory-only law at the public level
- route vs authorization separation as public doctrine
That means the coupling track is not empty.
@ -284,25 +322,25 @@ It already has a strong design skeleton.
Near-term next steps:
### Coupling step 1
Turn Bridge from a spec-only layer into a more implementation-facing layer.
Add a stronger implementation-facing Bridge layer.
### Coupling step 2
Define stronger runtime-facing handoff expectations between:
- forward routing
- bridge packet
Define tighter runtime-facing handoff expectations between:
- forward route judgment
- handoff packet
- inverse recheck
- visible output mode
### Coupling step 3
Use the demo cases as implementation targets.
Use evidence and demo cases as implementation targets.
### Coupling step 4
Make route preservation, ambiguity preservation, and anti-inflation behavior more testable.
### Coupling step 5
Add richer error and reject behavior notes where needed.
Add richer reject and fail-closed behavior notes where needed.
This is the main “real development” zone after the public docs stabilize.
This is the main real-development zone after the public stack stabilizes.
---
@ -316,14 +354,15 @@ The runtime layer should:
- stay public-facing
- remain structurally honest
- preserve the Twin Atlas discipline
- preserve Twin Atlas discipline
- remain practical enough for real users
That is why the runtime layer is split into:
- Basic
- Advanced
- Strict
That is why the runtime layer now revolves around:
- runtime identity
- public constitution
- governance contract
- state logic
- seal and audit
---
@ -332,11 +371,12 @@ That is why the runtime layer is split into:
Already present:
- runtime entry page
- basic runtime starter
- advanced runtime
- strict runtime
- public runtime constitution page
- inverse governance contract
- state machine and output page
- seal and audit page
This means the engine already has a public runtime ladder.
This means the engine already has a real public runtime spine.
That is a major milestone.
@ -347,89 +387,135 @@ That is a major milestone.
Near-term next steps:
### Runtime step 1
Refine the differences between Basic, Advanced, and Strict through real use and review.
Add the forward-route runtime page.
### Runtime step 2
Add clearer implementation-facing notes for when each mode should be chosen.
Clarify more implementation-facing usage guidance around runtime choice and runtime reading order.
### Runtime step 3
Align runtime behavior with the killer demo expectations.
Tighten the relationship between runtime behavior and Bridge preservation laws.
### Runtime step 4
Strengthen the connection between runtime behavior and Bridge preservation laws.
Align runtime expectations more directly with evidence and demo targets.
### Runtime step 5
Eventually build toward a stronger public-facing operating loop without exposing hidden substrate details.
This track becomes especially important once real users start trying the runtime files.
This track becomes especially important as the project moves from page-building toward deeper operational behavior.
---
# 🎭 Section 6 · Demo Track
# 🧪 Section 6 · Evidence and Proof Track
## 🎯 Demo goal
## 🎯 Evidence goal
The demo track exists to make the engines value visible.
The evidence track exists to make the engines value visible in a disciplined way.
The demos should show that Twin Atlas is not merely:
The evidence surface should show that Twin Atlas is not merely:
- calmer wording
- a nicer tone
- a calmer tone
- a nicer prompt
- softer confidence
The demos should show real gains in:
It should show real gains in:
- route discipline
- route/authorization separation
- ambiguity preservation
- authorization discipline
- repair discipline
- safer next-step quality
- lawful downgrade
- evidence-boundary discipline
- resistance to fake closure
---
## ✅ What is already done in the demo track
## ✅ What is already done in the evidence track
Already present:
- demos entry layer
- killer demo spec
- Case 01
- baseline vs Twin Atlas comparison table
- evaluator notes
- evidence entry page
- results summary
- methodology boundary
- governance stress suite
- flagship cases
- Basic Repro Demo
- Advanced Clean Protocol
- raw experiment assets
This means the proof surface is already real.
---
## 🚧 What comes next in the demo track
## 🚧 What comes next in the evidence track
Near-term next steps:
### Evidence step 1
Expand and polish the case surface.
### Evidence step 2
Strengthen figure support for the evidence layer.
### Evidence step 3
Make the Advanced path easier to attach to cleaner reruns and control surfaces.
### Evidence step 4
Build stronger proof packs for external explanation, screenshots, and launch surfaces.
### Evidence step 5
Keep the methodology boundary stable while the evidence surface expands.
This track remains one of the highest-value public-facing zones of the whole project.
---
# 🎭 Section 7 · Demo and Figure Track
## 🎯 Demo goal
The demo and figure track exists to make the architecture visible.
The point is not to make Twin Atlas look flashy.
The point is to make readers quickly see:
- where baseline overreaches
- where Twin Atlas stays lawful longer
- where the shift is structural, not cosmetic
- why the engine matters in real high-risk cases
---
## ✅ What is already done in the demo and figure track
Already present:
- demos entry page
- figures entry page
This means the visual and proof-facing surfaces now have real public landing points.
---
## 🚧 What comes next in the demo and figure track
Near-term next steps:
### Demo step 1
Expand beyond Case 01.
Recommended future directions:
- F3 vs F4 ambiguity
- RAG anchor mismatch
- research interpretation ambiguity
- more mixed-route workflow cases
Add stronger individual demo pages.
### Demo step 2
Build more screenshot-friendly demo assets.
Build figure-ready scoreboard and case-card surfaces.
### Demo step 3
Strengthen evaluator consistency.
Strengthen the connection between flagship cases and public demo packaging.
### Demo step 4
Optionally add one “public launch proof pack” with the shortest visible contrast.
Prepare launch-ready hero and proof visuals.
The demo layer is where outside readers will most quickly feel the difference.
So this track remains high value.
This track is especially important for public comprehension and external traction.
---
# 🧠 Section 7 · Formalization Track
# 🧠 Section 8 · Formalization Track
## 🎯 Formalization goal
@ -454,11 +540,12 @@ This is the track that eventually points toward stronger mathematics.
Already present at a pre-formal level:
- route vs authorization separation
- advisory-only coupling law
- advisory-only coupling logic
- visible answer boundary discipline
- candidate vs verdict separation
- ambiguity preservation logic
- reject / fail-closed direction
- seal and audit logic
These are not full formal proofs.
@ -473,13 +560,6 @@ Near- to mid-term next steps:
### Formalization step 1
Define Twin Atlas state logic more explicitly.
Examples:
- coarse
- unresolved
- route-leading but contested
- stronger authorization possible
- stronger authorization blocked
### Formalization step 2
Define stronger visible-state transition rules.
@ -496,24 +576,25 @@ That final step is where future higher-order formalization may become meaningful
---
# 📌 Section 8 · What should happen first
# 📌 Section 9 · What should happen first
This is the most practical sequencing advice.
## ✅ First priority
Finish and stabilize the public effective layer.
Finish and stabilize the public stack.
This means:
- main docs
- bridge docs
- demo docs
- runtime docs
That means:
- onboarding pages
- Bridge pages
- runtime pages
- evidence pages
- demos and figures entry pages
- roadmap / FAQ / release notes
## ✅ Second priority
Use the public docs and demo cases as implementation targets.
Use the public docs and case surfaces as implementation targets.
This means:
That means:
- Bridge behavior
- runtime behavior
- handoff discipline
@ -533,7 +614,7 @@ Do not invert it.
---
# 🚫 Section 9 · What should not block the project
# 🚫 Section 10 · What should not block the project
The project should **not** be blocked by the following:
@ -542,13 +623,13 @@ The project should **not** be blocked by the following:
- pretending that no public documentation should exist until total implementation is done
- confusing architecture maturity with total completion
Twin Atlas is strong enough already to justify public engine framing, MVP docs, and visible proof surfaces.
Twin Atlas is already strong enough to justify public engine framing, MVP docs, and visible proof surfaces.
That is important.
---
# 💻 Section 10 · Practical Development Direction
# 💻 Section 11 · Practical Development Direction
This is the part many builders care about most.
@ -558,9 +639,9 @@ Yes, the project can now move from page-building toward real development.
But the right development sequence is:
### 1. stabilize public layer
### 2. tighten runtime layer
### 3. tighten coupling behavior
### 1. stabilize public stack
### 2. tighten runtime spine
### 3. deepen coupling behavior
### 4. deepen implementation-facing structure
### 5. continue formalization in parallel or later
@ -576,30 +657,33 @@ That is the correct product-building posture.
---
# ✅ Section 11 · What is already fair to say
# ✅ Section 12 · What is already fair to say
At the current stage, these statements are fair:
- Twin Atlas already has a real engine identity
- the public architecture is already coherent
- Bridge already has a serious specification direction
- the runtime surface already exists
- the demo surface already exists
- the public stack is already coherent
- Bridge already has a serious public role
- the runtime surface already exists in meaningful form
- the evidence surface already exists in meaningful form
- the demo and figure layers already exist as public-facing surfaces
- the project is already in meaningful MVP build territory
- the next major step is coupling maturation, not identity invention
- the next major step is deeper coupling and completion work, not identity invention
These are strong claims, but still honest.
---
# 🚧 Section 12 · What should not yet be claimed
# 🚧 Section 13 · What should not yet be claimed
This roadmap should not be used to claim that:
- the entire:
- the entire closed-loop runtime is already fully complete
- every Bridge implementation detail is already frozen
- every future state transition law is already formalized
- one public demo case already proves universal superiority
- the evidence surface already proves universal superiority
- the final mathematical packaging is already finished
- the hidden internal substrate is being publicly exposed here
@ -609,21 +693,21 @@ It should still remain disciplined.
---
# 🧡 Section 13 · A vibe-coder-friendly summary
# 🧡 Section 14 · A beginner-friendly summary
If you want the fast version:
### Twin Atlas today
Already a real engine direction.
Already a real engine direction with a real public stack.
### Twin Atlas next
Make the handoff more real.
Finish the remaining public support pages and make the handoff more real.
### Twin Atlas after that
Make the runtime more operational.
Make the runtime more operational and the proof surface stronger.
### Twin Atlas long-term
Push the structure toward stronger formalization.
Push the structure toward deeper formalization.
That is the roadmap in plain language.
@ -631,4 +715,4 @@ That is the roadmap in plain language.
# ✨ One-sentence takeaway
> Twin Atlas is already strong enough to exist as a real engine direction today, and the next major step is not inventing its identity, but deepening its coupling, runtime behavior, and long-term formalization.
> Twin Atlas is already strong enough to exist as a real engine direction today, and the next major step is not inventing its identity, but deepening its coupling, runtime behavior, and proof surfaces while keeping long-term formalization alive.