nx-workspace-patterns

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

1. Zainstaluj umiejętność w swoim agencie Claude lub Copilot, dodając ją do konfiguracji skills. Umiejętność będzie dostępna jako plugin w sekcji developer-essentials.

2. Przygotuj strukturę workspace'u zgodnie z wzorcem: utwórz katalogi apps/ dla aplikacji deployowalnych, libs/ dla bibliotek wspólnych, tools/ dla custom executorów i generatorów. W libs/ organizuj biblioteki według typu (feature/, ui/, data-access/, util/, shell/).

3. Skonfiguruj plik nx.json w głównym katalogu workspace'u. Ustaw npmScope na nazwę Twojej organizacji, zdefiniuj defaultBase dla poleceń affected (zazwyczaj "main"), a następnie skonfiguruj tasksRunnerOptions z cacheable operations (build, lint, test, e2e, build-storybook) i poziomem paralelizacji.

4. Zdefiniuj targetDefaults dla poszczególnych zadań — dla build ustaw dependsOn na "^build" aby budować zależności, dla test i lint skonfiguruj inputs aby kontrolować cache'owanie na podstawie zmian w kodzie.

5. Wdrażaj polecenia affected w CI/CD — użyj nx affected:build, nx affected:test i nx affected:lint aby budować i testować tylko projekty zmienione w danym pull request'cie. To znacznie przyspiesza procesy CI.

6. Monitoruj zależności między projektami i utrzymuj czystość granic — używaj umiejętności do weryfikacji, że projekty w libs/ nie importują z apps/, a biblioteki są organizowane według ich roli (feature dla logiki biznesowej, ui dla komponentów, data-access dla API).