diff --git a/CLAUDE.md b/CLAUDE.md index e03af9fe9..a7c9954fb 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -24,13 +24,18 @@ there: nothing outside the module can import. Modules reach each other only through API packages, own their schema and tables, and keep no state only in memory. - `internal/platform/` holds the few leaf packages every module may use. -- The new code never imports the old services' packages (depguard enforces it); - move what you need instead. +- The new code never imports the old services' packages (depguard enforces it). + Old code moves: `git mv` it into the module that owns it, then adapt it. + MIGRATION.md in sam/archie-product gives every old package a destination and + a verdict. Writing a replacement from scratch, or deleting an old package, + needs the maintainer's verdict on its row. Before building anything an old + package already does, read that package and carry its behaviour. ### The services being replaced -The six services below are deleted slice by slice as the binary replaces them. -Don't add features to them; fix them only when a bug blocks work. +The six services below are deleted slice by slice as the binary replaces them, +each only once MIGRATION.md has a verdict for every package it holds. Don't +add features to them; fix them only when a bug blocks work. Each service is a gRPC contract in `proto//v1`, generated into `internal/contracts//v1`, and one binary in `cmd/` that parses flags