Back to Eliza

Three-Week Execution Plan

packages/chip/docs/project/three-week-execution-plan.md

2.0.14.5 KB
Original Source

Three-Week Execution Plan

This plan assumes aggressive parallel work, but it does not assume impossible silicon. The finish line is a complete, reproducible prototype package for an open Android-capable SoC research platform:

  • source-backed SOTA specification database
  • runnable e1_soc verification pipeline
  • Android simulator bring-up path
  • RISC-V physical-board baseline plan
  • open RTL SoC expansion path
  • benchmark harness definitions
  • risk register and explicit non-goals
  • workstream gap review with completion criteria and blocked gates

Week 1: Control Plane And Baselines

WorkstreamDeliverableGate
Specsdocs/spec-db/mobile-sota-2026.yamlsource URLs and no pinout-clone claims
RTLcurrent e1_soc passes smokemake smoke
Verificationcocotb/formal/Verilator evidencemake ci-fast where tools exist
Toolchain.venv baseline and tool inventoryscripts/check_tools.sh and scripts/tool_versions.sh
Androidsimulator and AOSP contract docmake aosp-bsp-check
Benchmarksbenchmark matrix and report schemabenchmark doc exists and has claim levels
Riskv0 exclusions and mitigation listrisk register exists

Week 2: Open RTL Expansion

WorkstreamDeliverableGate
Chipyardselected baseline config for Rocket/BOOM/CVA6bootstrap script or documented blocker
ToolchainOpenLane2/Chipyard/OSS CAD Suite pin decisionselected tags/SHAs or explicit release blockers
NPUGemmini/NVDLA path decisionoperator and TFLite/MLPerf subset plan
SoftwareLinux driver/runtime smoke for e1 NPUdeterministic vector test
AndroidHAL stub map and build notesno undocumented device nodes
Benchmarksscripts for CoreMark/STREAM/lmbench/fio/TFLitedry-run or documented missing tool

Week 3: Integrated Prototype Package

WorkstreamDeliverableGate
SimulatorQEMU/Renode contract smokemake qemu-check renode-check
RTLfull local CI evidencemake ci-local where tools exist
Androidrunnable simulator recipecommand transcript and boot artifact list
BoardTH1520 procurement and board test planexact board, image, and benchmark plan
Releasearchive packagemake archive-release after pipeline evidence exists

Reproducibility Rules

  • Local Python evidence should come from .venv; user-site Python is a temporary unblocker and must be named in status notes.
  • Fast-path evidence may use Docker, Nix, or host tools, but the selected path must include build/reports/tool_versions.txt.
  • Floating inputs are not release evidence. ubuntu:24.04, nixos-unstable, default-branch OpenLane2, and default-branch Chipyard remain blockers until pinned by digest, lockfile, tag, SHA, or checksum.
  • Heavy tools can be absent during scaffold work, but absent tools must be tied to blocked gates instead of reported as passing.
  • make mvp-status is the cross-workstream summary gate: every subsystem must show PASS, BLOCK, or FAIL with evidence and a next command.
  • docs/project/workstream-gap-review.md is the backlog gate for stubs, scaffolds, LARPs, incomplete work, untested claims, not-implemented areas, and complete gaps. It must not be used as proof that subsystem gates passed.

Ten-Minute Operating Loop

Each check-in should answer only four questions:

  1. What artifact changed?
  2. What gate passed or failed?
  3. What is the highest-risk blocker?
  4. What is the next command or patch?

This prevents the project from drifting into aspirational architecture writing.

Automation Gates

The plan artifacts are part of smoke, not optional reading. make smoke runs scripts/check_project_plan.py, which now checks that benchmark, Android, and board artifacts keep their safety boundaries:

  • benchmark reports keep the L0-L6 claim levels and block simulator wall-clock comparisons against phone scores,
  • Android bring-up remains tied to sw/platform/e1_platform_contract.json and the make aosp-bsp-check evidence path,
  • board and FPGA artifacts remain scaffold-only until board revision, package pins, and bitstream release blockers are resolved.
  • the workstream gap review keeps project/program backlog status separate from subsystem-owned implementation evidence.

Release archives should carry the project-plan artifacts with the generated RTL and verification evidence, so a reviewer can reproduce both the commands and the claim boundaries from the archive alone.