docs(agents): old code moves into its module; a rewrite or a deletion needs a verdict in the move map (#1977)

This commit is contained in:
sam committed 2026-11-16 15:52:21 +11:00
1 parent 21de660ae1
commit ee4c3f9c16
1 file changed
+9 -4
+9 -4
View File
@@ -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/<service>/v1`, generated into
`internal/contracts/<service>/v1`, and one binary in `cmd/` that parses flags