# Wrdn Package Boundaries

> Preserve workspace package boundaries. Use when lint flags relative imports that cross package roots.

- Skill: `usefulsoftwareco/wrdn-package-boundaries` (Agent Skill)
- Install (CLI): `npx skillmds@latest add usefulsoftwareco/wrdn-package-boundaries`
- Raw SKILL.md: https://api.skillmd.com/api/skills/usefulsoftwareco/wrdn-package-boundaries/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: usefulsoftwareco (https://skillmd.com/u/usefulsoftwareco)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/usefulsoftwareco/wrdn-package-boundaries

---


Workspace packages should import each other through package exports, not relative paths.

## Fix Shape

- Replace cross-package relative imports with the target package name.
- If the needed module is not exported, add the smallest package export that matches the package's public surface.
- Keep relative imports only within the same package root.
- Do not reach into another package's private source tree from an app or package.

## Good

```ts
import { createExecutor } from "@executor-js/sdk";
```

## Bad

```ts
import { createExecutor } from "../../../core/sdk/src";
```