From e6dc99ec85840a90dbdc9eda26f5d06db514800e Mon Sep 17 00:00:00 2001 From: "dong.nguyen" Date: Sun, 18 Oct 2026 23:46:39 +0700 Subject: [PATCH] docs(specs): record the review-fix spec, gate results and doc-drift closure New spec-v3-review-fixes.md carries the findings, the per-bundle implementation detail, the affected-file list, the out-of-scope table including the declined resume.pdf bundle with its measured 200 text/html probe, the gate numbers and the commit record. spec-v2-seo.md acceptance is now honest: robots, sitemap, JSON-LD and canonical are done, per-route title/description/OG remain open because the SPA serves one head for every route. spec-v2.md statuses no longer contradict shipped work. AGENTS.md drops both barrels, documents the pure field() helper, the canonical origin module, the sitemap build step and the lazy/default-export gotcha. --- AGENTS.md | 20 +- docs/design/spec-v2.md | 8 +- docs/design/specs/v2/spec-v2-seo.md | 14 +- docs/design/specs/v3/spec-v3-review-fixes.md | 189 +++++++++++++++++++ 4 files changed, 214 insertions(+), 17 deletions(-) create mode 100644 docs/design/specs/v3/spec-v3-review-fixes.md diff --git a/AGENTS.md b/AGENTS.md index f003904..7581d25 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -22,10 +22,11 @@ Personal engineering portfolio — multi-page SPA built with React + TypeScript | Command | Description | |---------|-------------| | `pnpm dev` | Start dev server with HMR | -| `pnpm build` | Type-check (`tsc -b`) then build for production | +| `pnpm build` | Type-check (`tsc -b`), build for production, then generate `dist/sitemap.xml` | | `pnpm build:resume` | Generate resume PDF (default EN) via Playwright | | `pnpm build:resume-all` | Generate bilingual resume PDFs (EN + VI) | | `pnpm lint` | Run Oxlint | +| `pnpm sitemap` | Regenerate `dist/sitemap.xml` on its own (also run by `pnpm build`) | | `pnpm preview` | Preview production build locally | ## Routing @@ -34,6 +35,7 @@ Personal engineering portfolio — multi-page SPA built with React + TypeScript - Layout: `` (top) → `
` → `