자세한 설명
같은 저장소에 있는 UI 라이브러리 등을 앱에서 가져오지만 사용하는 쪽에 의존성이 제대로 선언되지 않은 경우에 적합합니다. 먼저 어떤 패키지가 어떤 로컬 패키지를 사용하는지 구분합니다. 편집기의 경로 별칭으로 파일이 보인다고 설치나 실행 시의 패키지 해석까지 올바른 것은 아닙니다.
원문은 npm, pnpm, Yarn, Bun의 작업 방식을 다룹니다. 루트 packageManager, 잠금 파일, 워크스페이스 설정에 따라 선택합니다. pnpm 예제는 --filter로 사용 패키지를 지정하고 --workspace로 로컬 제공자를 요구합니다. 변경 후에는 의존성이 추가된 위치와 잠금 파일 차이를 확인해야 합니다.
검증 방식은 설치 모드에 따라 달라집니다. Yarn PnP는 node_modules 없이 .pnp.cjs로 해석할 수 있어 심볼릭 링크가 없다는 이유만으로 실패라고 할 수 없습니다. 연결 후에도 import가 실패하면 exports와 빌드 산출물을 확인하고 해당 프로젝트의 타입 검사나 빌드를 실행해야 합니다.
준비할 사항
- 사용·제공 패키지 이름과 package.json, 실패한 import 구문.
- 패키지 관리자와 버전, 잠금 파일, 워크스페이스 범위.
예상 결과
- 올바른 사용 패키지에 선언된 로컬 의존성과 해당 설치 상태.
- 의존성 연결, exports, 산출물 문제를 구분한 검증 결과.
사용 순서
- import 관계와 두 패키지의 워크스페이스 포함 여부를 확인합니다.
- 실제 관리자와 버전에 맞는 문법을 선택합니다.
- 사용 패키지에 의존성을 추가하고 매니페스트와 잠금 파일을 검토합니다.
- 활성 linker에 맞게 해석을 확인하고 기존 프로젝트 검사를 실행합니다.
제한 및 확인 사항
- 레지스트리의 같은 이름 패키지가 로컬 제공자와 같다고 가정하지 않습니다.
- Yarn PnP에서는 node_modules 존재를 성공 조건으로 삼지 않습니다.
- 연결 후 오류가 남으면 exports와 필요한 산출물을 확인합니다.
- 코드·이력 이동은 nx-import, Nx 통합 추가는 nx-plugins의 역할입니다.
자주 묻는 질문
Nx가 필수인가요?
검토한 원문은 패키지 관리자의 워크스페이스를 사용하며 Nx나 Nx MCP 서버를 필수 조건으로 선언하지 않습니다. 호환 에이전트와 저장소 정보는 필요합니다.
nrwl/nx의 같은 이름 Skill은 다른 기능인가요?
검토한 두 고정 리비전에서 Skill 디렉터리는 동일합니다. 이 페이지는 nx-ai-agents-config 배포를 설명합니다. 기존 설정의 출처를 선택하고 추가 기능으로 보고 중복 설치하지 않는 편이 맞습니다.
이 절차를 여기서 직접 실행했나요?
아니요. 고정된 Skill과 공식 문서를 읽고 작성한 설명이며, 사용자 저장소에서 실행한 검증 결과는 아닙니다.
이 Skill 설치
Skills CLI로 검증된 GitHub 출처에서 이 Skill을 추가합니다.
npx skills add https://github.com/nrwl/nx-ai-agents-config --skill link-workspace-packages출처 정보
- github.com/nrwl/nx-ai-agents-config/blob/13282936b5f6aa53e3d41ba589a4a2dc0d6f5786/skills/link-workspace-packages/SKILL.md
- github.com/nrwl/nx-ai-agents-config/blob/13282936b5f6aa53e3d41ba589a4a2dc0d6f5786/README.md
- github.com/nrwl/nx/tree/d976a693f12e81402bcbd53d4b04f91974650c04/.agents/skills/link-workspace-packages
- pnpm.io/cli/add
- yarnpkg.com/features/pnp
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Link Workspace Packages
Add dependencies between packages in a monorepo. All package managers support workspaces but with different syntax.
Detect Package Manager
Check whether there's a packageManager field in the root-level package.json.
Alternatively check lockfile in repo root:
pnpm-lock.yaml→ pnpmyarn.lock→ yarnbun.lock/bun.lockb→ bunpackage-lock.json→ npm
Workflow
- Identify consumer package (the one importing)
- Identify provider package(s) (being imported)
- Add dependency using package manager's workspace syntax
- Verify symlinks created in consumer's
node_modules/
pnpm
Uses workspace: protocol - symlinks only created when explicitly declared.
# From consumer directory
pnpm add @org/ui --workspace
# Or with --filter from anywhere
pnpm add @org/ui --filter @org/app --workspaceResult in package.json:
{ "dependencies": { "@org/ui": "workspace:*" } }yarn (v2+/berry)
Also uses workspace: protocol.
yarn workspace @org/app add @org/uiResult in package.json:
{ "dependencies": { "@org/ui": "workspace:^" } }npm
No workspace: protocol. npm auto-symlinks workspace packages.
npm install @org/ui --workspace @org/appResult in package.json:
{ "dependencies": { "@org/ui": "*" } }npm resolves to local workspace automatically during install.
bun
Supports workspace: protocol (pnpm-compatible).
cd packages/app && bun add @org/uiResult in package.json:
{ "dependencies": { "@org/ui": "workspace:*" } }Examples
Example 1: pnpm - link ui lib to app
pnpm add @org/ui --filter @org/app --workspaceExample 2: npm - link multiple packages
npm install @org/data-access @org/ui --workspace @org/dashboardExample 3: Debug "Cannot find module"
- Check if dependency is declared in consumer's
package.json - If not, add it using appropriate command above
- Run install (
pnpm install,npm install, etc.)
Notes
- Symlinks appear in
<consumer>/node_modules/@org/<package> - Hoisting differs by manager:
- npm/bun: hoist shared deps to root
node_modules - pnpm: no hoisting (strict isolation, prevents phantom deps)
- yarn berry: uses Plug'n'Play by default (no
node_modules) - Root
package.jsonshould have"private": trueto prevent accidental publish



