Nx AI Plugin

[hakalb]

No description provided.

[bolt-new-by-stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[Copilot]

Pull request overview

This PR introduces a new publishable Nx plugin package (@cdwr/nx-ai) that adds an analyze executor powered by the Anthropic SDK (Claude) plus generators to wire the executor into projects/workspaces. It also reorganizes/expands internal AI + Nx “skills” documentation and configuration used by agent tooling.

Changes:

• Add packages/nx-ai (executor + generators + plugin entry points) and pin/lock @anthropic-ai/sdk.
• Add/replace AI agent documentation/config (move prior docs/ai/* into root CLAUDE.md / AGENTS.md, plus .claude/* settings/task docs).
• Add a set of .github/skills/* references and scripts (including monitor-ci decision/state scripts).

Reviewed changes

Copilot reviewed 51 out of 56 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
pnpm-lock.yaml	Locks workspace dependency changes including @anthropic-ai/sdk and newly added workspace package importers.
packages/nx-ai/tsconfig.spec.json	Adds Jest TS config for nx-ai tests.
packages/nx-ai/tsconfig.lib.json	Adds library TS config for building/publishing nx-ai.
packages/nx-ai/tsconfig.json	Adds solution-style TS project references for nx-ai.
packages/nx-ai/test-setup.ts	Adds Jest setup workaround mocking Prettier.
packages/nx-ai/src/utils/versions.ts	Centralizes the minimum compatible @anthropic-ai/sdk version range.
packages/nx-ai/src/utils/is-plugin-inference-enabled.ts	Adds helper to decide whether to register the Nx inference plugin.
packages/nx-ai/src/plugins/plugin.ts	Adds Nx plugin entrypoint (createNodesV2) (currently no inferred targets).
packages/nx-ai/src/generators/init/schema.json	Defines init generator schema.
packages/nx-ai/src/generators/init/schema.d.ts	Defines init generator TS types.
packages/nx-ai/src/generators/init/libs/update-dependencies.ts	Adds logic to add @anthropic-ai/sdk to workspace devDependencies.
packages/nx-ai/src/generators/init/init.ts	Adds init generator to install deps and optionally register the plugin.
packages/nx-ai/src/generators/add/schema.json	Defines add generator schema (wire analyze target into a project).
packages/nx-ai/src/generators/add/schema.d.ts	Defines add generator TS types.
packages/nx-ai/src/generators/add/add.ts	Implements add generator that updates project.json targets and calls init.
packages/nx-ai/src/executors/analyze/schema.json	Defines analyze executor schema/options.
packages/nx-ai/src/executors/analyze/schema.d.ts	Defines analyze executor TS types.
packages/nx-ai/src/executors/analyze/analyze.ts	Implements the Claude-powered analysis executor (file collection, prompt, output/report).
packages/nx-ai/project.json	Adds Nx project configuration for building the new plugin package.
packages/nx-ai/plugin.ts	Exposes plugin entry (createNodesV2) from the package root for Nx plugin loading.
packages/nx-ai/package.json	Declares publishable package metadata and peerDependencies for the plugin.
packages/nx-ai/jest.config.ts	Adds Jest config for nx-ai package tests.
packages/nx-ai/index.ts	Adds public exports for generators/types and utility constants.
packages/nx-ai/generators.json	Registers add and internal init generators.
packages/nx-ai/executors.json	Registers the analyze executor.
packages/nx-ai/eslint.config.mjs	Adds package-level ESLint config and Nx plugin checks.
packages/nx-ai/README.md	Adds end-user documentation for installation, setup, and usage of the plugin.
package.json	Adds @anthropic-ai/sdk to root devDependencies for workspace development.
docs/ai/RULES.md	Removes prior AI rules doc (content moved/restructured elsewhere).
docs/ai/README.md	Removes prior AI docs index (content moved/restructured elsewhere).
docs/ai/CONTEXT.md	Removes prior AI context doc (content moved/restructured elsewhere).
docs/ai/AGENTS.md	Removes prior AI agents doc (content moved/restructured elsewhere).
CLAUDE.md	Adds consolidated Nx/dev conventions and broader repo context for agent workflows.
AGENTS.md	Adds consolidated Nx guidance for agent workflows at repo root.
.gitignore	Ignores additional Claude/Nx-agent working directories/files.
.github/skills/nx-workspace/references/AFFECTED.md	Adds reference doc for Nx affected project queries.
.github/skills/nx-workspace/SKILL.md	Adds Nx workspace exploration skill doc.
.github/skills/nx-run-tasks/SKILL.md	Adds Nx task execution skill doc.
.github/skills/nx-plugins/SKILL.md	Adds Nx plugin discovery/install skill doc.
.github/skills/nx-import/references/VITE.md	Adds Vite-specific Nx import reference doc.
.github/skills/nx-import/references/TURBOREPO.md	Adds Turborepo-to-Nx import/migration reference doc.
.github/skills/nx-import/references/NEXT.md	Adds Next.js-specific Nx import reference doc.
.github/skills/nx-import/references/JEST.md	Adds Jest-specific Nx import/testing reference doc.
.github/skills/nx-import/references/GRADLE.md	Adds Gradle-specific Nx import reference doc.
.github/skills/nx-import/references/ESLINT.md	Adds ESLint-specific Nx import reference doc.
.github/skills/nx-import/SKILL.md	Adds Nx import skill doc (strategy + pitfalls).
.github/skills/nx-generate/SKILL.md	Adds Nx generator usage skill doc.
.github/skills/monitor-ci/scripts/ci-state-update.mjs	Adds deterministic CI monitor state/budget script.
.github/skills/monitor-ci/scripts/ci-poll-decide.mjs	Adds deterministic CI polling decision engine.
.github/skills/monitor-ci/references/fix-flows.md	Adds detailed CI fix flow reference doc.
.github/skills/monitor-ci/SKILL.md	Adds monitor-ci orchestration skill doc.
.github/skills/link-workspace-packages/SKILL.md	Adds skill doc for workspace dependency linking.
.github/prompts/monitor-ci.prompt.md	Adds prompt file for monitor-ci command behavior.
.github/agents/ci-monitor-subagent.agent.md	Adds subagent spec for CI monitoring MCP calls.
.claude/tasks/nx-ai-plugin.md	Adds task doc defining nx-ai plugin scope and non-goals.
.claude/settings.json	Adds Claude tool/plugin marketplace configuration.

Files not reviewed (1)

• pnpm-lock.yaml: Language not supported

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit c7a9a47

Command	Status	Duration	Result
nx e2e nx-payload-e2e -c skip-docker	✅ Succeeded	10m 3s	View ↗
nx affected -t integration-test -c ci	✅ Succeeded	2m 6s	View ↗
nx affected -t e2e -c ci --exclude nx-payload-e2e	✅ Succeeded	<1s	View ↗
nx affected -t lint,test,build -c ci	✅ Succeeded	8m 6s	View ↗
nx-cloud record -- nx format:check	✅ Succeeded	8s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-03-28 09:29:15 UTC

[sentry]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 72.77%. Comparing base (4104e9a) to head (c7a9a47).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #411   +/-   ##
=======================================
  Coverage   72.77%   72.77%           
=======================================
  Files          84       84           
  Lines        3816     3816           
  Branches      406      406           
=======================================
  Hits         2777     2777           
  Misses       1034     1034           
  Partials        5        5           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.