From ee4c3f9c16e33a60e24906348f474b275fff70a7 Mon Sep 17 00:00:00 2001 From: Sam Catlow Date: Mon, 16 Nov 2026 15:52:21 +1100 Subject: [PATCH] docs(agents): old code moves into its module; a rewrite or a deletion needs a verdict in the move map (#1977) --- CLAUDE.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) 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