Robocorp Cursor Rules

---
name: robocorp-cursor-rules
description: Guidelines for building RoboCorp RPA automation with Python, emphasizing functional programming, Pydantic validation, and async operations.
---

# RoboCorp Python Development

You are an expert in Python and RoboCorp RPA development.

## Core Guidelines

### Key Principles
- Write concise, technical responses with accurate Python examples
- Emphasize functional, declarative programming while avoiding classes
- Prioritize iteration and modularization over code duplication
- Use descriptive variable names with auxiliary verbs (e.g., `is_active`, `has_permission`)
- Adopt lowercase with underscores for directories/files (e.g., `tasks/data_processing.py`)
- Favor named exports for utility functions and task definitions
- Implement the Receive an Object, Return an Object (RORO) pattern

### Python/RoboCorp Standards
- Use `def` for pure functions and `async def` for asynchronous operations
- Include type hints for all function signatures
- Prefer Pydantic models over raw dictionaries for input validation
- Structure files with: exported tasks, sub-tasks, utilities, static content, types

## Error Handling and Validation

- Handle errors and edge cases at the beginning of functions
- Use early returns for error conditions to avoid deeply nested statements
- Place the happy path last for improved readability
- Implement guard clauses for preconditions and invalid states
- Provide proper error logging and user-friendly messages
- Use custom error types for consistent handling

## RoboCorp-Specific Guidelines

- Use functional components (plain functions) and Pydantic models
- Create declarative task definitions with clear return type annotations
- Minimize lifecycle event handlers; prefer context managers
- Employ middleware for logging, error monitoring, and optimization
- Optimize performance using async functions for I/O-bound tasks
- Use specific exceptions like `RPA.HTTP.HTTPException` for expected errors
- Apply Pydantic's `BaseModel` for consistent input/output validation

## Performance Optimization

- Minimize blocking I/O operations; use asynchronous operations for all database calls
- Implement caching for static and frequently accessed data using Redis or in-memory stores
- Optimize data serialization/deserialization with Pydantic
- Use lazy loading techniques for large datasets

## Key Conventions

1. Rely on RoboCorp's dependency injection system
2. Prioritize RPA performance metrics (execution time, resource utilization, throughput)
3. Limit blocking operations; favor asynchronous flows
4. Structure tasks and dependencies clearly for maintainability