| .. | ||
| benchmark-reruns | ||
| colab | ||
| json | ||
| prompts | ||
| reproduction-packs | ||
| workflows | ||
| README.md | ||
Community Fix Lab 🛠️
Problem Map 3.0 Troubleshooting Atlas
Community-contributed fixes, demos, and runnable assets
Quick links:
- Back to Official Fixes
- Back to Fixes Hub
- Back to Atlas landing page
- Back to AI Eval Evidence
- Back to Atlas Hub
- Open the Flagship Runnable Demo Pack
- Open Templates
- Get the Atlas Router TXT
This folder is the community extension layer for the Atlas Fixes system.
If the official layer gives the repair grammar, this page shows how the community can turn that grammar into more runnable, shareable, and reusable assets 🤝
The official atlas gives:
- routing
- first repair direction
- misrepair warnings
- bridge guidance into deeper WFGY exploration
This community layer gives:
- runnable examples
- Colab notebooks
- JSON fixtures
- prompt packs
- workflow recipes
- benchmark reruns
- reproduction packs
Short version:
official layer gives the grammar
community layer helps turn that grammar into more runnable artifacts
Quick start 🚀
I want to contribute
Use this path:
- pick the folder that matches your artifact
- read the required contribution docs
- build one small, clear, route-aware asset
- explain how to run it and what result to expect
- submit it in the right folder
I want to browse runnable assets
Use this path:
- choose the folder that matches what you want to inspect
- open one scoped contribution
- check the routing context
- inspect or run the artifact
- compare it against the official layer when useful
Short version:
route first
build one useful thing
explain it clearly ✨
Community quick map 🗂️
| Folder | Best for | Typical artifact |
|---|---|---|
| Colab | runnable demos | notebook walkthroughs and replay notebooks |
| JSON | structured fixtures | input cases, replay outputs, expected outputs |
| Prompts | route-aware prompt assets | repair prompts, escalation prompts, compact packs |
| Workflows | process recipes | step-by-step repair flows and troubleshooting sequences |
| Benchmark Reruns | comparison slices | before / after reruns and route-aware benchmark views |
| Reproduction Packs | portable reuse | one-case reproducible bundles |
What belongs here ✅
Good community contributions include things like:
- Colab demos
- JSON input and output fixtures
- prompt templates
- workflow repair recipes
- benchmark reruns
- reproduction packs
- domain-specific troubleshooting examples
A good contribution should be:
- readable
- scoped
- reproducible when possible
- clearly connected to atlas routing
- honest about limits
What does not belong here 🚫
Please do not use this folder for:
- random notes with no routing context
- files with no explanation
- giant dumps of logs without structure
- vague fix ideas with no case framing
- materials that claim to replace the official atlas core
- materials that pretend to be official without review
This folder should grow, but it should not become chaos.
Official vs community 🌉
Official fixes
Official fixes live in:
They are:
- smaller
- more stable
- more teachable
- more carefully reviewed
- part of the public official repair grammar
Community fixes
Community fixes live here.
They are:
- broader
- faster-growing
- more implementation-oriented
- more experimental
- often more domain-specific
Both matter.
The official layer keeps the system clean.
The community layer helps the system grow faster.
Folder layout 🧩
Suggested contribution areas:
Use the folder that best matches the artifact you are contributing.
If a contribution does not fit one of these clearly, add a short note explaining where it belongs and why.
What each folder is for 🔍
Colab
Use this folder for notebook-based demos, walkthroughs, replay notebooks, and small runnable teaching assets.
JSON
Use this folder for structured fixtures such as input cases, replay outputs, expected outputs, and compact machine-readable packs.
Prompts
Use this folder for route-aware prompt packs, repair prompts, and prompt-based troubleshooting assets.
Workflows
Use this folder for step-by-step repair sequences, escalation flows, and troubleshooting recipes.
Benchmark Reruns
Use this folder for compact reruns, before-and-after comparisons, and route-aware benchmark slices.
Reproduction Packs
Use this folder for portable bundles that help others quickly reproduce one case, one repair pattern, or one troubleshooting result.
Minimum contribution rule 📌
A community contribution should usually include five things:
- what case or family it relates to
- what problem it is trying to fix
- what artifact is included
- how to run or use it
- what result should be expected
That is enough to keep the contribution useful.
What a good first contribution looks like 🌱
A strong first contribution usually looks like this:
- one family
- one case
- one artifact
- one expected result
- one short explanation
Examples:
- one small Colab demo
- one clean JSON fixture pair
- one route-aware prompt example
- one short workflow recipe
- one simple reproduction pack
Small, clean, scoped contributions are much better than giant messy ones.
Suggested contribution flow 🧪
A simple contribution flow should look like this:
Step 1
Route the case with the atlas first.
Step 2
Identify the relevant family or best current fit.
Step 3
Create one useful artifact:
- notebook
- JSON pack
- prompt pack
- workflow recipe
- reproduction pack
Step 4
Document:
- the case
- the fix idea
- how to use it
- what outcome to expect
Step 5
Submit it in the right folder.
Short version:
route first
build one useful thing
explain it clearly 🧭
Before contributing 📚
Must read
Please read these first:
Good to read
These are highly recommended if you want stronger alignment:
This keeps community work aligned with the atlas instead of drifting away from it.
Good first contributions 🌟
If you want an easy first contribution, start with one of these:
- one small Colab demo
- one clean JSON fixture pair
- one prompt-based repair example
- one short workflow recipe
- one benchmark rerun example
- one short reproduction pack
Small, clear contributions are much better than giant messy ones.
Relationship to WFGY 3.0 🌊
This folder can connect to WFGY 3.0, but it is not the same as the WFGY engine layer.
A community contribution may:
- use WFGY 3.0 prompts
- demonstrate a deeper exploration path
- compare first repair versus deeper WFGY escalation
But it should still explain clearly:
- what the atlas routing was
- what the first repair move was
- what the deeper WFGY step added
That keeps the bridge clean.
Review standard ✅
A community contribution is much more likely to be accepted if it is:
- clearly named
- easy to read
- easy to run
- connected to atlas routing
- explicit about expected output
- honest about limitations
Messy power is still messy.
Clean small contributions are more valuable.
Growth rule 🌱
This folder should grow through structured additions, not through random accumulation.
That means:
- route first
- place the artifact in the right folder
- explain what it does
- state what it does not do
- keep the distinction between official and community layers clear
Structured growth is the goal.
Next steps ✨
After this page, most readers continue with:
- Open Templates
- Back to Official Fixes
- Open the Flagship Runnable Demo Pack
- Choose a folder and start small
If you want to return to the broader product surface:
If this layer helps your workflow, consider:
- starring the WFGY repo
- opening an issue
- contributing one small clean asset
- helping keep the community layer structured 💡
One-line status
This folder is the community extension layer for Atlas Fixes, where contributors turn repair grammar into runnable assets.
Closing note 🌍
The atlas should not grow only through one author.
This folder exists so the community can help build:
- runnable fixes
- better demos
- reusable assets
- real workflow support
The goal is not random growth.
The goal is structured growth.