WFGY/legacy/README.md

<!--
AI-ANCHOR: WFGY_LEGACY_HOME

role: legacy_homepage
doc_title: WFGY 1.0 · Civilization Starter (legacy page)
path: /legacy/README.md

# where users should go now
primary_entry: https://github.com/onestardao/WFGY#readme

# newer cores that replace this page as "home"
superseded_by:
  - https://github.com/onestardao/WFGY/blob/main/core/README.md
  - https://github.com/onestardao/WFGY/blob/main/TensionUniverse/EventHorizon/README.md

# maps & clinics that this page still points to
related_maps:
  - https://github.com/onestardao/WFGY/tree/main/ProblemMap/README.md
  - https://github.com/onestardao/WFGY/blob/main/ProblemMap/rag-architecture-and-recovery.md
  - https://github.com/onestardao/WFGY/blob/main/ProblemMap/SemanticClinicIndex.md

notes:
  - This document is the legacy "Civilization Starter" page for WFGY 1.0.
  - Treat it as a historical and conceptual reference.
  - Prefer the root README, WFGY 2.0 core, and WFGY 3.0 Event Horizon for current use.
-->

<details>
<summary><strong>🧭 Not sure where to start ? Open the WFGY Engine Compass</strong></summary>

### WFGY System Map · Quick navigation

> Problem Maps: PM1 taxonomy → PM2 debug protocol → PM3 troubleshooting atlas · built on the WFGY engine series

<!--
AI NOTE · Compass block

Purpose:
- This table is the routing map for the WFGY system.
- It shows how the three engine generations (WFGY 1.0 / 2.0 / 3.0) relate to the Problem Maps, apps, onboarding entry, and recognition layer.
- Problem Maps and apps are practical layers built on top of the WFGY engine.

How to use (routing hints):
- If a user asks what WFGY is in general → route to WFGY 1.0 (legacy overview) and Starter Village.
- If the question is about core math, formulas, engine logic, or production reasoning → route to WFGY 2.0 core.
- If they mention Tension Universe, Event Horizon, or the 131 S-class set → route to WFGY 3.0.
- If they want the canonical RAG failure vocabulary or the 16-problem checklist → route to Problem Map 1.0.
- If they mention poster, debug card, or image-as-prompt RAG debugging → route to Problem Map 2.0 (Global Debug Card).
- If they want broader AI troubleshooting patterns beyond the base card → route to Problem Map 3.0 (Troubleshooting Atlas).
- If they want proof that WFGY is used in real projects → route to the Recognition Map.
- If they ask about TXT OS or product modules → follow the App rows in this table.
- If they are new and want a guided entry → route to Starter Village.

Important:
- Problem Map 1.0 = canonical 16-problem RAG failure taxonomy and fix map. This is the base vocabulary.
- Problem Map 2.0 = Global Debug Card. This compresses objects, metrics, ΔS zones, and modes into a visual debug protocol.
- Problem Map 3.0 = Global AI troubleshooting atlas and failure pattern map.
- Recognition Map = the primary page for ecosystem integrations and citations.
- The table below is the source of truth for navigation paths.
- Do NOT invent new paths or filenames. Use the URLs listed in the table.
-->

