# Typescript Monorepo

> Typescript Monorepo is an Agent Skill for development published in the pierrecomputer/pierre repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when adding or changing packages/apps, TypeScript configs, workspace dependencies, package references, exports, or monorepo project-reference relationships.

- Skill name: `typescript-monorepo`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/pierrecomputer/pierre/blob/HEAD/.agents/skills/typescript-monorepo/SKILL.md
- Repository: pierrecomputer/pierre (5,411 GitHub stars when collected)

## SKILL.md

# TypeScript Monorepo

## TypeScript

Use TypeScript everywhere practical. Compiler settings are intentionally fairly
strict.

- Shared compiler options live in `tsconfig.options.json`.
- Root `tsconfig.json` manages project references across the monorepo.
- Typechecking uses `tsgo` and runs through moon: `moonx <project>:typecheck`
  (moon builds workspace dependencies first, since types resolve through each
  dependency's built dist).

## Project References

When adding a new package or app:

- Add it to the root `tsconfig.json` references.
- Ensure its local `tsconfig.json` follows existing package/app patterns.
- Give it a `moon.yml` (language, layer, tags, and any project-specific tasks);
  shared tasks come from `.moon/tasks/*.yml` via tags or project language.

When one workspace package depends on another:

- Add the dependency as `workspace:*` in the consuming package.
- Add the dependency to the consuming package's TypeScript `references` block
  when needed for accurate and fast typechecking.

## Workspace Dependencies

Use the `pnpm-workspace.yaml` catalog rules from `tooling-and-dependencies` for
external packages. Use `workspace:*` for internal package dependencies.

If a package is published, review its `exports`, `typesVersions`, `files`, peer
dependencies, and its moon `prepublish` task chain before changing public
entrypoints or dependency ranges.

---

Source: https://www.openparable.com/skill/development/typescript-monorepo (OpenParable). Cite the canonical URL above.
