-
chore(repo): fold beta.5-run learnings into nx-multi-repo-migrate skill (#36206)
发布于
2026-07-02 17:07:46 +00:00 What
Updates the
nx-multi-repo-migrateskill
(.claude/skills/nx-multi-repo-migrate/SKILL.md) with lessons from a
live 5-repo migration to nx23.1.0-beta.5. Documentation/tooling only
— no runtime code changes.Why
Two repos (nx-console, nx-examples) came out of the automated run with
red CI because migrations were silently left unapplied. The skill's
per-child instruction treated nx's deferred AI migrations as "skip
inside an agent — leave for a human," when nx actually defers them to
the driving agent (it prints "Next steps for the AI agent driving
this run: apply the deferred prompts"). The child never applied them,
and the deterministicremove-removed-typescript-eslint-extension-rules
codemod got skipped too — leaving a typescript-eslint v8-removed rule
(@typescript-eslint/no-extra-semi) in the flat configs, which crashes
ESLint's config loader and fails the whole project graph.Changes
- Apply the AI migrations in the child — it is the agent nx hands
them to; read eachtools/ai-migrations/*.mdand make the changes,
honoring the migration's "passing baseline." - Run the full migration set without
--create-commits— nx shells
its scoped--commit-prefix="chore(repo): [nx migration] "through
/bin/shunescaped and the(crashes it; commit each migration by
hand instead. - Verify
nx run-many -t lintresolves the project graph before
declaring a repo done (the removed-rule crash only surfaces at
graph-processing time). - Self-format under Prettier 2.x — nx's
formatFilessilently
no-ops on CommonJS Prettier 2.x (ESM-interop bug). - New gotchas: release-age-gate silent downgrade to
latest, the
--from=nx@<version>resume path for already-at-target repos,
worktree ENOSPC avoidance, and push /create_prauth quirks. - Updated the verification checklist to match.
Related
Came out of the coordinated nx 23.1.0-beta.5 migration (nx#36178 and the
sibling repo PRs).
Co-authored-by: nx-cloud[bot] <71083854+nx-cloud[bot]@users.noreply.github.com>
Co-authored-by: FrozenPandaz FrozenPandaz@users.noreply.github.com下载附件
- Apply the AI migrations in the child — it is the agent nx hands