blueprint-platform/docs/architecture/workspace-cross-repo-reference-guard.md
2026-02-25 16:48:50 -06:00

35 lines
843 B
Markdown

# Workspace Cross-Repo ProjectReference Guard
## Purpose
Prevent regression of cross-repo source coupling by failing fast when any `.csproj` in `greenfield/` references a project outside its own repository root.
## Script Location
- `tools/validate-no-cross-repo-projectrefs.sh`
## Usage
Run from within `greenfield/blueprint-platform`:
```bash
./tools/validate-no-cross-repo-projectrefs.sh
```
Run from the workspace root:
```bash
greenfield/blueprint-platform/tools/validate-no-cross-repo-projectrefs.sh
```
## Behavior
- Exit code `0`: no cross-repo `ProjectReference` entries found.
- Exit code `1`: one or more violations were found and listed.
## Enforcement Guidance
- Execute this guard before merge to `development`.
- Keep only intra-repo `ProjectReference` entries.
- Use package references for cross-repo consumption.