WFGY
WFGY is an open-source AI Troubleshooting Atlas for RAG, agents, and real-world AI workflows. Includes the 16-problem map, Global Debug Card, and WFGY 4.0. ⭐ Star to help more builders find this repo.
Install / Use
/learn @onestardao/WFGYREADME
WFGY · AI Troubleshooting Atlas
🆕 WFGY 4.0 temporary entry
WFGY 4.0 is now live as a temporary release surface.
A larger homepage update is coming soon.
- ⭐️ Twin Atlas
- ⭐️ Inverse Atlas
- ⭐️ AI Eval
- ⭐️ Reproduce in 60 Seconds
- ⭐️ Results Summary
Problem Map 3.0 by WFGY
The route-first troubleshooting surface for broken RAG, agent, and AI workflows.
Stop debugging from symptoms.
Route the failure, inspect the broken invariant, and take the right first repair move.
<p align="center"> <a href="https://github.com/onestardao/WFGY/blob/main/ProblemMap/wfgy-ai-problem-map-troubleshooting-atlas.md"> <img width="1536" height="557" alt="WFGY Atlas Banner" src="https://github.com/user-attachments/assets/bfa8830e-e091-4430-8f1b-1153cafc8081" /> </a> </p>
Trusted open-source support
<p align="center"> <a href="./ADOPTERS.md"> <img width="1536" alt="WFGY Trust Wall" src="https://github.com/user-attachments/assets/28e47e15-e287-4e7b-b0f5-4f3b4dfed178" /> </a> </p>Supported through selected open-source programs, sponsored plans, and infrastructure credits.
🔎 Who this is for
WFGY now leads with the AI Troubleshooting Atlas as its strongest practical entry point.
This is for people who need a better first repair move, not another prompt recipe.
- RAG and agent teams shipping real workloads that still hallucinate, drift, or collapse in edge cases.
- Infra and platform owners who need clearer routing across models, deployments, tenants, or evaluation surfaces.
- Evaluation and debugging teams who want a reproducible first-cut diagnosis before random patching begins.
- Vibe coders and builders who want a fast practical path from broken behavior to a structured first move.
- Founders, PMs, and domain experts carrying difficult AI workflows without a full troubleshooting grammar.
If you are not sure where to begin, start with the Atlas or the Global Debug Card.
⚡ Start here in 60 seconds
Choose the shortest practical path.
- ⭐️ Problem Map 3.0 Troubleshooting Atlas : full product overview and routing model.
- ⭐️ Atlas Router TXT Pack : upload it and route a real case fast.
- ⭐️ WFGY Global Debug Card : image-first triage for a failing run.
- ⭐️ Global Fix Map : cross-tool guardrails and common fix patterns.
- ⭐️ Atlas Hub : freeze notes, support docs, and structure.
- ⭐️ Router Usage Guide : quick guide for using the pack well.
- ⭐️ WFGY RAG 16 Problem Map : classic checklist for broken RAG flows.
🧭 Why this repo now leads with the Atlas
WFGY is a larger open-source reasoning and debugging ecosystem.
But this repository now leads with the AI Troubleshooting Atlas because it is the strongest practical entry for people facing real AI failures.
The Atlas is designed to help teams:
- identify the likely failure family
- locate the broken node
- inspect the broken invariant
- avoid the wrong first fix
- move from route to repair with more structure
In plain terms, the Atlas exists to stop teams from starting with the wrong fix.
📌 Public proof and ecosystem signals
If you want to see how the public WFGY ecosystem became externally legible, start here.
- ⭐️ Adopters : short summary of the strongest public integrations.
- ⭐️ Recognition Map : ecosystem ledger of integrations, references, citations, and mentions.
- ⭐️ Case Evidence : what those integrations imply in real systems.
- ⭐️ Evidence Timeline : historical timeline of how WFGY became public, usable, and externally legible.
- ⭐️ Ecosystem Map : canonical map of the public WFGY ecosystem.
🧪 Advanced layer
WFGY 3.0 · frontier reasoning and long-horizon evaluation
WFGY 3.0 remains the advanced reasoning and evaluation surface.
It is still part of the public stack, but it now sits behind the Atlas in homepage priority.
- ⭐️ WFGY 3.0 Singularity Demo : TXT-based reasoning surface for stress testing 131 S-class problems.
- ⭐️ Event Horizon Overview : overview of the WFGY 3.0 reasoning architecture.
- ⭐️ Experiments Index : current Tension Universe MVP experiment surfaces.
- ⭐️ Chronicles Index : story and narrative entry.
- ⭐️ Contribution Guide for TU MVPs : how to contribute new experiment surfaces.
120s quickstart
-
Download the TXT pack
WFGY 3.0 Singularity Demo -
Upload it to a strong LLM
Upload the TXT pack to a high-capability model.
Enable reasoning mode if the platform supports it. -
Boot the engine
Typerun, thengo, and follow the built-in console.
This note defines the required behavior for AI
Related Skills
node-connect
342.5kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
85.3kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
342.5kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
qqbot-media
342.5kQQBot 富媒体收发能力。使用 <qqmedia> 标签,系统根据文件扩展名自动识别类型(图片/语音/视频/文件)。
