Cursor Rules Reference

January 31, 2026 ยท View on GitHub

This document provides a comprehensive reference for all available Cursor rules in NeMo Agent Toolkit. Each rule includes a purpose description, usage prompt, and practical examples.

Foundation Rules

General Development Guidelines

Cursor Rule file: .cursor/rules/general.mdc Purpose: Overarching standards for all source, test, documentation, and CI files.

Prompt:

Create a new Python function with proper type hints, docstrings, and formatting that follows NeMo Agent Toolkit coding standards.

Capabilities:

  • Project structure guidelines
  • Code formatting standards
  • Type hint requirements
  • Documentation standards
  • Testing practices
  • CI/CD compliance

Cursor Rules Management

Cursor Rule file: .cursor/rules/cursor-rules.mdc Purpose: Guidelines for creating and managing cursor rules themselves.

Prompt:

Create a new Cursor rule for creating a new NeMo Agent workflow

Capabilities:

  • Rule file naming conventions
  • Directory structure for rules
  • Documentation standards for rules
  • Best practices for rule descriptions

Setup and Installation Rules

General Setup Guidelines

Cursor Rule file: .cursor/rules/nat-setup/general.mdc Purpose: Guidance for NeMo Agent Toolkit installation, setup, and environment configuration.

Prompt:

Help me set up NeMo Agent Toolkit development environment with all required dependencies and configurations.

Capabilities:

  • Installation troubleshooting
  • Environment setup guidance
  • Dependency management
  • Initial configuration steps

Related Documentation: Installation Guide

NeMo Agent Toolkit Installation

Cursor Rule file: .cursor/rules/nat-setup/nat-toolkit-installation.mdc Purpose: Detailed installation procedures and setup guidance.

Prompt:

Install NeMo Agent Toolkit with all plugins and verify the installation is working correctly.

Related Documentation: Installation Guide

CLI Command Rules

General CLI Guidelines

Cursor Rule file: .cursor/rules/nat-cli/general.mdc Purpose: Guidance for all NeMo Agent CLI commands, operations, and functionality.

Prompt:

Show me how to use CLI commands to manage workflows

Capabilities:

  • CLI command reference
  • Common usage patterns
  • Error troubleshooting
  • Best practices for CLI operations

Related Documentation: CLI Reference

NeMo Agent Workflow Commands

Cursor Rule file: .cursor/rules/nat-cli/nat-workflow.mdc Purpose: Creating, reinstalling, and deleting NeMo Agent workflows.

Prompt:

Create a workflow named demo_workflow in examples directory with description "Demo workflow for testing features".

Related Documentation: CLI Reference - Workflow Commands

NeMo Agent Run and Serve Commands

Cursor Rule file: .cursor/rules/nat-cli/nat-run-serve.mdc Purpose: Running, serving, and executing NeMo Agent workflows.

Prompt:

Run my workflow locally for testing and then serve it as an API endpoint on port 8080.

Related Documentation:

NeMo Agent Evaluation Commands

Cursor Rule file: .cursor/rules/nat-cli/nat-eval.mdc Purpose: Evaluating workflow performance and quality.

Prompt:

Evaluate my workflow performance using a test dataset with accuracy and precision metrics.

Related Documentation:

NeMo Agent Info Commands

Cursor Rule file: .cursor/rules/nat-cli/nat-info.mdc Purpose: Getting information about NeMo Agent components and system status.

Prompt:

Show me system information and list all available NeMo Agent components with their details.

Related Documentation: CLI Reference - Info Commands

Workflow Development Rules

General Workflow Guidelines

Cursor Rule file: .cursor/rules/nat-workflows/general.mdc Purpose: Guidance for NeMo Agent workflows, functions, and tools.

Capabilities:

  • Workflow architecture patterns
  • Function and tool integration
  • Best practices for workflow design
  • Documentation references

Related Documentation:

Adding Functions to Workflows

Cursor Rule file: .cursor/rules/nat-workflows/add-functions.mdc Purpose: Implementing, adding, creating, or modifying functions within NeMo Agent workflows.

Prompt:

Add a text processing function to my workflow that splits text into sentences and counts words.

Related Documentation:

Adding Tools to Workflows

Cursor Rule file: .cursor/rules/nat-workflows/add-tools.mdc Purpose: Adding, integrating, implementing, or configuring tools for NeMo Agent workflows.

Prompt:

Integrate a web search tool into my workflow that can fetch and process search results from the internet.

Related Documentation: Adding Tools Tutorial

Agent Rules

Agent Integration and Selection

Cursor Rule file: .cursor/rules/nat-agents/general.mdc Purpose: Guidelines for integrating or selecting ReAct, Tool-Calling, Reasoning, or ReWOO agents within NeMo Agent workflows.

Prompt:

Integrate ReAct agent to the workflow

Related Documentation: Agent Docs

Quick Reference

Rule CategoryCursor Rule filePrimary Use Case
FoundationgeneralCode quality and standards
Foundationcursor-rulesManaging cursor rules
Setupnat-setup/generalEnvironment setup
Setupnat-setup/nat-toolkit-installationInstallation procedures
CLInat-cli/generalGeneral CLI usage
CLInat-cli/nat-workflowWorkflow management
CLInat-cli/nat-run-serveRunning and serving
CLInat-cli/nat-evalPerformance evaluation
CLInat-cli/nat-infoSystem information
Workflownat-workflows/generalWorkflow design
Workflownat-workflows/add-functionsFunction development
Workflownat-workflows/add-toolsTool integration
Agentsnat-agents/generalAgent selection and integration

Usage Tips

  • Copy Exact Prompts: Use the provided prompts exactly as shown for best results
  • Customize for Your Needs: Modify prompts with specific project details
  • Chain Rules: Use multiple rules together for complex development tasks
  • Reference Documentation: Follow the "Related Documentation" links for deeper understanding
  • Test Incrementally: Apply one rule at a time and test the results

For tutorials and examples on using these rules, refer to Build a Demo Agent Workflow Using Cursor Rules for NeMo Agent Toolkit.