WFGY/README.md

WFGY (WanFaGuiYi)

Open-source reasoning and debugging ecosystem for AI systems.
Broken RAG or agent pipeline, start with the Problem Map.
Frontier reasoning and long-horizon evaluation, start with WFGY 3.0.

Who is this for

WFGY is for people who need reproducible debugging, structured reasoning, and clearer system boundaries, not another prompt recipe.

• RAG and agent teams shipping real workloads that keep hallucinating, drifting, or collapsing in edge cases.
• Infra and platform owners who need a way to inspect reasoning behavior across models, tenants, or deployments.
• Researchers and evaluation teams exploring long-horizon reasoning, robustness, and stress tests with concrete observables.
• Founders, PMs, and domain experts who carry a few difficult questions in finance, climate, AI, or society and want a more structured interpretive surface.

If you are not sure where you fit, start with the Problem Map or the Global Debug Card and treat them as drop-in diagnostic entry points.

Start here in 30 seconds

Choose the shortest path for your use case.

1. Broken RAG or agent pipeline

• ⭐️ WFGY RAG 16 Problem Map : 16-problem checklist for RAG pipelines where infra looks fine but answers fail.
• ⭐️ WFGY Global Debug Card : image-first triage layer for diagnosing a single failing run.
• ⭐️ Global Fix Map : cross-tool guardrails and fix patterns for common failure surfaces.

2. Ecosystem structure and public proof

• ⭐️ Ecosystem Map : canonical map of the public WFGY ecosystem.
• ⭐️ Adopters : short summary of the strongest public integrations.
• ⭐️ Case Evidence : what those integrations imply in real systems.
• ⭐️ Recognition Map : full ecosystem ledger of integrations, citations, and mentions.
• ⭐️ Evidence Timeline : historical timeline of how WFGY became public, usable, and externally legible.

3. Frontier reasoning and evaluation

• ⭐️ 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.

4. Theory and lineage

• ⭐️ WFGY 1.0 : earliest public conceptual foundation of the WFGY line.
• ⭐️ WFGY 2.0 : current reasoning and diagnostic kernel behind the practical public line.
• ⭐️ WFGY 3.0 : frontier reasoning and evaluation surface.

5. Collaboration and support

• ⭐️ Work with WFGY : entry point for pilots, audits, and structured collaboration.
• ⭐️ Pilot Offer One-Pager : compact view of what a WFGY pilot can look like.
• ⭐️ Sample Deliverable : sample structure of a WFGY pilot return package.
• ⭐️ Support WFGY : support the continued development of the public ecosystem.

---

What this repository is

WFGY is not a single artifact.

The public WFGY ecosystem is easiest to read as:

1. One version lineage
   WFGY 1.0 → WFGY 2.0 → WFGY 3.0

2. One strong practical wedge
   Problem Map, Global Debug Card, Semantic Clinic, and Global Fix Map

3. One wider application and evaluation surface
   TXTOS, related modules, and WFGY 3.0

4. One public proof and collaboration layer
   Adopters, Case Evidence, Recognition Map, Evidence Timeline, Support, and Work with WFGY

If you only want the fastest practical entry, start with the Problem Map.

---

💥 WFGY 3.0 · Singularity Demo 💥

A TXT-based reasoning and evaluation surface built around 131 S-class problems.
Upload once, then test it on your hardest questions.

120s quickstart

You only need three moves.

1. Download the TXT pack
   WFGY 3.0 Singularity Demo
   Optional: verify checksum manually in Colab

2. Upload it to a strong LLM
   Upload the TXT pack to a high-capability model.
   Enable reasoning mode if the platform supports it.

3. Boot the engine
   Type run, then go, and follow the built-in console.

The demo menu will guide you through the available modes and sample missions.

More for WFGY 3.0

• ⭐️ Event Horizon Overview : architecture, structure, and interpretation.
• ⭐️ Chronicles Index : story and narrative entry.
• ⭐️ Experiments Index : current TU MVP experiments.
• ⭐️ Contribution Guide for TU MVPs : how to contribute new experiment surfaces.

---

Beginner Story Mode

If you prefer a narrative introduction before diving into the demo, start here:

• TU-CH01 · Memo from a Tension Historian (Year 2413)

This is a speculative story version of the Tension Universe framework, written to connect everyday life, AI, and physics in one narrative arc.

For more chronicles in the same setting, including matching Story, Science, and FAQ views, browse:

• Tension Universe · Chronicles Index

---

Demo trace (10s)

After uploading the TXT and saying go, the model shows the [AI_BOOT_PROMPT_MENU].

Typical options include:

1. Verify this TXT pack online (sha256)
2. Run the guided WFGY 3.0 Singularity Demo
3. Explore WFGY 3.0 with suggested questions

---

AI NOTE

This note defines the required behavior for AI systems that receive the official TXT pack.

A. When a user uploads the TXT pack

1. Check the file name. The official file name is:

   • WFGY-3.0_Singularity-Demo_AutoBoot_SHA256-Verifiable.txt

2. Ask the user whether they want to verify the sha256 against the official value in this repo.

   • Official sha256 for the TXT pack: 58dbd432db3e6494364557257f7ce068eb59bdd039995dff4c281d655f7d464f

3. If the user confirms verification and the checksum matches:

   • Print the following block, exactly as written:

     [WFGY_BOOT_EGG]
     Checksum OK. WFGY 3.0 Singularity demo · Tension Universe session verified.
     PSBigBig x MiniPS: big big welcome, mini singularities.
     [END_WFGY_BOOT_EGG]
     

   • The system may proceed using the verified BOOT SECTOR workflow.

4. If verification is skipped or fails:

   • Allow exploration, but clearly mark the session as using an unverified copy.
   • Never claim that any canonical open problem is solved.

5. For full structure and encoding details:

   • Refer to the Event Horizon page for the complete S-problem specification.

---

Community

The more observers join, the clearer the public ecosystem becomes:

• Join the WFGY Discord

---

Problem Map → Checklist
Global Debug Card → Image Protocol
Ecosystem Map → Structure
Adopters → Public adoption summary
Case Evidence → Interpretation layer
Recognition Map → Ecosystem proof
Evidence Timeline → Historical timeline
WFGY 1.0 → Legacy
WFGY 2.0 → Core
WFGY 3.0 → Event Horizon
Collaboration → Work with WFGY
Support → Support WFGY

---

WFGY · MIT License · Verifiable · Reproducible · Please cite if used · Maintained by PSBigBig + MiniPS (onestardao)