Shared release workflow
Use this skill when you are asked to:
- •Add new exports to
shared/and use them inbackend/. - •Bump
@piquet-h/sharedand ensure backend installs from the registry. - •Prevent “combined PR touches shared + backend and breaks CI” situations.
Rules
- •Never change backend to depend on
file:../shared. - •If behavior requires new shared exports, split into two PRs:
- •PR 1:
shared/only (bump version, publish) - •PR 2: backend integrates the published version
- •PR 1:
Helper script
- •
scripts/detect-cross-package.mjs— detects when the current diff touches bothshared/andbackend/.
Use this script as an early warning. It is not a replacement for code review.
Last reviewed: 2026-01-15