From 109ee17921009d7f092a1d1e8ec658a3d3ea731a Mon Sep 17 00:00:00 2001
From: hkimw <54717101+hkimw@users.noreply.github.com>
Date: Thu, 7 May 2026 09:31:38 +0900
Subject: [PATCH] docs: link v002.1 architecture, evidence, runbook

Expose the v002.1 architecture explainer, evidence inventory, bitstream runbook, and roadmap board from the README and docs landing page.

Keep the links evidence-gated while the referenced artifacts remain draft or pre-flight.
---
 README.md      | 11 +++++++++++
 docs/index.rst | 26 ++++++++++++++++++++++++++
 2 files changed, 37 insertions(+)

diff --git a/README.md b/README.md
index d41282403..d97b00806 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,17 @@ issues are welcome.
 
 ---
 
+## v002.1 evidence-gated pointers
+
+| Item | Link | Guard |
+| --- | --- | --- |
+| Architecture explainer | [`docs/spec/v002.1-architecture-explainer.md` (PR #48)](https://github.com/pccxai/pccx/blob/docs/v002.1-architecture-explainer/docs/spec/v002.1-architecture-explainer.md) | Draft explainer; no board-run, closed-timing, deployable-bitstream, or measured-throughput claim. |
+| Evidence inventory | [`pccx-FPGA-NPU-LLM-kv260` evidence inventory (PR #95)](https://github.com/pccxai/pccx-FPGA-NPU-LLM-kv260/blob/docs/v002.1-evidence-inventory/docs/evidence/v002.1-evidence-inventory.md) | Inventory of landed and pending evidence; release claims remain gated by measured artifacts. |
+| Bitstream runbook | [`pccx-FPGA-NPU-LLM-kv260` bitstream runbook (PR #82)](https://github.com/pccxai/pccx-FPGA-NPU-LLM-kv260/blob/build/v002-kv260-bitstream-runbook/docs/runbooks/v002.1-bitstream-build.md) | Pre-flight runbook; Vivado and KV260 board execution are not claimed by this link. |
+| Project board | [PCCX Roadmap project board](https://github.com/orgs/pccxai/projects/1) | Planning tracker; status must be read with the evidence gates above. |
+
+---
+
 ## What is pccx?
 
 pccx is a hardware-software co-design framework that accelerates **autoregressive decoding** of Transformer-based LLMs on resource-constrained edge devices. The primary target is the **Xilinx Kria KV260** SOM.
diff --git a/docs/index.rst b/docs/index.rst
index e65147752..70efab08b 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -102,6 +102,32 @@ Working tracks for the next release lines:
 The :doc:`roadmap` summarises how the three tracks relate, and the
 ``pccx`` family-tree figure on that page links them visually.
 
+Evidence-gated v002.1 pointers:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 24 44 32
+
+   * - Item
+     - Link
+     - Guard
+   * - Architecture explainer
+     - `docs/spec/v002.1-architecture-explainer.md (PR #48) <https://github.com/pccxai/pccx/blob/docs/v002.1-architecture-explainer/docs/spec/v002.1-architecture-explainer.md>`__
+     - Draft explainer; no board-run, closed-timing, deployable-bitstream,
+       or measured-throughput claim.
+   * - Evidence inventory
+     - `pccx-FPGA-NPU-LLM-kv260 evidence inventory (PR #95) <https://github.com/pccxai/pccx-FPGA-NPU-LLM-kv260/blob/docs/v002.1-evidence-inventory/docs/evidence/v002.1-evidence-inventory.md>`__
+     - Inventory of landed and pending evidence; release claims remain
+       gated by measured artifacts.
+   * - Bitstream runbook
+     - `pccx-FPGA-NPU-LLM-kv260 bitstream runbook (PR #82) <https://github.com/pccxai/pccx-FPGA-NPU-LLM-kv260/blob/build/v002-kv260-bitstream-runbook/docs/runbooks/v002.1-bitstream-build.md>`__
+     - Pre-flight runbook; Vivado and KV260 board execution are not
+       claimed by this link.
+   * - Project board
+     - `PCCX Roadmap project board <https://github.com/orgs/pccxai/projects/1>`__
+     - Planning tracker; status must be read with the evidence gates
+       above.
+
 The v001 architecture is archived at
 :doc:`archive/experimental_v001/index`.