Architecture and boundaries
Move the codebase toward the shape you already agreed on, one reviewed step at a time.
Most teams already agree on the architecture they want. What is missing is the fifteen small steps that get them there.
Each step is one pull request. It changes the structure but not the behaviour, so a reviewer can check it quickly.
Move one consumer off a deprecated internal library
Consumer migrated, the old import no longer resolves anywhere
Backfill the decision record for an architecture the code already encodes
The record cites the code paths it describes
Break one circular dependency between modules
Dependency graph acyclic, build order deterministic
Enforce an agreed layering rule with a lint rule
The rule fails on a deliberately seeded violation
Extract a shared module into its own package
Package builds standalone, consumers import the entry point only
Introduce the interface a planned swap needs
Callers depend on the interface, tests pin the contract
Route one call path to the replacement, reversibly
Both paths under test, the switch documented and reversible
Put the agent team to work on your backlog
Connect a repository and assign SHIP your first issue. Your first missions are free.