Rewrite as current state rather than how it was decided

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013kj58Jugkic783b8ZrtTVZ
This commit is contained in:
2026-09-04 15:23:09 +09:00
parent d4bd72ab83
commit ef51f22d4c
2 changed files with 5 additions and 6 deletions
+2 -4
View File
@@ -12,10 +12,8 @@ This file serves as the minimalist portal to other docs
Everything needed to bring up a believable fake car on a workstation, so the rest Everything needed to bring up a believable fake car on a workstation, so the rest
of the project can be developed with no Jetson, no PCBs and no Z27AG present. of the project can be developed with no Jetson, no PCBs and no Z27AG present.
One repo rather than one per fixture: they share the contract, they change All fixtures live here together: they share the contract, they change together
together when a schema changes, and the whole point is to bring the fake when a schema changes, and the environment comes up in one step.
environment up in a single step. Splitting them would make that an orchestration
problem for no gain.
- For implementation practice guidelines, refer to the [guidelines](docs/GUIDELINES.md); - For implementation practice guidelines, refer to the [guidelines](docs/GUIDELINES.md);
- For implementation plans and history, refer to [them](docs/impl/); - For implementation plans and history, refer to [them](docs/impl/);
+3 -2
View File
@@ -6,8 +6,9 @@ type: guidelines
## 1. Fixtures publish the real contract ## 1. Fixtures publish the real contract
- A fixture emits the **real topic with the real payload schema**. `yukart/gnss/fix` - A fixture emits the **real topic with the real payload schema**. `yukart/gnss/fix`
from a replayed track must be indistinguishable, at the bus, from a real fix. from a replayed track must be indistinguishable, at the bus, from a real fix.
- A fixture that invents its own topic or shape is worse than no fixture: it defers - ⚠ **A fixture that invents its own topic or shape defers integration rather than
the integration work instead of removing it. removing it** — the mismatch surfaces when the real source arrives, which is the
moment it is most expensive.
## 2. Do not reimplement our own services ## 2. Do not reimplement our own services
- Stub the **car** and the **hardware**. Never write a *separate* implementation of - Stub the **car** and the **hardware**. Never write a *separate* implementation of