# EAGLE4 on AMD Alveo V80 - agent discovery index (llms.txt) Generated 2026-10-26 04:09 from catalog.json (4801 entries). Regenerate: cd && python3 catalog.py && python3 llms_gen.py What this is: hand-written SystemVerilog 2-bit EAGLE4 speculative-decoding drafter split over two V80 cards (HEAD + TAIL), served from SGLang on an H200 host. Goal: pair tok/s above the GPU-only EAGLE bar at matched accept. ## How to use this index (new agent, read in this order) 1. Read the 'Entry points' list below (current docs only). 2. Search everything: python3 [--kind site_page|skill|handoff|repo_report|result_report|hq_note|lab_result|memory] [--build 0xE4B711CD] [--feature TOGGLE] [--status current] 3. Status field: current | superseded (has superseded_by) | historical (dated snapshot, still valid for its date). Prefer current; check the date before quoting any number. 4. Graph UI (click nodes for report/data): https://hardware.research.yshicarrick.com/p/eagle4-knowledge-graph/ ; machine copies: catalog.json, graph.json, llms.txt are page assets there. 5. Verify live numbers against NOW.md and the card build-id before acting; pages are snapshots. ## Areas (entry counts) - hq_note: 1785 - HQ notes (FROM_HQ, NOTE_*, per-image notes) - result_report: 1658 - reports/results/*.md measurement write-ups - image_bundle: 455 - per-image link bundles (kg/images//) - memory: 383 - agent memory notes - site_page: 139 - published research pages (site, /p//) - repo_report: 132 - top-level repo reports/*.md - lab_result: 126 - lab-host lab results (REPORT.md per test) - repo_doc: 59 - docs/*.md - skill: 41 - agent playbooks (.claude/skills) - handoff: 13 - session handoff pages - repo_key_doc: 10 - CLAUDE/NOW/TRACKLIST and friends Status counts: current=3398, superseded=58, historical=1345 ## Entry points (current, in reading order) - Start here (repo): EAGLE4 FPGA Project — Claude Code Entry Point /CLAUDE.md Project rules, hard safety rules, pinned docs. Auto-loaded; read first. - Live state: NOW — EAGLE4 CURRENT STATE · last updated 2026-09-14 06:00 EDT (**CARD/PDI STATE UNCHANG /NOW.md Long-form state + DEAD list. CAUTION: last updated 2026-09-14 - newer truth is in TRACKLIST, the handoff and site pages. - Live job board: TRACKLIST — architecture-forward board (started 2026-09-23) /TRACKLIST_20260923.md Editable board of every dispatched job, image and decision. - Full handoff, 13 pages: HANDOFF 2026-09-24 — START HERE (orchestrator session 87e06065, 2026-09-23 ~09:00 → 2026-0 /docs/handoff_20260924/00_START_HERE.md 10+ page orientation: architecture, engine research, split design D, images, machines, agents, lessons. - Images/builds/flash/test: 06 — Images, builds, flash, cold AC, silicon tests /docs/handoff_20260924/06_IMAGES_BUILDS_FLASH_TEST.md Build-ids are `0xE4B711xx`; `PROBE_REV 8'hxx` is the low byte. Always grep scripts/, reports/results/ and NOW.md for zero - Lessons and traps: 09 — Lessons and traps from this session (each one cost time tonight) /docs/handoff_20260924/09_LESSONS_AND_TRAPS.md 1. "Locality lifts the array to ~167 MHz" — the control run showed the array ALONE closes ~166 MHz with either - Agent restore skills index: 10 — Agent restore skills: each agent writes its own, at an assigned path /docs/handoff_20260924/10_AGENT_RESTORE_SKILLS.md User directive 2026-09-24 ~02:45: "and all the agent to restore: let the agent's themselves write these, and put to - Every tested image, md5, raw logs: EAGLE4 pair — tested archive (lab-host, snapshot 2026-09-27 ~02:10) /tested_archive/README.md tested_archive/README.md: every flashed image, md5, weights, scripts, raw logs; best pair numbers. - Newest architecture walk-through: EAGLE4 Architecture Evolution https://hardware.research.yshicarrick.com/p/eagle4-arch-evolution-20261005/ Animated walk-through of the EAGLE4 V80 drafter: HEAD/TAIL split, 256-lane DSP58 GEMV, KV import, LEVEL_PIPE/FG8, 75 MHz TAIL record 339.12 tok/s [M], QSFP D2/CL4 4-card - Newest weekly architecture: EAGLE4 V80 Architecture Week 40 https://hardware.research.yshicarrick.com/p/eagle4-weekly-arch-20261005/ Drafter split across two V80s: HEAD = embedding, QKV, attention, O, MLP gate/up on a 128-lane GEMV array; TAIL = SiLU, down-proj, fc_out, low-rank LM head, vocab tree and - Per-block timeline + bubble analysis (Perfetto): EAGLE4 Trace: per-block timelines, bubbles and utilisation https://hardware.research.yshicarrick.com/p/eagle4-trace-20261006/ Perfetto traces per hardware block from xsim + lab-host hostprof; the draft step is a serial host->cards->GPU chain, so overlap beats engine speed-up. || Silicon step: HEAD c - New-engineer RTL handbook: EAGLE4 RTL Onboarding https://hardware.research.yshicarrick.com/p/eagle4-rtl-onboarding/ Handbook for new engineers: architecture, repo, toolchain, first build, xsim gates, adjudication and relay, budgets, glossary || Start working on the EAGLE4 RTL - Roadmap reading list: EAGLE4 Roadmap Review Pack https://hardware.research.yshicarrick.com/p/eagle4-roadmap-review-pack-20261005/ Curated pages and files to review with partner hardware leads, grouped by the roadmap decision each one feeds. || Reading list for the roadmap session: 6 themes, site pag - Weight residency: EAGLE4 Weight Residency https://hardware.research.yshicarrick.com/p/eagle4-weight-residency/ 41.58 MiB 2-bit body on-chip (URAM), fp16 lm-head and embeddings in HBM; 4 V80s hold ~0.9B 2-bit weights, ~5x today || 41.58 MiB on-chip; 4 cards ~5x - Product/benchmark page: Eagle Companion Chip https://hardware.research.yshicarrick.com/p/eagle-companion-chip/ On-chip speculative-decoding drafter: 1.15x (MT-Bench) / 1.33x (HumanEval) vanilla H200 at batch 1; FPGA evaluation system, SGLang, switchable target model || 1.33x vanil - This knowledge graph: EAGLE4 knowledge graph https://hardware.research.yshicarrick.com/p/eagle4-knowledge-graph/ Discovery layer over every page, report, note and skill, linked to images and features; Images carry post-route timing, utilization, verdicts and findings from the HQ exp - GPU accept reference command: 📌 PINNED — THE GPU ACCEPT REFERENCE COMMAND (user-supplied 2026-08-24 06:01) /docs/GPU_ACCEPT_GOLDEN_COMMAND.md **This is the command. Do not reconstruct it, do not substitute paths, do not "improve" it.** - Research-site how-to (push a page): Research site: hardware.research.yshicarrick.com /docs/RESEARCH_SITE.md One page per research experiment, written and pushed by the agent that ran it. Public read. - Pair silicon test skill: eagle4-pair-silicon-test /.claude/skills/eagle4-pair-silicon-test/SKILL.md Test an EAGLE4 HEAD/TAIL pair image on silicon after a cold AC — bring-up, arming, the matched benchmark, width/depth sweeps with paired A/Bs, per-phase census, GPU golde - AVED build skill: eagle4-aved-build /.claude/skills/eagle4-aved-build/SKILL.md Launch and babysit an EAGLE4 AVED PDI build (uni_pipeline) on lab-host / Oleg VM / build-host-A / laptop — Vivado setup, deriving a pipeline, env vars, locks + memory holds, which - Flash + cold-AC skill: eagle4-flash-coldac /.claude/skills/eagle4-flash-coldac/SKILL.md Flash an EAGLE4 pair image to a V80 (HEAD 61:00.0 / TAIL 41:00.0) and bring the pair back after the user's cold AC — preflash adjudication, detached -p 0 flash, post-cold - Mesh housekeeping skill: eagle4-mesh-housekeeping /.claude/skills/eagle4-mesh-housekeeping/SKILL.md Housekeeping for the EAGLE4 compute mesh — machines/IPs/access, Vivado + license per host, swap/sshd, the mesh dispatcher (mesh_run/status/adopt/install), and the three w ## Newest site pages - 2026-10-23 [current] EAGLE4 white paper https://hardware.research.yshicarrick.com/p/eagle4-white-paper/ - 2026-10-23 [current] Qwen3.8-27B + EAGLE3 drafter on talon2: GPU vs 4-card FPGA drafter (2026-10-23) https://hardware.research.yshicarrick.com/p/t2-qwen27b-eagle-talon2-20261023/ - 2026-10-23 [current] Track 1: Qwen3.8-27B target with its drafter on the 4-card V80 FPGA drafter (4C1 https://hardware.research.yshicarrick.com/p/track1-qwen27b-4c1-20261023/ - 2026-10-23 [current] EAGLE4 home: three tracks https://hardware.research.yshicarrick.com/p/eagle4-home/ - 2026-10-22 [current] Track 2: latest tested progress on talon (2026-10-22 evening) https://hardware.research.yshicarrick.com/p/t2-tested-progress-20261022b/ - 2026-10-22 [current] Track 1: 4C1 wave E on silicon. ATT 0xE4B712B4 + MLPV 0xE4B712E4 measured ladder https://hardware.research.yshicarrick.com/p/fourcard-4c1-wave-e-silicon-20261022/ - 2026-10-22 [current] Track 2: 8-card talon target, Qwen done-right on silicon, HBM bandwidth, SLR2 (2 https://hardware.research.yshicarrick.com/p/t2-talon-8card-target-20261022/ - 2026-10-21 [superseded] EAGLE4 all tested data, 2026-10-21 https://hardware.research.yshicarrick.com/p/eagle4-tested-data-20261021/ - 2026-10-21 [superseded] EAGLE4 progress and next 2 days https://hardware.research.yshicarrick.com/p/eagle4-progress-projection-20261021/ - 2026-10-21 [current] Track 1: H200 + 4-card FPGA drafter, 2026-10-21 https://hardware.research.yshicarrick.com/p/eagle4-track1-20261021/ - 2026-10-21 [current] Track 2: HBM Qwen 27B + URE drafter + Llama/Qwen on talon, 2026-10-21 https://hardware.research.yshicarrick.com/p/eagle4-track2-20261021/ - 2026-10-21 [current] Track 3: FOLDRING8 constant-folded model on the 8-card ring, 2026-10-21 https://hardware.research.yshicarrick.com/p/eagle4-track3-20261021/ ## Registering new work Every new page/report: python3 --kind site_page --title T --path-or-url URL --build 0xE4B711XX --feature TOGGLE --supersedes Image IDs look like 0xE4B711<2 hex>; per-image bundle: Rules that bind every agent: never kill processes/builds, never flash -p 1, no deletions, state the regime/image when quoting accept or tok/s (see CLAUDE.md).