# Nx Workspace Patterns

> Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.

Source: https://skillsagentes.com/skills/wshobson/agents/nx-workspace-patterns
Repository: https://github.com/wshobson/agents
Author: wshobson
License: MIT
Updated: hace 2 meses
Context cost: 41 tok installed, 571 tok once triggered, 2.8k tok with every bundled file
Bundle: 2 files, 11 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add wshobson/agents --skill nx-workspace-patterns --agent claude-code
```

## What it does

- Estructura el workspace en apps/, libs/ y tools/, con nx.json y workspace.json
- Define tipos de librería (feature, ui, data-access, util, shell) para organizar el código
- Configura límites entre proyectos (module boundaries) mediante tags
- Optimiza CI usando comandos affected y caching remoto

## Use it when

- Al configurar un nuevo workspace de Nx
- Al definir límites entre proyectos
- Al optimizar CI con comandos affected
- Al implementar caching remoto o migrar a Nx

## What triggers it

- "Ayúdame a configurar un monorepo Nx nuevo"
- "¿Cómo organizo mis libs en Nx con feature, ui y data-access?"
- "Necesito optimizar mi CI usando comandos affected en Nx"
- "Configura los module boundaries en mi workspace Nx"

## Before you install

- Requiere un workspace Nx existente o en creación; incluye plantillas adicionales en references/details.md.

## Files

- SKILL.md — 2 KB
- references/details.md — 9 KB

## SKILL.md

Reproduced verbatim from wshobson/agents under MIT. This section is the upstream document and is in English.

# Nx Workspace Patterns

Production patterns for Nx monorepo management.

## When to Use This Skill

- Setting up new Nx workspaces
- Configuring project boundaries
- Optimizing CI with affected commands
- Implementing remote caching
- Managing dependencies between projects
- Migrating to Nx

## Core Concepts

### 1. Nx Architecture

```
workspace/
├── apps/              # Deployable applications
│   ├── web/
│   └── api/
├── libs/              # Shared libraries
│   ├── shared/
│   │   ├── ui/
│   │   └── utils/
│   └── feature/
│       ├── auth/
│       └── dashboard/
├── tools/             # Custom executors/generators
├── nx.json            # Nx configuration
└── workspace.json     # Project configuration
```

### 2. Library Types

| Type            | Purpose                          | Example             |
| --------------- | -------------------------------- | ------------------- |
| **feature**     | Smart components, business logic | `feature-auth`      |
| **ui**          | Presentational components        | `ui-buttons`        |
| **data-access** | API calls, state management      | `data-access-users` |
| **util**        | Pure functions, helpers          | `util-formatting`   |
| **shell**       | App bootstrapping                | `shell-web`         |

## Templates and detailed worked examples

Full template library and detailed worked examples live in `references/details.md`. Read that file when you need the concrete templates.

## Best Practices

### Do's

- **Use tags consistently** - Enforce with module boundaries
- **Enable caching early** - Significant CI savings
- **Keep libs focused** - Single responsibility
- **Use generators** - Ensure consistency
- **Document boundaries** - Help new developers

### Don'ts

- **Don't create circular deps** - Graph should be acyclic
- **Don't skip affected** - Test only what changed
- **Don't ignore boundaries** - Tech debt accumulates
- **Don't over-granularize** - Balance lib count

---

Skills Agentes — https://skillsagentes.com/skills/wshobson/agents/nx-workspace-patterns