# WTO Writing Task: What We Did and How to Follow It

**Folder:** `wto/` — **8 Markdown files**, **`wto-project-summary.Rmd`** (R Markdown report), **`styles.css`**, **`references.bib`**, and **`apa-single-spaced.csl`** (APA bibliography style, same pattern as `reflection_karpathy`).

This README is the **road map**: what was produced, in what order, and how to read the materials by goal.

---

## 1. What this task was

The project started with a **substantive brief** on the WTO: US and others vs China’s stance, MFN and reciprocity, perceptions of advantage, reform, and India—delivered as a **debate-style essay**.

What followed:

| Phase | Content |
|-------|---------|
| **Core writing** | Original essay → saved as `wto-essay.md` → **sourced** essay with footnotes and links (`wto-essay-sourced.md`). |
| **Meta** | Analysis of the prompt, answer, and first AI pass; comparison of both essays; how the sourced essay was built in Cursor. |
| **Verification** | General framework for checking AI citations and truth-types; **applied audit** of the sourced essay (links, DS numbers, claim tables). |

The folder holds **arguments** (essays) and **documentation** (how they were made and how to verify them).

---

## 2. Chronology (production order)

| # | Milestone | File |
|---|-----------|------|
| 1 | Debate essay drafted (chat) | *(then saved)* |
| 2 | Essay saved as Markdown | `wto-essay.md` |
| 3 | Meta: question, answer, AI generation | `examination-question-answer-and-ai-generation.md` |
| 4 | Sourced essay: footnotes, WTO/EU links, dated disputes (DS543, DS544, DS430, DS436), MC12/MC13, MPIA, Bali PSH | `wto-essay-sourced.md` |
| 5 | Compare original vs sourced: strengths, weaknesses, next steps | `essay-comparison-wto-original-vs-sourced.md` |
| 6 | Process: how Cursor AI built the sourced version | `cursor-ai-process-wto-essay-sourced.md` |
| 7 | Framework: verify sources; truth / lies / misinformation / disinformation | `source-verification-and-truth-types.md` |
| 8 | Applied verification report on `wto-essay-sourced.md` | `wto-essay-sourced-verification-report.md` |
| 9 | This navigation file (created early, **updated** as files were added) | `README-wto-task-overview.md` |
| 10 | R Markdown report: objectives, workflow, conclusions, recommendations | `wto-project-summary.Rmd` |

---

## 3. Files by role

### Essays (read for content)

| File | Use when… |
|------|-----------|
| `wto-essay.md` | You want a **fast**, clean debate structure **without** citations. |
| `wto-essay-sourced.md` | You need **dates, DS numbers, URLs**, or material for study and fact-checking. |

### Meta: quality and process

| File | Use when… |
|------|-----------|
| `examination-question-answer-and-ai-generation.md` | You want **what was asked vs delivered** and limits of the **first** AI answer. |
| `essay-comparison-wto-original-vs-sourced.md` | You want a **judgement** of both essays and **ideas to improve** further. |
| `cursor-ai-process-wto-essay-sourced.md` | You want **how** the stronger essay was produced (tools, search, edits). |

### Verification and audit

| File | Use when… |
|------|-----------|
| `source-verification-and-truth-types.md` | You want a **reusable checklist** and definitions (truth, lies, misinformation, disinformation). |
| `wto-essay-sourced-verification-report.md` | You want a **worked example**: link tests, symbol checks, sentence tags, unverified lines, inferences. |

### Index and report

| File | Use when… |
|------|-----------|
| `README-wto-task-overview.md` | You are **new to the folder** or need a **single map** of everything. |
| `wto-project-summary.Rmd` | **R Markdown** report (objectives, workflow, conclusions); uses **`styles.css`** + custom title line **ML and Cursor AI** (knit with R; needs `htmltools`). |
| `styles.css` | Shared with `reflection_karpathy`: fonts, tables, **floating TOC one line per item**. |
| `references.bib` | Bibliography keys for `wto-project-summary.Rmd` (WTO portal sources; extend as needed). |
| `apa-single-spaced.csl` | APA CSL for Pandoc references (paired with `references.bib`). |

---

## 4. How to read by goal

### 4.1 Substance only (WTO politics)

1. `wto-essay.md` — linear debate.  
2. `wto-essay-sourced.md` — if you need sources and dates.

### 4.2 Evaluate answer quality

1. Skim both essays.  
2. `essay-comparison-wto-original-vs-sourced.md`.

### 4.3 AI usage and limits

1. `examination-question-answer-and-ai-generation.md`  
2. `cursor-ai-process-wto-essay-sourced.md`  
3. Optionally confirm `wto-essay-sourced.md` footnotes on official sites.

### 4.4 Verify citations and spot errors

1. `source-verification-and-truth-types.md` — methodology.  
2. `wto-essay-sourced-verification-report.md` — audit of the sourced essay.

### 4.5 Fastest path (new visitor)

1. This README — **§2** (chronology) and **§3** (files by role).  
2. `wto-essay.md` **or** `wto-essay-sourced.md` depending on depth needed.

---

## 5. Full reading order (complete tour)

1. `README-wto-task-overview.md` — orientation.  
2. `wto-essay.md` — original answer.  
3. `examination-question-answer-and-ai-generation.md` — first-pass critique.  
4. `wto-essay-sourced.md` — sourced answer.  
5. `essay-comparison-wto-original-vs-sourced.md` — compare and judge.  
6. `cursor-ai-process-wto-essay-sourced.md` — construction of the sourced file.  
7. `source-verification-and-truth-types.md` — verification framework.  
8. `wto-essay-sourced-verification-report.md` — applied verification.  
9. `wto-project-summary.Rmd` — knit for HTML/PDF (R + `htmltools`); uses `styles.css` like `reflection_karpathy`.

---

## 6. What this folder is not

- **Not** a substitute for legal advice or exhaustive WTO research.  
- **Not** guaranteed **permanent URLs** — recheck critical citations.  
- **Not** automatically a git history — add version control locally if you need diffs.

---

## 7. Maintaining this folder

When you add or rename files:

1. Add a row to **§2** (chronology) if it is a new milestone.  
2. Add a row to **§3** under the right **role** heading.  
3. Adjust **§4** or **§5** if the new file fits a reader goal or the full tour.  
4. For `wto-essay-sourced.md`, consider a **“links checked [date]”** note when you refresh footnotes.  
5. Keep **`styles.css`**, **`references.bib`**, and **`apa-single-spaced.csl`** next to **`wto-project-summary.Rmd`** when you move or copy the project.

---

*For trade-law substance, rely on official WTO texts and the footnotes in `wto-essay-sourced.md`.*