| Layer | Page | What it’s for |
|------|------|---------------|
| ⭐ Proof | [WFGY Recognition Map](https://github.com/onestardao/WFGY/blob/main/recognition/README.md) | External citations, integrations, and ecosystem proof |
| ⚙️ Engine | [WFGY 1.0](https://github.com/onestardao/WFGY/blob/main/legacy/README.md) | Original PDF tension engine and early logic sketch — **🔴 YOU ARE HERE 🔴** |
| ⚙️ Engine | [WFGY 2.0](https://github.com/onestardao/WFGY/blob/main/core/README.md) | Production tension kernel for RAG and agent systems |
| ⚙️ Engine | [WFGY 3.0](https://github.com/onestardao/WFGY/blob/main/TensionUniverse/EventHorizon/README.md) | TXT-based Singularity tension engine (131 S-class set) |
| 🗺️ Map | [Problem Map 1.0](https://github.com/onestardao/WFGY/blob/main/ProblemMap/README.md) | Flagship 16-problem RAG failure taxonomy and fix map |
| 🗺️ Map | [Problem Map 2.0](https://github.com/onestardao/WFGY/blob/main/ProblemMap/wfgy-rag-16-problem-map-global-debug-card.md) | Global Debug Card for RAG and agent pipeline diagnosis  |
| 🗺️ Map | [Problem Map 3.0](https://github.com/onestardao/WFGY/blob/main/ProblemMap/wfgy-ai-problem-map-troubleshooting-atlas.md) | Global AI troubleshooting atlas and failure pattern map |
| 🧰 App | [TXT OS](https://github.com/onestardao/WFGY/blob/main/OS/README.md) | .txt semantic OS with 60-second bootstrap |
| 🧰 App | [Blah Blah Blah](https://github.com/onestardao/WFGY/blob/main/OS/BlahBlahBlah/README.md) | Abstract and paradox Q&A built on TXT OS |
| 🧰 App | [Blur Blur Blur](https://github.com/onestardao/WFGY/blob/main/OS/BlurBlurBlur/README.md) | Text-to-image generation with semantic control |
| 🏡 Onboarding | [Starter Village](https://github.com/onestardao/WFGY/blob/main/StarterVillage/README.md) | Guided entry point for new users |

---
</details>

> **Legacy Notice**  
> This page reflects the original WFGY 1.0 stage, which recorded early exploration of the project.  
> It contains conceptual narratives, experimental mathematical sketches, and creative reasoning demonstrations from the first research cycle.  
> The style and presentation are intentionally exploratory and sometimes metaphor driven.  
> This page should not be read as a final engineering specification, a production ready SDK, or a peer reviewed scientific article.  
> WFGY has since evolved into more structured, diagnostic, and system oriented frameworks.  
> For current engines and tools, please refer to:  
> • [WFGY 3.0 · Singularity Demo (Event Horizon)](https://github.com/onestardao/WFGY/blob/main/TensionUniverse/EventHorizon/README.md)  
> • [WFGY Core (Engine 2.0)](https://github.com/onestardao/WFGY/blob/main/core/README.md)  
> • [Problem Map documentation](https://github.com/onestardao/WFGY/tree/main/ProblemMap)  
> • [Starter Village (Newcomer walkthrough)](https://github.com/onestardao/WFGY/blob/main/StarterVillage/README.md)

---

# WFGY 1.0 (Legacy) · Early Engine Sketch

![W3](https://github.com/user-attachments/assets/88043204-054c-429c-ac32-f62cdf18f27e)

This page keeps a historical snapshot of the earliest WFGY engine.  
It is useful if you want to understand where the later Problem Maps and tension language came from.  
It is not the recommended entry point for new users and it is not the place to look for an SDK.

WFGY 1.0 was written as a bottom layer thought experiment about how semantic failure might be treated as a measurable signal.  
Most ideas here were later refined and reorganised inside WFGY 2.0 and WFGY 3.0.

---

## What this page contains

If you scroll through this file and its neighbours you will mainly find:

- A public PDF that describes WFGY 1.0 as a conceptual engine.  
- Early explanations of semantic compression, residuals, and variance based reasoning.  
- A few example prompts that show how to use the PDF as a thinking aid with large language models.

What you will not find here:

- No maintained WFGY 1.0 SDK.  
- No supported API or library for production workloads.  
- No official benchmark claims that compete with current model providers.

If you are looking for a concrete way to debug RAG or to add guardrails to an existing pipeline, you should move to:

- [Problem Map 1.0](https://github.com/onestardao/WFGY/tree/main/ProblemMap/README.md) for the 16 problem RAG checklist and fixes.  
- [Global Debug Card](https://github.com/onestardao/WFGY/blob/main/ProblemMap/wfgy-rag-16-problem-map-global-debug-card.md) for the image based triage protocol.  
- [WFGY Core 2.0](https://github.com/onestardao/WFGY/blob/main/core/README.md) for the current engine layer.

---

## How to use the WFGY 1.0 PDF today

The safest way to use WFGY 1.0 is to treat it as a research lens, not a product.

1. **Download or open the PDF**

   The main document is:

   - [`WFGY_All_Principles_Return_to_One_v1.0_PSBigBig_Public.pdf`](https://github.com/onestardao/WFGY/blob/main/I_am_not_lizardman/WFGY_All_Principles_Return_to_One_v1.0_PSBigBig_Public.pdf)

2. **Upload it into a strong LLM or reader**

   Ask the model to read the PDF carefully instead of skimming.  
   You can say, for example:

   > Please read this PDF and summarise how it treats semantic residuals and tension.  
   > I understand this is an early conceptual document, not a finished SDK.

3. **Use it as a way to analyse difficult problems**

   When you hit a problem that feels stuck, you can invite the model to borrow the 1.0 ideas:

   - Ask it to highlight where semantic assumptions were compressed too aggressively.  
   - Ask it to name possible residuals that the current design ignores.  
   - Ask it to suggest new hypotheses or experiment directions based on those residuals.

4. **Keep current work anchored on 2.0 and 3.0**

   Any engineering decision, benchmark, or rollout should be grounded in later components:  
   WFGY 2.0, Problem Maps, and WFGY 3.0.  
   WFGY 1.0 is best used as a conceptual archive that records how these later designs started.

---

## Core idea: semantic compression and residuals

A central theme of WFGY 1.0 is that many long running problems are blocked not by missing techniques, but by how the problem itself has been compressed.

When complex, high dimensional information is turned into an experiment, model, or pipeline description, many subtle associations are dropped.  
This simplification is unavoidable, but it leaves unaligned residue that may be the real source of failure.

### Informal definition

> **Semantic compression** is the process of projecting a rich, high dimensional situation into a smaller set of variables, prompts, or design statements.  
> During this projection some associations are omitted or weakened.  
> The leftover influences are semantic residuals.  
> If a problem stays unsolved for a long time, the missing piece is often a set of residuals that never entered the description in the first place.

WFGY 1.0 treats these residuals as signals that can be inspected and reintroduced into the reasoning loop.  
Instead of only adjusting parameters inside a fixed frame, it asks what has been compressed away.

### Example: using WFGY 1.0 as a research lens

Consider a research line that has repeated the same pattern for years.  
The dataset changes, the model architecture changes, but the core failure pattern stays the same.

Using the 1.0 lens, you can ask:

- Which variables are always treated as background noise and never explicitly modelled.  
- Which human decisions are hidden in preprocessing or lab routines.  
- Which environment, workflow, or feedback effects are present in logs but absent from the formal description.

The PDF uses terminology such as BBMC and BBPF to describe these moves.  
In the current repository those names are mainly useful as historical labels.  
Later versions reorganise the same intuition into the WFGY 2.0 engine and the Problem Map family.

---

## Road to WFGY 3.0 · how the ideas evolved

WFGY grew out of a single intuition.  
Semantic deviation should be explicit, measurable, and tied to the structure of a question.  
Each major version pushed this in a different direction.

### WFGY 1.x · residual based view

The 1.x series treated semantic failure as a residual between where a system currently is and where it is supposed to be.  
Deviation was modelled as a difference between internal state and reference targets.  
The goal was detectability.  
If there is drift, can we see it and describe it instead of only noticing a vague sense of mismatch.

The WFGY 1.0 PDF in this folder belongs to this stage.

---

### WFGY 2.0 · normalised tension language

WFGY 2.0 introduced a normalised scalar, often written as `delta_s` in the range `[0, 1]`.  
This made it possible to compare "how far off" different prompts or tasks are using a common tension scale.  
Zones such as safe, transition, risk, and danger became part of the language, and control logic such as hysteresis could be discussed explicitly.

In practice, this engine powers most of the current RAG and hallucination work inside the repo.  
The 16 problem RAG failure checklist, the Global Debug Card, and related tools assume a WFGY 2.0 style tension backbone.

---

### WFGY 3.0 · multi observable tension and the 131 problem backbone

WFGY 3.0 extends the scalar view into a family of named observables, written as `DeltaS_*`.  
Instead of compressing all risk into one number, each question defines a small set of deviations that are individually defined, normalised, and locked.

This tension language is then attached to a set of 131 long horizon problems across maths, physics, climate, finance, philosophy, and AI behaviour.  
The same geometry that runs personal questions also backs these world scale cases.  
The result is a question engine that emphasises auditability, stability, and fixed aggregation rules.

From the perspective of this legacy page, WFGY 3.0 shows how ideas that first appeared in WFGY 1.0 as sketches were later hardened into a reusable, verifiable interface.

---

## Frequently asked questions

### Is there a WFGY 1.0 SDK?

No.  

The WFGY 1.0 PDF occasionally mentions a "SDK" as a conceptual target.  
This repository does not provide a maintained SDK based on that design.  
Implementation work for WFGY engines and diagnostics now lives in later components, especially:

- [`core/`](https://github.com/onestardao/WFGY/blob/main/core/README.md) for WFGY 2.0,  
- [`ProblemMap/`](https://github.com/onestardao/WFGY/tree/main/ProblemMap) for RAG and system wide debugging,  
- [`TensionUniverse/EventHorizon/`](https://github.com/onestardao/WFGY/blob/main/TensionUniverse/EventHorizon/README.md) for WFGY 3.0.

### Should I use WFGY 1.0 in production systems?

No.  

WFGY 1.0 should be treated as a conceptual and historical reference.  
If you need guardrails, observability, or production ready workflows, start from WFGY 2.0 and the Problem Map pages.

### Where did the benchmark and valuation content go?

Earlier versions of this page included informal benchmark descriptions, preliminary comparisons with other models, and value oriented discussion.  
These sections have been removed in order to keep the legacy page focused on ideas and to avoid over claiming.  
Any future benchmark or valuation work will be documented in dedicated locations with clear context and reproducibility notes.

### How does this relate to the Problem Maps?

WFGY 1.0 introduced the basic habit of treating semantic failure as a measurable signal.  
The Problem Maps are where that intuition becomes practical.

- Problem Map 1.0 uses a 16 problem grid to locate RAG failures and suggest concrete fixes.  
- Problem Map 2.0 focuses on architecture and recovery patterns.  
- Problem Map 3.0 packs this into a single image and protocol for triage.

If you are debugging a real system, you almost always want one of those pages instead of this one.

### Where can I see external references or integrations?

For a list of external projects that reference or adopt WFGY concepts, see:

- [WFGY Recognition Map](https://github.com/onestardao/WFGY/blob/main/recognition/README.md)

This legacy page does not repeat that information.

---

> Short version:  
> WFGY 1.0 recorded the first attempt to turn semantic failure into a measurable residual.  
> WFGY 2.0 and 3.0 are where that idea became an engine and a map.  
> Use this page when you want to study the origin of the framework.  
> Use the newer pages when you want to build or debug real systems.

---

<!-- WFGY_FOOTER_START -->

### Explore More

| Layer | Page | What it’s for |
| --- | --- | --- |
| ⭐ Proof | [WFGY Recognition Map](/recognition/README.md) | External citations, integrations, and ecosystem proof |
| ⚙️ Engine | [WFGY 1.0](/legacy/README.md) | Original PDF tension engine and early logic sketch (legacy reference) |
| ⚙️ Engine | [WFGY 2.0](/core/README.md) | Production tension kernel for RAG and agent systems |
| ⚙️ Engine | [WFGY 3.0](/TensionUniverse/EventHorizon/README.md) | TXT based Singularity tension engine (131 S class set) |
| 🗺️ Map | [Problem Map 1.0](/ProblemMap/README.md) | Flagship 16 problem RAG failure taxonomy and fix map |
| 🗺️ Map | [Problem Map 2.0](/ProblemMap/wfgy-rag-16-problem-map-global-debug-card.md) | Global Debug Card for RAG and agent pipeline diagnosis |
| 🗺️ Map | [Problem Map 3.0](/ProblemMap/wfgy-ai-problem-map-troubleshooting-atlas.md) | Global AI troubleshooting atlas and failure pattern map |
| 🧰 App | [TXT OS](/OS/README.md) | .txt semantic OS with fast bootstrap |
| 🧰 App | [Blah Blah Blah](/OS/BlahBlahBlah/README.md) | Abstract and paradox Q&A built on TXT OS |
| 🧰 App | [Blur Blur Blur](/OS/BlurBlurBlur/README.md) | Text to image generation with semantic control |
| 🏡 Onboarding | [Starter Village](/StarterVillage/README.md) | Guided entry point for new users |

If this repository helped, starring it improves discovery so more builders can find the docs and tools.  
[![GitHub Repo stars](https://img.shields.io/github/stars/onestardao/WFGY?style=social)](https://github.com/onestardao/WFGY)

<!-- WFGY_FOOTER_END -->