Repository navigation
Description
Goal
Bring every production BREAD Slice to a releasable state: KiCad 10 format, all
library references resolving, ERC/DRC/Fab clean under validate_board.py, then a
pre-fab review and merge. This issue coordinates that effort across the fleet so
status lives in one place instead of scattered notes.
Scope and working rule
One remediation PR per board (#1 on each repo, branch
chore/mechanical-remediation), titled "chore: fleet remediation (KiCad 10, DRC
gate, Makefile, gitignore, library re-points)". Mechanical remediation (format,
gitignore, Makefile targets, DRC parity gate, KiBot layer coverage) is complete
on all boards — none fails a structural check for those any more. What remains is
board defects: unresolved library references, ERC, and DRC.
Board defects are fixed by hand in the KiCad UI on each board's branch.
Automation measures, reads CI, and prepares changes; it does not edit board art.
Per-board remediation recipe
Most boards need these steps (or a subset), as separate commits:
- Expand
.gitignoreto cover backups, lock files, and KiCad autogenerated
history. feat: upgrade to KiCad 10chore: reconnect library referencesfix: clear all ERC and DRC errors
Status — production Slices
Re-measured 2026-10-19 (structural + ERC + DRC at error severity, each
board on its remediation branch). Fleet-wide: 14 of 42 boards green —
unchanged since the 2026-07-13 pass, since nothing has merged. Of the 26
production Slices below, 3 are green. Columns lib/erc/drc are
unresolved library refs, ERC errors, and DRC errors.
| Board | Status | lib | erc | drc |
|---|---|---|---|---|
| IOAC | ✅ green | 0 | 0 | 0 |
| RLAY | ✅ green | 0 | 0 | 0 |
| RTDM | ✅ green | 0 | 0 | 0 |
| AQDO | 🔴 | 1 | 0 | 0 |
| AQEC | 🔴 | 1 | 0 | 0 |
| AQOR | 🔴 | 1 | 0 | 0 |
| VCAC | 🔴 | 1 | 0 | 0 |
| BUCK | 🔴 | 2 | 0 | 0 |
| USBP | 🔴 | 4 | 0 | 0 |
| LVAI | 🔴 | 5 | 0 | 0 |
| AQPH | 🔴 | 1 | 0 | 4 |
| IAQM | 🔴 | 3 | 0 | 4 |
| LEPD | 🔴 | 1 | 0 | 2 |
| AOEM | 🔴 | 0 | 0 | 5 |
| FPSG | 🔴 | 0 | 0 | 4 |
| SOLR | 🔴 | 0 | 0 | 4 |
| PHDO | 🔴 | 1 | 2 | 0 |
| THMX | 🔴 | 2 | 1 | 0 |
| HEAT | 🔴 | 7 | 2 | 0 |
| LOAD | 🔴 | 0 | 1 | 7 |
| VCDC | 🔴 | 2 | 9 | 0 |
| SERV | 🔴 | 6 | 2 | 0 |
| GDHB | 🔴 | 2 | 1 | 6 |
| STPC | 🔴 | 3 | 12 | 3 |
| STEP | 🔴 | 3 | 7 | 11 |
| IOCT | 🔴 | 0 | 2 | 20 |
This corrects an earlier hand-kept note that listed AQDO, AQEC, AQOR, BUCK, IAQM,
LVAI, USBP, and VCAC as green: each still carries its unresolved library
references, so the re-point was never actually done. Slice_SOLR improved — its
BQ24650 redesign dropped it from 17 DRC to 4.
The detailed tier breakdown and the measurement method are in
docs/fleet-remediation.md.
Critical path
Ordered by what it costs to get wrong:
- DRC — copper defects (fab-fatal): IOCT (20) first, then STEP, LOAD, GDHB,
AOEM, FPSG, AQPH, IAQM, STPC, LEPD, PRTO_SMT. Run the DRC command in the doc to
separate real copper shorts from unconnected/parity noise. - ERC
pin_to_pin— outputs driving each other, a real electrical conflict,
not a flag you can add. Concentrated in STPC (12) and VCDC (9). - Library re-points — 11 boards need only this (AQDO, AQEC, AQOR, BUCK, LVAI,
USBP, VCAC, TEMP_PICO_L4L-r1, TEMP_PICO_S2L-r1, THRM_31855, THRM_31856);
cheapest way to move the green count. PWR_FLAG/ no-connect — mechanical, fast.
Board checklist (open PRs)
A box is checked when the board's PR is reviewed and merged. The marker is the
2026-10-19 verdict, not merge state.
Production Slices:
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_IOAC#1 — ✅
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_RLAY#1 — ✅
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_RTDM#1 — ✅
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_AQDO#1 — 🔴 lib 1
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_AQEC#1 — 🔴 lib 1
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_AQOR#1 — 🔴 lib 1
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_VCAC#1 — 🔴 lib 1
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_BUCK#1 — 🔴 lib 2
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_USBP#1 — 🔴 lib 4
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_LVAI#1 — 🔴 lib 5
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_AQPH#1 — 🔴 lib 1 · drc 4
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_IAQM#1 — 🔴 lib 3 · drc 4
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_LEPD#1 — 🔴 lib 1 · drc 2
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_AOEM#1 — 🔴 drc 5
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_FPSG#1 — 🔴 drc 4
- feat(hw): redesign charger stage around the BQ24650 reference design Slice_SOLR#1 — 🔴 drc 4 · draft BQ24650 redesign
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_PHDO#1 — 🔴 lib 1 · erc 2
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_THMX#1 — 🔴 lib 2 · erc 1
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_HEAT#1 — 🔴 lib 7 · erc 2
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_LOAD#1 — 🔴 erc 1 · drc 7
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_VCDC#1 — 🔴 lib 2 · erc 9
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_SERV#1 — 🔴 lib 6 · erc 2
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_GDHB#1 — 🔴 lib 2 · erc 1 · drc 6
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_STPC#1 — 🔴 lib 3 · erc 12 · drc 3
- chore: mechanical remediation (KiCad 10, DRC gate, Makefile, gitignore) Slice_STEP#1 — 🔴 lib 3 · erc 7 · drc 11
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_IOCT#1 — 🔴 erc 2 · drc 20
Templates and prototypes:
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_TEMP_NANO_S2L-r1#1 — ✅
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_TEMP_NANO_S2L-r2#1 — ✅
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_TEMP_NUCL_L4L-r1#1 — ✅
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_TEMP_NUCL_S4L-r1#1 — ✅
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_TEMP_PICO_L4L-r1#1 — 🔴 lib 1
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_TEMP_PICO_S2L-r1#1 — 🔴 lib 1
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_PRTO_CONN_S2L#1 — ✅
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_PRTO_THTA_S2L#1 — ✅
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_PRTO_THT_S2L#1 — ✅
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_PRTO_SMT_S2L#1 — 🔴 drc 1
Thermocouple:
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_THRM_31855#1 — 🔴 lib 2
- chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points) Slice_THRM_31856#1 — 🔴 lib 1
Follow-ups
- Re-measure the fleet (2026-10-19) — reproduced the July numbers: 14 green,
39 ERC, DRC within two. Only SOLR moved (redesign, 17 → 4 DRC). - Home the detailed worklist as
docs/fleet-remediation.md— docs: home the fleet remediation worklist #17 (merged 2026-10-19). - OSF provenance: reference the old and deleted Slice repos (via history) on
the site to OSF.CITATION.mdalready maps the master OSF project and most
Slice/Loaf OSF pages. Related: README records no BREAD/OSF provenance for the Slice design Slice_DCMT#27, README records no BREAD/OSF provenance for the Slice design Slice_RLHT#10.
Already landed (context)
- bread-infra
v1.0.0→v1.2.0andschema-loaf-v1.0: KiCad 10 CI,
upgrade_kicad10.sh,validate_board.py,.history/+*.kicad_prlgitignore,
canonical KiBot configs failing on unplotted copper, the Loaf tier. - KiCad-Master-Lib vendoring, lib tables, vendor sync, lint gate.
- Slice_DCMT and Slice_RLHT remediation PRs merged (firmware work continues
separately). - Loaf_x004 and Loaf_ESPT remediation PRs merged.
Activity
docs: home the fleet remediation worklist (#17)