Separate universal from local
Branch policy, destructive-command rules, and repository-wide checks belong at the root. Framework conventions, edge-runtime limits, and focused test commands belong with the package that uses them.
Explain ownership boundaries
Agents need to know when a type or configuration belongs in a shared package and when a local copy is intentional. A short ownership map prevents duplication and reduces edits to unrelated deploy surfaces.
Make verification composable
List the smallest command that proves a package change, then name the shared contracts that trigger broader checks. This keeps routine work fast without allowing cross-package changes to escape repository-level validation.