vrr/WFGY
2
0
Fork 0
mirror of https://github.com/onestardao/WFGY.git synced 2026-05-01 21:11:11 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Update README.md

Browse source
This commit is contained in:
PSBigBig + MiniPS 2026-03-20 14:04:03 +08:00 • committed by GitHub
parent 34b0c69062
commit 8ef2872f1c
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 348 additions and 48 deletions
Download patch file Download diff file Expand all files Collapse all files

396
ProblemMap/Atlas/README.md
View file

@ -6,7 +6,7 @@ This page is the main hub and navigation index for the Atlas folder.
How to use this page:
1. Treat this page as the central entry point for Atlas system documents.
2. Use this page to understand document roles, reading order, freeze status, patch status, and current product-facing extensions.
2. Use this page to understand document roles, reading order, freeze status, patch status, product-facing assets, and planned public expansion.
3. Do not confuse this hub with the product-facing main page.
4. The product-facing main page is:
ProblemMap/wfgy-ai-problem-map-troubleshooting-atlas.md
@ -15,7 +15,8 @@ What this page is:
- A folder-level Atlas hub
- A document map
- A stable navigation layer for humans and AI systems
- A bridge between product-facing, engineering-facing, teaching-facing, router-facing, and repair-facing assets
- A bridge between product-facing, engineering-facing, teaching-facing, router-facing, repair-facing, evidence-facing, and bridge-facing assets
- A control room for current Atlas status and planned public decomposition
What this page is not:
- Not the public homepage
@ -25,22 +26,29 @@ What this page is not:
- Not the full patch log
- Not the internal validation ledger
- Not the full fix manual
- Not the full family or boundary expansion layer
- Not the router TXT pack itself
Reading discipline for AI:
- Preserve the distinction between atlas core, negative space, handoff, casebook, adapter, router, patch, bridge, provenance, validation, and fix layers.
- Preserve the distinction between atlas core, negative space, handoff, casebook, adapter, router, evidence, demo, patch, bridge, provenance, validation, and fix layers.
- Respect frozen terms and patch discipline.
- Do not silently merge work-branches into frozen structures.
- Do not treat planned public expansion pages as already frozen unless explicitly marked.
- Use linked documents according to their intended role.
Routing guidance:
- For product overview, go to the main product page first.
- For stable atlas structure, go to Atlas Final Freeze v1.
- For limits and safe expansion, go to Negative Space Report v1.
- For teaching and examples, go to Canonical Casebook v1.
- For AI-facing routing logic, go to Atlas-to-AI Adapter v1.
- For compact TXT routing, go to Troubleshooting Atlas Router v1 TXT Pack and Usage Guide.
- For repair-facing materials, go to the Fixes folder.
- For cross-domain bridge evidence, go to Cross-Domain Freeze Note v2 and Civilization Bridge Modules v1.
Relationship to neighboring docs:
- Read the main product page first if you need the public-facing overview.
- Read Atlas Final Freeze v1 for the stable atlas body.
- Read Atlas Negative Space Report v1 for limits and safe extension boundaries.
- Read Atlas-to-AI Adapter v1 and router materials for model-facing routing logic.
- Read Fixes Hub for repair-facing follow-through after routing.
- Read evidence and demo packs for proof surface.
- Read bridge, validation, and provenance documents for deeper structural justification.
Freeze / patch status:
- Current status: stable hub with controlled expansion planning
- Safe to quote as: the official Atlas folder map and control room
- Not a claim of: full subtree closure or fully enumerated public decomposition
AI_NOTE_END
-->
@ -48,7 +56,7 @@ AI_NOTE_END
# Atlas Hub ⭐️
## Problem Map 3.0 Troubleshooting Atlas
> Quick start, folder index, freeze map, and system control room
> Quick start, folder index, freeze map, system topology, and Atlas control room
This folder is the structured vault for the Atlas system.
@ -65,13 +73,14 @@ Its job is simple:
- show what role each document plays
- show what is already frozen
- show what is patch-driven
- show what is bridge-facing, router-facing, or repair-facing
- show what is bridge-facing, router-facing, evidence-facing, or repair-facing
- show what public expansion is planned next
- help humans and AI systems enter the Atlas without getting lost
In short:
> the main product page introduces the atlas
> this hub shows how the Atlas folder is organized, frozen, extended, and used
> this hub shows how the Atlas folder is organized, frozen, extended, evidenced, and used
---
@ -83,6 +92,7 @@ Start with the compact router first:
- **Download the TXT immediately:** [Troubleshooting Atlas Router v1 TXT Pack](./troubleshooting-atlas-router-v1.txt)
- **See the fastest way to use it:** [Troubleshooting Atlas Router v1 Usage Guide](./troubleshooting-atlas-router-v1-usage.md)
- **See the router freeze context:** [Troubleshooting Atlas Router v1 Freeze Note](./troubleshooting-atlas-router-v1-freeze-note.md)
- **See the main product overview:** [Problem Map 3.0 Troubleshooting Atlas](../wfgy-ai-problem-map-troubleshooting-atlas.md)
Short version:
@ -91,24 +101,97 @@ Short version:
---
## Atlas system topology 🗺️
The Atlas should be read as a layered system, not as a flat pile of markdown files.
### Layer 1 · public entry
This is where a new reader first understands what the Atlas is.
- [Problem Map 3.0 Troubleshooting Atlas](../wfgy-ai-problem-map-troubleshooting-atlas.md)
### Layer 2 · hub and navigation
This is where the folder becomes navigable as a system.
- [Atlas Hub](./README.md)
### Layer 3 · frozen core and limits
This is where the stable mother structure and its explicit boundaries live.
- [Atlas Final Freeze v1](./atlas-final-freeze-v1.md)
- [Atlas Negative Space Report v1](./atlas-negative-space-report-v1.md)
- [Atlas v1 Integrated Handoff](./atlas-v1-integrated-handoff.md)
### Layer 4 · teaching and interpretation
This is where the system becomes easier to teach, explain, and onboard.
- [Canonical Casebook v1](./canonical-casebook-v1.md)
- [Tiny Planner Output Examples Pack v1](./tiny-planner-output-examples-pack-v1.md)
### Layer 5 · AI adapter and compact routing
This is where atlas logic becomes model-facing and executable in compact form.
- [Atlas-to-AI Adapter v1](./atlas-to-ai-adapter-v1.md)
- [Adapter Runtime Modes v1](./adapter-runtime-modes-v1.md)
- [Adapter Failure Discipline v1](./adapter-failure-discipline-v1.md)
- [Troubleshooting Atlas Router v1 TXT Pack](./troubleshooting-atlas-router-v1.txt)
- [Troubleshooting Atlas Router v1 Usage Guide](./troubleshooting-atlas-router-v1-usage.md)
- [Troubleshooting Atlas Router v1 Freeze Note](./troubleshooting-atlas-router-v1-freeze-note.md)
### Layer 6 · repair, demos, and evidence
This is where route-first logic is connected to proof, examples, and repair direction.
- [Fixes Hub](./Fixes/README.md)
- [AI Eval Evidence](./ai-eval-evidence.md)
- [Cross-Domain Demonstration Pack v2](./cross-domain-demonstration-pack-v2.md)
### Layer 7 · governance, validation, and bridge
This is where controlled growth, validation basis, provenance, and bridge framing live.
- [Patch Wave 2 Freeze Note v1](./patch-wave-2-freeze-note-v1.md)
- [Patch Governance v1](./patch-governance-v1.md)
- [Release and Freeze Policy v1](./release-and-freeze-policy-v1.md)
- [Validation Basis v1](./validation-basis-v1.md)
- [Provenance and Derivation v1](./provenance-and-derivation-v1.md)
- [Cross-Domain Freeze Note v2](./cross-domain-freeze-note-v2.md)
- [Civilization Bridge Modules v1](./civilization-bridge-modules-v1.md)
### Layer 8 · planned public decomposition
This is where the next public structure will be expanded without silently rewriting the frozen core.
- family mini-specs
- boundary decision guides
- subtree expansion index
- fit registry
- first-fix and misrepair discipline
- evidence and confidence discipline
- routing output contract
- overlay discipline
- promotion thresholds
- structure map
---
## Choose your entry path 🧭
| What you want | Go here | Level |
|---|---|---|
| Try the compact router immediately | [Troubleshooting Atlas Router v1 TXT Pack](./troubleshooting-atlas-router-v1.txt) | 🟢 Beginner |
| See the fastest practical usage path | [Troubleshooting Atlas Router v1 Usage Guide](./troubleshooting-atlas-router-v1-usage.md) | 🟢 Beginner |
| See the router freeze context | [Troubleshooting Atlas Router v1 Freeze Note](./troubleshooting-atlas-router-v1-freeze-note.md) | 🟢 Beginner |
| Understand the product first | [Problem Map 3.0 Troubleshooting Atlas](../wfgy-ai-problem-map-troubleshooting-atlas.md) | 🟢 Beginner |
| See proof and examples | [Canonical Casebook v1](./canonical-casebook-v1.md) · [Fixes Hub](./Fixes/README.md) | 🟡 Builder |
| See proof and examples | [Canonical Casebook v1](./canonical-casebook-v1.md) · [AI Eval Evidence](./ai-eval-evidence.md) · [Cross-Domain Demonstration Pack v2](./cross-domain-demonstration-pack-v2.md) · [Fixes Hub](./Fixes/README.md) | 🟡 Builder |
| Understand the stable Atlas core | [Atlas Final Freeze v1](./atlas-final-freeze-v1.md) | 🟡 Builder |
| Understand AI-facing routing logic | [Atlas-to-AI Adapter v1](./atlas-to-ai-adapter-v1.md) | 🟡 Builder |
| Understand bridge, provenance, and derivation | [Cross-Domain Freeze Note v2](./cross-domain-freeze-note-v2.md) · [Civilization Bridge Modules v1](./civilization-bridge-modules-v1.md) · [Provenance and Derivation v1](./provenance-and-derivation-v1.md) | 🟠 Research |
| Understand patch and release discipline | [Patch Governance v1](./patch-governance-v1.md) · [Release and Freeze Policy v1](./release-and-freeze-policy-v1.md) | 🟠 Research |
| Understand bridge, provenance, and derivation | [Cross-Domain Freeze Note v2](./cross-domain-freeze-note-v2.md) · [Civilization Bridge Modules v1](./civilization-bridge-modules-v1.md) · [Validation Basis v1](./validation-basis-v1.md) · [Provenance and Derivation v1](./provenance-and-derivation-v1.md) | 🟠 Research |
| Understand patch and release discipline | [Patch Governance v1](./patch-governance-v1.md) · [Release and Freeze Policy v1](./release-and-freeze-policy-v1.md) · [Patch Wave 2 Freeze Note v1](./patch-wave-2-freeze-note-v1.md) | 🟠 Research |
| Understand what public expansion comes next | [Planned Public Expansion Files](#planned-public-expansion-files-%EF%B8%8F) | 🟠 Research |
> tip: if you are new, start with the TXT pack or the Usage Guide. the rest of the stack can be explored later.
---
## Current status
## Current status 📌
The current Atlas system should be read as a multi-layer structure with a stable first formal release and multiple formal post-freeze extensions.
@ -125,7 +208,10 @@ At the moment, the following major assets are already established:
- first formal cross-domain bridge layer
- provenance and validation layer
- fix and repair-facing layer
- AI eval evidence layer
- demo and example layer
- first compact TXT router product layer
- first router freeze note layer
This means the project is no longer in the stage of “trying to find the core.”
@ -138,12 +224,15 @@ It is now in the stage of:
- AI-facing reuse
- router deployment
- repair-surface thickening
- evidence strengthening
- demo expansion
- bridge expansion
- provenance strengthening
- public decomposition
---
## Recommended reading order
## Recommended reading order 📚
Different readers need different entry paths.
@ -152,7 +241,8 @@ Different readers need different entry paths.
1. [Problem Map 3.0 Troubleshooting Atlas](../wfgy-ai-problem-map-troubleshooting-atlas.md)
2. [Troubleshooting Atlas Router v1 TXT Pack](./troubleshooting-atlas-router-v1.txt)
3. [Troubleshooting Atlas Router v1 Usage Guide](./troubleshooting-atlas-router-v1-usage.md)
4. [Atlas Final Freeze v1](./atlas-final-freeze-v1.md)
4. [Troubleshooting Atlas Router v1 Freeze Note](./troubleshooting-atlas-router-v1-freeze-note.md)
5. [Atlas Final Freeze v1](./atlas-final-freeze-v1.md)
Use this path if you want the shortest route from “what is this” to “how do I try it quickly.”
@ -170,9 +260,10 @@ Use this path if you want the frozen core, its limits, and the formal rules for
### Path C · teaching / onboarding reader
1. [Canonical Casebook v1](./canonical-casebook-v1.md)
2. [Atlas Final Freeze v1](./atlas-final-freeze-v1.md)
3. [Cross-Domain Freeze Note v2](./cross-domain-freeze-note-v2.md)
4. [Fixes Hub](./Fixes/README.md)
2. [Tiny Planner Output Examples Pack v1](./tiny-planner-output-examples-pack-v1.md)
3. [Atlas Final Freeze v1](./atlas-final-freeze-v1.md)
4. [Cross-Domain Demonstration Pack v2](./cross-domain-demonstration-pack-v2.md)
5. [Fixes Hub](./Fixes/README.md)
Use this path if you want to teach, explain, demo, or onboard new readers.
@ -181,17 +272,20 @@ Use this path if you want to teach, explain, demo, or onboard new readers.
1. [Atlas-to-AI Adapter v1](./atlas-to-ai-adapter-v1.md)
2. [Adapter Runtime Modes v1](./adapter-runtime-modes-v1.md)
3. [Adapter Failure Discipline v1](./adapter-failure-discipline-v1.md)
4. [Troubleshooting Atlas Router v1 Usage Guide](./troubleshooting-atlas-router-v1-usage.md)
5. [Troubleshooting Atlas Router v1 TXT Pack](./troubleshooting-atlas-router-v1.txt)
4. [Troubleshooting Atlas Router v1 Freeze Note](./troubleshooting-atlas-router-v1-freeze-note.md)
5. [Troubleshooting Atlas Router v1 Usage Guide](./troubleshooting-atlas-router-v1-usage.md)
6. [Troubleshooting Atlas Router v1 TXT Pack](./troubleshooting-atlas-router-v1.txt)
Use this path if you want the AI-facing routing layer in both full-spec and compact TXT product form.
### Path E · repair / execution reader
1. [Fixes Hub](./Fixes/README.md)
2. [Atlas-to-AI Adapter v1](./atlas-to-ai-adapter-v1.md)
3. [Troubleshooting Atlas Router v1 Usage Guide](./troubleshooting-atlas-router-v1-usage.md)
4. [Atlas Final Freeze v1](./atlas-final-freeze-v1.md)
2. [AI Eval Evidence](./ai-eval-evidence.md)
3. [Cross-Domain Demonstration Pack v2](./cross-domain-demonstration-pack-v2.md)
4. [Atlas-to-AI Adapter v1](./atlas-to-ai-adapter-v1.md)
5. [Troubleshooting Atlas Router v1 Usage Guide](./troubleshooting-atlas-router-v1-usage.md)
6. [Atlas Final Freeze v1](./atlas-final-freeze-v1.md)
Use this path if you want to connect routing to first repair direction and deeper repair-facing work.
@ -201,12 +295,23 @@ Use this path if you want to connect routing to first repair direction and deepe
2. [Civilization Bridge Modules v1](./civilization-bridge-modules-v1.md)
3. [Validation Basis v1](./validation-basis-v1.md)
4. [Provenance and Derivation v1](./provenance-and-derivation-v1.md)
5. [AI Eval Evidence](./ai-eval-evidence.md)
Use this path if you want the strongest current account of why the atlas exists, how it was carved, and how it bridges beyond the AI-first domain.
### Path G · proof / evidence / demos reader
1. [AI Eval Evidence](./ai-eval-evidence.md)
2. [Cross-Domain Demonstration Pack v2](./cross-domain-demonstration-pack-v2.md)
3. [Canonical Casebook v1](./canonical-casebook-v1.md)
4. [Tiny Planner Output Examples Pack v1](./tiny-planner-output-examples-pack-v1.md)
5. [Fixes Hub](./Fixes/README.md)
Use this path if you want the clearest public proof surface for the route-first claim.
---
## Folder map
## Folder map 🧱
This folder is organized around several major document families.
@ -236,6 +341,10 @@ These teach how to actually use the atlas.
The first formal teaching layer.
Includes family anchor cases, boundary teaching cases, and repair teaching cases.
- [Tiny Planner Output Examples Pack v1](./tiny-planner-output-examples-pack-v1.md)
A compact example pack.
Helps readers see shorter output shapes, response patterns, and practical output expectations.
---
### 3. AI-facing adapter documents
@ -268,6 +377,10 @@ These turn the Atlas routing grammar into a compact TXT product.
The practical usage guide.
Explains how to use the Router, what kind of input it needs, and how to interpret its output.
- [Troubleshooting Atlas Router v1 Freeze Note](./troubleshooting-atlas-router-v1-freeze-note.md)
The router freeze context page.
Explains the formal freeze position, intended scope, and safe reading posture for Router v1.
- Full router discipline and routing logic currently live in:
- [Atlas-to-AI Adapter v1](./atlas-to-ai-adapter-v1.md)
- [Adapter Runtime Modes v1](./adapter-runtime-modes-v1.md)
@ -275,7 +388,21 @@ These turn the Atlas routing grammar into a compact TXT product.
---
### 5. Patch and governance documents
### 5. Evidence and demonstration documents
These support the route-first claim with proof surface, demos, and directional evidence.
- [AI Eval Evidence](./ai-eval-evidence.md)
The evidence-facing layer.
Summarizes model-facing directional evidence for route-first behavior.
- [Cross-Domain Demonstration Pack v2](./cross-domain-demonstration-pack-v2.md)
The current demonstration pack.
Shows how routing logic and first-repair direction remain meaningful across multiple pressure surfaces.
---
### 6. Patch and governance documents
These define how the atlas grows without silently mutating the core.
@ -290,7 +417,7 @@ These define how the atlas grows without silently mutating the core.
---
### 6. Cross-domain bridge documents
### 7. Cross-domain bridge documents
These show how the atlas extends beyond narrow AI-only reading.
@ -303,7 +430,7 @@ These show how the atlas extends beyond narrow AI-only reading.
---
### 7. Validation and provenance documents
### 8. Validation and provenance documents
These explain where the mother structure came from and why it should be trusted.
@ -316,7 +443,7 @@ These explain where the mother structure came from and why it should be trusted.
---
### 8. Fix and repair-facing documents
### 9. Fix and repair-facing documents
These connect atlas diagnosis to first repair direction and deeper repair work.
@ -326,7 +453,71 @@ These connect atlas diagnosis to first repair direction and deeper repair work.
---
## What is already frozen
### 10. Planned public decomposition documents
These are the next public structure pages to be written so the middle layer between frozen core and compact router becomes easier to study.
- `atlas-structure-map-v1.md`
- `atlas-family-mini-specs-v1.md`
- `atlas-boundary-decision-guide-v1.md`
- `atlas-subtree-expansion-index-v1.md`
- `atlas-fit-candidate-registry-v1.md`
- `atlas-first-fix-and-misrepair-discipline-v1.md`
- `atlas-evidence-and-confidence-discipline-v1.md`
- `atlas-routing-output-contract-v1.md`
- `atlas-overlay-and-secondary-family-discipline-v1.md`
- `atlas-promotion-and-patch-thresholds-v1.md`
These planned pages are **public decomposition pages**, not silent rewrites of the frozen atlas core.
---
## Existing assets already in this folder but easy to miss 📦
Some files are already present in this folder and should be treated as part of the current public surface, even if they were easy to overlook in earlier navigation:
- [AI Eval Evidence](./ai-eval-evidence.md)
- [Cross-Domain Demonstration Pack v2](./cross-domain-demonstration-pack-v2.md)
- [Tiny Planner Output Examples Pack v1](./tiny-planner-output-examples-pack-v1.md)
- [Troubleshooting Atlas Router v1 Freeze Note](./troubleshooting-atlas-router-v1-freeze-note.md)
These matter because they strengthen:
- evidence
- demo clarity
- compact output expectations
- router freeze readability
---
## Document status matrix 📊
| Document / Layer | Current role | Status |
|---|---|---|
| Main product page | Public entry | Stable |
| Atlas Hub | Folder control room | Stable |
| Atlas Final Freeze v1 | Core atlas body | Frozen |
| Atlas Negative Space Report v1 | Boundary and limits | Frozen |
| Atlas v1 Integrated Handoff | Core reading bridge | Stable support |
| Canonical Casebook v1 | Teaching layer | Frozen first body |
| Tiny Planner Output Examples Pack v1 | Compact examples | Stable support |
| Atlas-to-AI Adapter v1 | Full routing adapter | Frozen first body |
| Adapter Runtime Modes v1 | Runtime discipline | Frozen first body |
| Adapter Failure Discipline v1 | Failure discipline | Frozen first body |
| Router TXT Pack | Compact routing surface | Frozen first body |
| Router Usage Guide | Practical quick-start | Stable support |
| Router Freeze Note | Router scope and freeze posture | Stable support |
| AI Eval Evidence | Evidence surface | Active evidence layer |
| Cross-Domain Demonstration Pack v2 | Demo surface | Active demo layer |
| Fixes Hub | Repair-facing entry | Stable support |
| Patch / Release docs | Governance layer | Frozen first body |
| Validation / Provenance docs | Justification layer | Stable support |
| Cross-domain bridge docs | Bridge layer | Frozen first bridge body |
| Planned public decomposition docs | Public middle-layer expansion | Planned |
---
## What is already frozen 🧊
The following can now be treated as stable first-version assets.
@ -384,7 +575,7 @@ The following can now be treated as stable first-version assets.
---
## What is intentionally not fully frozen
## What is intentionally not fully frozen 🌱
The system is stable, but not fully closed.
@ -400,6 +591,9 @@ The following areas remain intentionally open or patch-sensitive:
- deeper auto-repair planning layers
- later router patches and future router variants
- stronger bridge-to-civilization packaging
- public family mini-spec decomposition
- public boundary decision decomposition
- public fit registry and promotion threshold pages
This is not a weakness.
It is part of the Atlas design discipline.
@ -412,7 +606,97 @@ The current project is meant to be:
---
## Cross-domain and civilization bridge direction
## Atlas writing contract 🧩
New Atlas pages should follow a shared writing contract.
### Required top block
Every new page should start with:
- an `AI_NOTE_START` block
- document role
- how to use this page
- what this page is
- what this page is not
- reading discipline for AI
- relationship to neighboring docs
- freeze / patch status
### Required title style
- every page should have an H1 title
- the H1 title should include an emoji
- every page should include a one-line subtitle
- the first paragraph should make the page role immediately clear
### Required structure
Most new Atlas pages should try to include:
- why this page exists
- scope
- what this page covers
- what this page does not cover
- core structure
- practical use
- relation to other Atlas docs
- current status
- future extension
- closing note
### Discipline rules
Future writing should not:
- silently change frozen language
- flatten core and support layers into one level
- overclaim proof
- imply full closure when the page is only a public decomposition layer
- confuse compact router behavior with full auto-repair behavior
---
## Planned public expansion files 🛠️
These filenames are now fixed for the next public expansion wave.
### Priority P0
- `atlas-structure-map-v1.md`
- `atlas-family-mini-specs-v1.md`
- `atlas-boundary-decision-guide-v1.md`
- `atlas-subtree-expansion-index-v1.md`
### Priority P1
- `atlas-fit-candidate-registry-v1.md`
- `atlas-first-fix-and-misrepair-discipline-v1.md`
- `atlas-evidence-and-confidence-discipline-v1.md`
### Priority P2
- `atlas-routing-output-contract-v1.md`
- `atlas-overlay-and-secondary-family-discipline-v1.md`
- `atlas-promotion-and-patch-thresholds-v1.md`
These files should be understood as:
- clarification
- expansion
- public decomposition
- middle-layer readability improvement
They should **not** be understood as:
- silent rewrites
- retroactive core mutation
- fake closure
- rhetorical inflation
---
## Cross-domain and civilization bridge direction 🌍
This atlas is currently grounded in AI troubleshooting, routing, teaching, repair-first workflows, and AI-facing routing products.
@ -434,24 +718,25 @@ This should be read as a **formal bridge layer**, not as a claim of universal en
---
## What future work should not do
## What future work should not do ⛔
Future work should not:
- silently rewrite frozen structures
- promote branches by rhetoric alone
- flatten family, node, subtree, bridge, router, and overlay into one level
- flatten family, node, subtree, bridge, router, overlay, and repair into one level
- confuse patching with core instability
- overstate bridge evidence as universal closure
- erase the distinction between core docs, product assets, and support documents
- pretend Router v1 is already a full repair engine
- collapse the difference between route-first repair and full auto-repair
- treat planned public decomposition pages as equivalent to frozen core pages before they earn that status
These rules matter because the atlas is now a versioned system, not a floating concept.
---
## What future work should do
## What future work should do ✅
The highest-value next directions are:
@ -464,6 +749,12 @@ Test and patch compact route-first TXT behavior through explicit versioning.
### Demo expansion
Build cleaner human-facing and AI-facing demos.
### Evidence strengthening
Keep the public proof surface legible for people who do not want to read the entire freeze stack.
### Public decomposition
Expand the family, boundary, subtree, fit, and contract layer into navigable public docs.
### Cross-domain bridge expansion
Extend the atlas carefully beyond AI-first troubleshooting without overclaiming total completion.
@ -475,18 +766,18 @@ Continue strengthening the system through explicit patch nodes rather than silen
---
## Official wording
## Official wording 🏷️
When describing the current system in a new window, collaboration thread, or product workflow, use wording like this:
> Problem Map 3.0 Troubleshooting Atlas now has a frozen first body of core atlas documents, a canonical teaching layer, an AI-facing routing adapter, a repair-facing fix layer, a formal patch-governance layer, a first cross-domain bridge layer, and a compact TXT routing product in Troubleshooting Atlas Router v1.
> Future work proceeds through patching, thickening, productization, router refinement, and controlled bridge expansion.
> Problem Map 3.0 Troubleshooting Atlas now has a frozen first body of core atlas documents, a canonical teaching layer, an AI-facing routing adapter, a repair-facing fix layer, a formal patch-governance layer, an evidence and demo surface, a first cross-domain bridge layer, and a compact TXT routing product in Troubleshooting Atlas Router v1.
> Future work proceeds through patching, thickening, productization, router refinement, evidence strengthening, public decomposition, and controlled bridge expansion.
This wording is strong, accurate, and safe.
---
## Practical usage guide
## Practical usage guide ⚙️
### For product work
Start with:
@ -496,6 +787,7 @@ Start with:
Start with:
- [Troubleshooting Atlas Router v1 TXT Pack](./troubleshooting-atlas-router-v1.txt)
- [Troubleshooting Atlas Router v1 Usage Guide](./troubleshooting-atlas-router-v1-usage.md)
- [Troubleshooting Atlas Router v1 Freeze Note](./troubleshooting-atlas-router-v1-freeze-note.md)
### For system and routing work
Start with:
@ -506,12 +798,20 @@ Start with:
### For teaching and onboarding
Start with:
- [Canonical Casebook v1](./canonical-casebook-v1.md)
- [Tiny Planner Output Examples Pack v1](./tiny-planner-output-examples-pack-v1.md)
- [Fixes Hub](./Fixes/README.md)
### For proof and demos
Start with:
- [AI Eval Evidence](./ai-eval-evidence.md)
- [Cross-Domain Demonstration Pack v2](./cross-domain-demonstration-pack-v2.md)
- [Fixes Hub](./Fixes/README.md)
### For repair and execution work
Start with:
- [Fixes Hub](./Fixes/README.md)
- [Troubleshooting Atlas Router v1 Usage Guide](./troubleshooting-atlas-router-v1-usage.md)
- [AI Eval Evidence](./ai-eval-evidence.md)
### For bridge and provenance framing
Start with:
@ -528,18 +828,18 @@ Start with:
---
## One-line status
## One-line status 📍
**The Atlas core is frozen, the teaching layer exists, the AI adapter exists, the governance layer exists, the first cross-domain bridge exists, the repair-facing layer exists, and Troubleshooting Atlas Router v1 now exists as a formal compact TXT routing product. Further work proceeds in patch mode and controlled bridge expansion.**
**The Atlas core is frozen, the teaching layer exists, the AI adapter exists, the governance layer exists, the first cross-domain bridge exists, the repair-facing layer exists, the evidence and demo surface exists, and Troubleshooting Atlas Router v1 now exists as a formal compact TXT routing product. Further work proceeds in patch mode, public decomposition, and controlled bridge expansion.**
---
## Closing note
## Closing note 🔭
This folder is where the Atlas becomes a real system.
The main page tells you what the product is.
This hub tells you how the system is organized.
The linked documents tell you how to use it, teach it, extend it, connect it to repair-facing workflows, deploy it in compact TXT form, and bridge it toward broader complex-system reasoning.
The linked documents tell you how to use it, teach it, evaluate it, extend it, connect it to repair-facing workflows, deploy it in compact TXT form, and bridge it toward broader complex-system reasoning.
If the main product page is the front gate, this folder is the control room.