Agent-Skills.md

Agent Skills: Package Architect

Design and maintain TypeScript packages in a monorepo, including exports and build configuration.

UncategorizedID: shipshitdev/library/package-architect

Repository

shipshitdev/library
shipshitdev
151

Install this agent skill to your local

pnpm dlx add-skill https://github.com/shipshitdev/library/tree/HEAD/bundles/workspace/skills/package-architect

Skill Files

Browse the full folder contents for package-architect.

Download Skill

Loading file tree…

bundles/workspace/skills/package-architect/SKILL.md

Skill Metadata

Name
package-architect
Description
Design and maintain TypeScript packages in a monorepo, including exports and build configuration. Use when creating or restructuring monorepo packages, defining package.json exports, or setting up tsconfig references.

Package Architect

Design reusable TypeScript packages in monorepos (Bun, pnpm, or npm workspaces).

When to Use

  • Creating new packages or restructuring monorepo packages
  • Defining package.json exports
  • Setting up tsconfig references

Core Principles

  • Single responsibility per package.
  • Stable public APIs with clear exports.
  • Avoid inline interfaces; centralize types.
  • Keep build outputs separated from sources.

Package Structure (Example)

packages/
  utils/
    src/
    package.json
    tsconfig.json
  api-client/
    src/
    package.json
    tsconfig.json

Exports Pattern (Example)

{
  "name": "@scope/utils",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "exports": {
    ".": {
      "import": "./dist/index.js",
      "types": "./dist/index.d.ts"
    }
  }
}

TypeScript References

  • Use project references for inter-package dependencies.
  • Prefer path aliases for local dev imports.
  • Keep tsconfig base shared across packages.

Checklist

  • Exports map matches intended public API
  • Types build alongside JS output
  • No circular dependencies
  • Consistent lint and tsconfig settings