Cursor Engineering Rules

# Cursor Engineering Rules

> **Production-grade Cursor rules for 15+ languages and cloud platforms**

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Comprehensive, battle-tested Cursor IDE rules for professional software engineering. Curated `.mdc` files covering languages, cloud platforms, DevOps tools, and engineering patterns.

---

## What's Included

### Core Standards

- **[100-core.mdc](rules/100-core.mdc)** - Core coding standards and review guidelines
- **[015-context-engineering.mdc](rules/015-context-engineering.mdc)** - Context engineering (prompt packing, retrieval, compaction)
- **[010-workflow.mdc](rules/010-workflow.mdc)** - Development workflow patterns
- **[020-agent-audit.mdc](rules/020-agent-audit.mdc)** - Agent audit requirements
- **[130-git.mdc](rules/130-git.mdc)** - Git conventions and commit standards

### Programming Languages

- **[200-python.mdc](rules/200-python.mdc)** - Python best practices (PEP 8, type hints, async)
- **[210-go.mdc](rules/210-go.mdc)** - Go patterns (error handling, concurrency, generics)
- **[230-javascript.mdc](rules/230-javascript.mdc)** - JavaScript/Node.js (ES modules, async/await)
- **[240-typescript.mdc](rules/240-typescript.mdc)** - TypeScript (type safety, advanced types)
- **[220-rust.mdc](rules/220-rust.mdc)** - Rust (ownership, borrowing, async)
- **[140-bash.mdc](rules/140-bash.mdc)** - Shell scripting (POSIX compliance, safety)

### Cloud Platforms

- **[410-aws.mdc](rules/410-aws.mdc)** - AWS (EKS, VPC Lattice, Zero Trust, IAM)
- **[430-azure.mdc](rules/430-azure.mdc)** - Azure (Bicep, Key Vault, App Service)
- **[420-gcp.mdc](rules/420-gcp.mdc)** - GCP (Cloud Run, GKE, Secret Manager)
- **[400-cloudflare.mdc](rules/400-cloudflare.mdc)** - Cloudflare (Workers, Rules Engine)

### AI & Machine Learning

- **[500-ai-ml.mdc](rules/500-ai-ml.mdc)** - LLM integration (OpenAI, Claude, Bedrock, Vertex AI)
- **[510-mcp-servers.mdc](rules/510-mcp-servers.mdc)** - Model Context Protocol servers

### DevOps & Infrastructure

- **[180-terraform.mdc](rules/180-terraform.mdc)** - Terraform (modules, state, validation)
- **[170-cloudformation.mdc](rules/170-cloudformation.mdc)** - CloudFormation templates
- **[450-kubernetes.mdc](rules/450-kubernetes.mdc)** - Kubernetes & EKS patterns
- **[160-github-actions.mdc](rules/160-github-actions.mdc)** - GitHub Actions (workflows, security, OIDC)
- **[190-ansible.mdc](rules/190-ansible.mdc)** - Ansible (playbooks, roles, idempotency)
- **[460-helm.mdc](rules/460-helm.mdc)** - Helm charts and templating
- **[440-docker.mdc](rules/440-docker.mdc)** - Docker & containers (multi-stage builds, security)
- **[150-justfile.mdc](rules/150-justfile.mdc)** - Justfile patterns (modern command runner)

### Security & Testing

- **[310-security.mdc](rules/310-security.mdc)** - OWASP Top 10, secret management
- **[300-testing.mdc](rules/300-testing.mdc)** - Unit/Integration/E2E testing strategies

### Patterns & Best Practices

- **[320-api-design.mdc](rules/320-api-design.mdc)** - REST API design patterns
- **[330-observability.mdc](rules/330-observability.mdc)** - Logging, metrics, tracing
- **[470-postgresql.mdc](rules/470-postgresql.mdc)** - PostgreSQL patterns
- **[810-documentation.mdc](rules/810-documentation.mdc)** - Documentation standards
- **[820-open-source.mdc](rules/820-open-source.mdc)** - Open source project patterns
- **[250-cli.mdc](rules/250-cli.mdc)** - CLI application patterns
- **[110-configuration.mdc](rules/110-configuration.mdc)** - Configuration management

### Utilities

- **[120-utilities.mdc](rules/120-utilities.mdc)** - CLI utilities (lynx, curl, jq, ripgrep, fd, fzf)
- **[800-markdown.mdc](rules/800-markdown.mdc)** - Markdown & Mermaid diagrams

### Scripts

Utility scripts for Cursor maintenance:

- **[cursor-maintenance.sh](scripts/cursor-maintenance.sh)** - Clean cache, logs, and temp files to reclaim disk space

```bash
# Preview cleanup
./scripts/cursor-maintenance.sh --dry-run

# Run cleanup
./scripts/cursor-maintenance.sh
```

See [scripts/README.md](scripts/README.md) for details.

---

## Cursor Commands

Workflow commands for explicit phase transitions. Type `/command` in Cursor chat to trigger.

| Command | Purpose |
| --- | --- |
| `/init` | Initialize task - analyze project, detect complexity |
| `/plan` | Enter planning phase - analyze, design, document approach |
| `/creative` | Enter creative phase - explore design options for complex tasks |
| `/qa` | Run QA validation - check dependencies, config, environment |
| `/build` | Enter implementation phase - write code following approved plan |
| `/review` | Enter review phase - verify implementation, suggest improvements |
| `/self-review` | Comprehensive local PR review (compare branch to main) |
| `/quick-review` | Fast critical issues check (pre-commit validation) |
| `/check-progress` | Review work progress, propose commit message |
| `/archive` | Archive task - document 

... (truncated)