# `tools/validators/`

Validators run by `pnpm validate`. Phase 1 ships lightweight stubs that grow into full enforcement in Phase 7.

| File                     | Purpose                                                                      | Phase                                         |
| ------------------------ | ---------------------------------------------------------------------------- | --------------------------------------------- |
| `check-arch.mjs`         | Verifies declared layer folders exist (or note pending)                      | 1 (replaced in 7 by dependency-cruiser)       |
| `check-deps.mjs`         | Scans workspace `package.json` files for required fields and banned packages | 1 (extended in 7)                             |
| `check-repo-map.mjs`     | Fails if top-level folders drift from `repository-map.json`                  | 1                                             |
| `repository-map.json`    | Declared top-level folder index (one-line description each)                  | 1 (regenerated by `pnpm generate:repo-map`)   |
| `module-boundaries.json` | Declared allowed import/dep directions across layers                         | 1 (consumed by dependency-cruiser in Phase 7) |
| `feature-ownership.json` | Folder → team mapping (wired into CODEOWNERS in Phase 8)                     | 1                                             |
