<!-- nx configuration start-->
<!-- Leave the start & end comments to automatically receive updates. -->

# General Guidelines for working with Nx

- For navigating/exploring the workspace, invoke the `nx-workspace` skill first - it has patterns for querying projects, targets, and dependencies
- When running tasks (for example build, lint, test, e2e, etc.), always prefer running the task through `nx` (i.e. `nx run`, `nx run-many`, `nx affected`) instead of using the underlying tooling directly
- Prefix nx commands with the workspace's package manager (e.g. `pnpm nx build`, `npm exec nx test`) - avoids using globally installed CLI
- You have access to the Nx MCP server and its tools, use them to help the user
- For Nx plugin best practices, check `node_modules/@nx/<plugin>/PLUGIN.md`. Not all plugins have this file - proceed without it if unavailable.
- NEVER guess CLI flags - always check nx_docs or `--help` first when unsure

## Scaffolding & Generators

- For scaffolding tasks (creating apps, libs, project structure, setup), ALWAYS invoke the `nx-generate` skill FIRST before exploring or calling MCP tools

## When to use nx_docs

- USE for: advanced config options, unfamiliar flags, migration guides, plugin configuration, edge cases
- DON'T USE for: basic generator syntax (`nx g @nx/react:app`), standard commands, things you already know
- The `nx-generate` skill handles generator discovery internally - don't call nx_docs just to look up generator syntax

<!-- nx configuration end-->

## Workspace agents (shared across Cursor / Windsurf / CLI agents)

- Canonical rules, skills, workflows, and ADT command docs: **`.agents/`** — start at [`.agents/repo-guide.md`](.agents/repo-guide.md).
- Repository layout, MCP↔CLI coupling, rules index, and package guides: [`.agents/repo-guide.md`](.agents/repo-guide.md).
- Cursor-specific discovery only: **`.cursor/`** (slash commands → `.agents/workflows/`, thin skill stubs → `.agents/skills/`).
- Claude Code native layer: **`.claude/`** — same delegation pattern; keep hooks/settings here (see [`.agents/README.md`](.agents/README.md)).
- Multi-runtime registry: **`.agents/agents/`** (`cursor-ide.md`, `claude-code.md`).
- Legacy Windsurf paths under **`.windsurf/`** are redirect stubs; extend `.agents/` instead.
