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
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
together when a schema changes, and the whole point is to bring the fake
environment up in a single step. Splitting them would make that an orchestration
problem for no gain.
All fixtures live here together: they share the contract, they change together
when a schema changes, and the environment comes up in one step.
- For implementation practice guidelines, refer to the [guidelines](docs/GUIDELINES.md);
- 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
- 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.
- A fixture that invents its own topic or shape is worse than no fixture: it defers
the integration work instead of removing it.
- ⚠ **A fixture that invents its own topic or shape defers integration rather than
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
- Stub the **car** and the **hardware**. Never write a *separate* implementation of