Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(core): adds feature for LLM enhancing #30072

Merged
merged 1 commit into from
Feb 17, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions docs/generated/manifests/menus.json
Original file line number Diff line number Diff line change
Expand Up @@ -283,6 +283,14 @@
"children": [],
"disableCollapsible": false
},
{
"name": "Enhance Your LLM",
"path": "/features/enhance-AI",
"id": "enhance-AI",
"isExternal": false,
"children": [],
"disableCollapsible": false
},
{
"name": "Explore Your Workspace",
"path": "/features/explore-graph",
Expand Down Expand Up @@ -399,6 +407,14 @@
"children": [],
"disableCollapsible": false
},
{
"name": "Enhance Your LLM",
"path": "/features/enhance-AI",
"id": "enhance-AI",
"isExternal": false,
"children": [],
"disableCollapsible": false
},
{
"name": "Explore Your Workspace",
"path": "/features/explore-graph",
Expand Down
22 changes: 22 additions & 0 deletions docs/generated/manifests/nx.json
Original file line number Diff line number Diff line change
Expand Up @@ -383,6 +383,17 @@
"path": "/features/cache-task-results",
"tags": ["cache-task-results"]
},
{
"id": "enhance-AI",
"name": "Enhance Your LLM",
"description": "",
"mediaImage": "",
"file": "shared/features/enhance-AI",
"itemList": [],
"isExternal": false,
"path": "/features/enhance-AI",
"tags": ["AI"]
},
{
"id": "explore-graph",
"name": "Explore Your Workspace",
Expand Down Expand Up @@ -543,6 +554,17 @@
"path": "/features/cache-task-results",
"tags": ["cache-task-results"]
},
"/features/enhance-AI": {
"id": "enhance-AI",
"name": "Enhance Your LLM",
"description": "",
"mediaImage": "",
"file": "shared/features/enhance-AI",
"itemList": [],
"isExternal": false,
"path": "/features/enhance-AI",
"tags": ["AI"]
},
"/features/explore-graph": {
"id": "explore-graph",
"name": "Explore Your Workspace",
Expand Down
9 changes: 9 additions & 0 deletions docs/generated/manifests/tags.json
Original file line number Diff line number Diff line change
Expand Up @@ -257,6 +257,15 @@
"path": "/nx-api/nx/documents/reset"
}
],
"AI": [
{
"description": "",
"file": "shared/features/enhance-AI",
"id": "enhance-AI",
"name": "Enhance Your LLM",
"path": "/features/enhance-AI"
}
],
"explore-graph": [
{
"description": "",
Expand Down
6 changes: 6 additions & 0 deletions docs/map.json
Original file line number Diff line number Diff line change
Expand Up @@ -98,6 +98,12 @@
"tags": ["cache-task-results"],
"file": "shared/features/cache-task-results"
},
{
"name": "Enhance Your LLM",
"id": "enhance-AI",
"tags": ["AI"],
"file": "shared/features/enhance-AI"
},
{
"name": "Explore Your Workspace",
"id": "explore-graph",
Expand Down
69 changes: 69 additions & 0 deletions docs/shared/features/enhance-AI.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
# Enhance Your LLM

{% youtube src="https://youtu.be/RNilYmJJzdk?si=et_6zWMMxJPa7lp2" title="We Just Made Your LLM Way Smarter!" /%}

Nx's LLM enhancement feature makes your AI assistant significantly smarter by providing it with rich metadata about your workspace structure, project relationships, and architectural decisions. While LLMs are powerful tools for boosting development productivity, their effectiveness depends entirely on the context they have access to. Nx bridges this gap by:

- Providing **architectural awareness** about your workspace structure and project relationships
- Feeding information about **project ownership and team responsibilities**
- Sharing knowledge about **available tasks** and their configuration
- Including details about **technology stacks** and project types
- Supplying **Nx documentation** context for better assistance

## How It Works

![Nx Console LLM Enhancement](/shared/images/nx-enhance-llm-illustration.avif)

Nx maintains comprehensive metadata about your workspace to power features like [caching](/features/cache-task-results) and [distributed task execution](/ci/features/distribute-task-execution). Nx Console, as an editor extension, hooks into this rich metadata, post-processes it, and feeds it directly to your LLM (currently supporting GitHub Copilot). This enables your LLM to:

- Understand the complete workspace structure, including applications and libraries
- Know how different projects are connected and their dependency relationships
- Recognize project technology stacks and available tasks
- Access information about project ownership and team responsibilities
- Utilize Nx documentation to provide more accurate assistance

This enhanced context allows your LLM to move beyond simple file-level operations to understand your workspace at an architectural level, making it a more effective development partner.

To **enable LLM enhancement in your workspace**:

1. Install or update [Nx Console](/getting-started/editor-setup) in VS Code
2. Ensure you have GitHub Copilot installed and configured
3. Start using Copilot in your Nx workspace by typing `@nx` at the beginning of your prompt - this will automatically provide the enhanced context

{% callout type="note" title="Current Support" %}
LLM enhancement is currently available for VS Code with GitHub Copilot. Support for additional editors and LLM providers is planned for future releases.
{% /callout %}

## Key Benefits

- **Architectural Understanding** - Your LLM gains deep insight into your workspace structure, identifying applications, libraries, and their relationships. It understands project categorization through tags and can make informed suggestions about feature implementation.

- **Team and Ownership Awareness** - Access to project ownership information allows the LLM to identify relevant team members for collaboration and provide guidance on who to consult for specific components.

- **Task and Generator Knowledge** - Enhanced context about workspace tasks and generators enables the LLM to suggest appropriate commands, help set up new projects, and provide guidance on available tasks and their configuration.

Here are some example queries:

Ask your LLM about your workspace structure and get detailed, accurate responses:

![Example of LLM understanding project structure](/blog/images/articles/nx-ai-example-project-data.avif)

Get informed suggestions about where to implement new functionality based on existing code:

![Example of LLM providing implementation guidance](/blog/images/articles/nx-ai-example-data-access-feature.avif)

Identify relevant team members and ownership information:

![Example of LLM providing ownership information](/blog/images/articles/nx-ai-example-ownership.avif)

Get assistance with creating new projects using Nx generators:

![Example of LLM helping with code generation](/blog/images/articles/nx-ai-example-generate-code.avif)

## Learn More

For a deeper dive into how Nx's monorepo approach enhances AI capabilities and makes your workspace future-proof, read our blog post [Nx Just Made Your LLM Way Smarter](/blog/nx-just-made-your-llm-smarter). The post explores:

- How monorepos break down barriers for both teams and LLMs
- Why Nx's metadata is a goldmine for enhancing AI capabilities
- How this positions your workspace for future AI advancements
Binary file not shown.
1 change: 1 addition & 0 deletions docs/shared/reference/sitemap.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
- [Features](/features)
- [Run Tasks](/features/run-tasks)
- [Cache Task Results](/features/cache-task-results)
- [Enhance Your LLM](/features/enhance-AI)
- [Explore Your Workspace](/features/explore-graph)
- [Generate Code](/features/generate-code)
- [Automate Updating Dependencies](/features/automate-updating-dependencies)
Expand Down