docs(agents): add docker-prep.sh canonical-template warning (Phase B7-4)

Mirror the existing .npmrc managed-template pattern: scripts/docker-prep.sh
plus its _docker-prep-*.js helpers are now managed by a canonical template
in learning_ai_common_plat. Adds a sibling AGENTS.md section pointing to
the template, sync, drift-check, and docker-doctor lint commands so future
agents know not to hand-edit copies.

Refs: docker-build-optimization-roadmap.md §B7-4
This commit is contained in:
saravanakumardb1 2026-05-27 04:14:53 -07:00
parent b23a601431
commit 6b3bd0a84d

View File

@ -246,6 +246,17 @@ learning_ai_notes/
- **Sync:** `cd ../learning_ai/learning_ai_common_plat && bash scripts/sync-npmrc.sh` - **Sync:** `cd ../learning_ai/learning_ai_common_plat && bash scripts/sync-npmrc.sh`
- **Key rule:** Never hardcode `gitea.bytelyst.com` — use `${GITEA_NPM_HOST:-localhost}:3300` (SSH tunnel on corp network) - **Key rule:** Never hardcode `gitea.bytelyst.com` — use `${GITEA_NPM_HOST:-localhost}:3300` (SSH tunnel on corp network)
### docker-prep.sh — NEVER edit directly
**`scripts/docker-prep.sh` and its `_docker-prep-*.js` helpers are managed by a canonical template in `learning_ai_common_plat`.** Never hand-edit — drift across 9 repos compounds linearly.
- **Template:** `../learning_ai_common_plat/scripts/docker-prep.template.sh`
- **Helpers:** `../learning_ai_common_plat/scripts/_docker-prep-{inject,strip}.js`
- **Sync:** `cd ../learning_ai_common_plat && bash scripts/sync-docker-prep.sh`
- **Drift check (CI):** `bash scripts/check-docker-prep-drift.sh`
- **Lint:** `bash scripts/docker-doctor.sh` (or `make doctor` for both gitea-doctor + docker-doctor)
### Local package source toggle ### Local package source toggle
NoteLett defaults to local `@bytelyst/*` packages from `../learning_ai/learning_ai_common_plat` through `.pnpmfile.cjs`; do not use Gitea unless explicitly needed. NoteLett defaults to local `@bytelyst/*` packages from `../learning_ai/learning_ai_common_plat` through `.pnpmfile.cjs`; do not use Gitea unless explicitly needed.