README: add pipeline explainer

README.md

@@ -29,6 +29,48 @@ Note: the PDF renderer can introduce page breaks depending on line wrapping. The
 - This is a **presentation and targeting** pack (CV + job matching).
 - It does **not** grant work authorization. If a role requires sponsorship, disclose it early and keep the story consistent.
 
+## Pipeline (who / why / what / where / when / how)
+
+### Who
+- **Candidate:** Ahmet Kerem Özbay (warehouse/logistics profile).
+- **You (operator):** provided context, reviewed outputs, and made minor edits directly in the repo.
+- **Codex (assistant):** generated research artifacts, drafted/refined the CV, and produced DOCX/HTML exports.
+
+### Why
+- Improve CV quality and targeting for warehouse/logistics roles.
+- Create a reusable pack (CV + job-ad corpus + guidance) to reduce repeated work and speed up iteration.
+- Keep the CV exportable as a **single-page PDF** when using Forgejo’s Markdown→PDF renderer.
+
+### What
+- **Input:** `source/AHMET_KEREM_OZBAY_CV.pdf`
+- **Outputs:** CV in `artifacts/cv_research/` as:
+  - Markdown (`Ahmet_Kerem_Ozbay_CV_EN.md`) optimized for 1-page PDF export
+  - DOCX (`Ahmet_Kerem_Ozbay_CV_EN.docx`)
+  - HTML (`Ahmet_Kerem_Ozbay_CV_EN.html`)
+- **Supporting artifacts:** best-practices notes, a structured debate transcript, job ads (JSON + HTML), and a CV bible.
+
+### Where
+- Work was produced and stored in this Forgejo repository:
+  - `https://git.infrafabric.io/danny/ahmet-kerem-ozbay`
+
+### When
+- Created and iterated during the current session (repo commit history is the source of truth for exact timestamps).
+
+### How (high-level steps)
+1) **Extracted CV text** from the provided PDF and summarized the candidate profile.
+2) **Collected reference patterns** (warehouse/logistics CV/resume guides) and distilled recurring structure/language/layout rules.
+3) **Collected matching job ads** (France, logistics/warehouse category) and saved them locally as:
+   - structured JSON payloads and
+   - downloaded HTML pages for offline review.
+4) **Validated recommendations** via a structured, explicitly-marked **simulated** panel debate (HR + recruiter + role-played employers) to filter out unrealistic advice.
+5) **Wrote a CV bible** (rules + repeatable checklist) so future edits don’t break consistency.
+6) **Redrafted the CV** and iterated formatting:
+   - first for clarity and scannability,
+   - then specifically to keep Forgejo’s PDF export at **1 page** (by collapsing sections when needed).
+7) **Generated exports:**
+   - DOCX created from the Markdown using a small scripted conversion (local tooling).
+   - HTML created as a single-file printable view with minimal CSS.
+
 ## Repository layout (file tree)
 
 ```text