blueprint-platform/docs/architecture/workspace-cross-repo-reference-guard.md
2026-03-31 17:56:30 -06:00

42 lines
1.1 KiB
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.
## Related Governance Docs
- `docs/architecture/stage40-43-execution-guardrails.md`
- `docs/architecture/stage40-43-execution-guardrails.puml`
- `docs/architecture/stage44-48-shared-restaurant-lifecycle-guardrails.md`
- `docs/architecture/stage44-48-shared-restaurant-lifecycle-guardrails.puml`