@karedo-hq/agents 0.1.0

package/README.md

@@ -0,0 +1,102 @@
+# @karedo-hq/agents
+
+Centralized agent skills, rules, and commands for our engineering team. Install shared configurations for AI-powered IDEs like Cursor, Claude Code, and more.
+
+## Installation
+
+```bash
+# Using pnpm
+pnpm dlx @karedo-hq/agents install --target cursor
+
+# Or install globally
+pnpm add -g @karedo-hq/agents
+agents install --target cursor
+```
+
+## Usage
+
+### Install Configurations
+
+Install agent configurations to your current project:
+
+```bash
+agents install --target <ide>
+```
+
+**Options:**
+
+- `-t, --target <ide>` - Target IDE (required). Currently supported: `cursor`
+- `-f, --force` - Overwrite existing files without prompting
+
+**Examples:**
+
+```bash
+# Install Cursor configurations
+agents install --target cursor
+
+# Force overwrite existing files
+agents install --target cursor --force
+```
+
+## Supported Targets
+
+| Target   | Description                              | Output Directory |
+| -------- | ---------------------------------------- | ---------------- |
+| `cursor` | Cursor IDE rules and commands            | `.cursor/`       |
+
+## What Gets Installed
+
+### Rules
+
+Rules provide guidelines and best practices for your codebase:
+
+- **TypeScript** - General TypeScript coding standards
+- **API (Backend)**
+  - Controllers, DTOs, Services
+  - MongoDB schemas, NestJS patterns
+  - Email templates, Tiptap templates
+- **Web (Frontend)**
+  - Next.js guidelines, API layer patterns
+  - Page creation, table implementation
+  - Responsive dialog/drawer patterns
+
+### Commands
+
+Commands are reusable workflows for common tasks:
+
+- **commit** - Commit current work with conventional commits
+- **create-pr** - Create a pull request with proper formatting
+- **deslop** - Remove AI-generated code slop
+- **release** - Automate the release process
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Watch mode
+pnpm dev
+
+# Type check
+pnpm typecheck
+```
+
+## Adding New Rules or Commands
+
+1. Add your rule file to `rules/` (use `.mdc` extension for Cursor compatibility)
+2. Add your command file to `commands/` (use `.md` extension)
+3. Rebuild and publish
+
+## Adding New IDE Targets
+
+1. Create a new handler in `src/targets/<ide-name>.ts`
+2. Register it in `src/targets/index.ts`
+3. Implement the `install` function that maps `rules/` and `commands/` to the IDE's expected location
+
+## License
+
+MIT

package/commands/commit.md

@@ -0,0 +1,26 @@
+# Commit current work
+
+Commit current work.
+
+## Important
+
+- Prepend GIT_EDITOR=true to all git commands you run, especially the ones looking at diffs, so you can avoid getting blocked as you execute commands
+- If you can't get any information from git diff, just using your working memory to determine what has changed
+
+## Instructions
+
+Review each file individually to make sure they're related to the work you just did, then write a commit message following [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/):
+
+```
+<type>[optional scope]: <description>
+
+[optional body with 2~3 bullet points]
+```
+
+Types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`, `ci`, `build`
+
+## Notes
+
+- You should only commit work when instructed. Do not keep committing subsquent work unless explicitly told so
+
+Optional: ask me if I would like to push the commit. (Only if I'm not on main)

package/commands/create-pr.md

@@ -0,0 +1,12 @@
+# Open a PR
+
+- Check that I'm in a branch other than `main` or `dev`. If not, bail and explain.
+- Find the parent branch (the branch this one was created from) using merge-base with common branches (dev, main).
+- Check the diff between my branch and the parent branch.
+- If there's unstaged or staged work that hasn't been commited, commit all the relevant code first.
+- Create the PR targeting the parent branch (use `gh pr create --base <parent-branch>`).
+- Write up a quick PR in the following format:
+  - Title: Plain English, start with verb, no prefixes (e.g. "Add emails module" not "feat(emails): add emails module")
+  - Description: <TLDR> (no more than 2 sentences) plus <Description> (1~3 bullet points explaining what's changing)
+- Always paste the link to the PR in your response so I can click it easily
+- Prepend GIT_EDITOR=true to all git commands you run, so you can avoid getting blocked as you execute commands

package/commands/deslop.md

@@ -0,0 +1,12 @@
+# Remove AI code slop
+
+Check the diff against the parent branch (use `dev` if not specified) and remove all AI generated slop introduced in this branch.
+
+This includes:
+
+- Extra comments that a human wouldn't add or is inconsistent with the rest of the file
+- Extra defensive checks or try/catch blocks that are abnormal for that area of the codebase (especially if called by trusted / validated codepaths)
+- Casts to any to get around type issues
+- Any other style that is inconsistent with the file
+
+Report at the end with only a 1-3 sentence summary of what you changed

package/commands/release.md

@@ -0,0 +1,242 @@
+# Release
+
+This command automates the release process for an application in the monorepo.
+
+## Target Repository
+
+**IMPORTANT**: Before starting, determine which repository to run this command on.
+
+- If the user specified a repo (e.g., `api`, `web`), use that.
+- If not specified, **ASK the user**: "Which repository should I run this release process on? (e.g., `api`, `web`)"
+
+Do NOT proceed until you have confirmed the target `<repo>`.
+
+Throughout this document, replace `<repo>` with the actual repository name (e.g., `api`, `web`).
+
+## Instructions
+
+Follow these steps in order:
+
+### 0. Verify Git Branch and Pull Latest Changes
+
+**CRITICAL**: Before starting, ensure you're on the `dev` branch with the latest changes.
+
+Run from the `<repo>` directory:
+
+```bash
+git checkout dev && git pull origin dev
+```
+
+If the branch checkout or pull fails, stop and inform the user to resolve git issues manually.
+
+### 1. Determine Release PR Baseline and PR Set
+
+Use **GitHub CLI (`gh`) whenever it is installed**. Fall back to GitHub MCP only if `gh` is unavailable.
+
+```bash
+# Preferred (gh) - find the last merged release PR (base=main, head=dev)
+gh pr list --state merged --base main --head dev --limit 100 --json number,title,mergedAt,url
+
+# Preferred (gh) - list merged PRs into dev (high limit, use mergedAt)
+gh pr list --state merged --base dev --limit 300 --json number,title,author,mergedAt,headRefName,url,body
+
+# Fallback (MCP) - never sort by created_at; paginate and filter by merged_at
+mcp_github_list_pull_requests({
+  owner: 'karedo-hq',
+  repo: '<repo>',
+  state: 'closed',
+  base: 'main',
+  head: 'dev',
+  per_page: 100,
+  page: 1,
+});
+```
+
+Fallback pagination rules (MCP):
+
+- Always filter by `merged_at` and ignore `created_at`
+- Fetch additional pages (`page: 2`, `page: 3`, ...) until you have all relevant PRs
+- When listing PRs merged into `dev`, stop only after you have passed the `merged_at` threshold from the last release PR
+
+**Critical**: Identify the last release PR as:
+
+- `base = main`
+- `head = dev`
+- `state = merged`
+
+Pick the most recent by `mergedAt` (do NOT search by title).
+
+Build the PR set for the release using **mergedAt** only:
+
+- Include PRs merged into `dev` **after** the last release PR's `mergedAt`
+- Sort the final list by `mergedAt` ascending
+- Do NOT use PR numbers or `createdAt` for ordering or filtering
+- Do NOT cap results at 50; use a high limit (e.g., 300) or paginate until all relevant PRs are captured
+
+If no PRs match, **STOP** and inform the user there is nothing to release.
+
+For every included PR, read its **title and description thoroughly** and note the key user-facing impact; you will reuse that wording when updating the changelog.
+
+### 2. Update CHANGELOG.md
+
+Add a new entry at the top of the changelog following this format:
+
+```markdown
+## [X.X.X] - MMM DD, YYYY.
+
+One line summary of the release.
+
+### Added
+
+- Bullet points of new features
+
+### Changed
+
+- Bullet points of changes
+
+### Fixed
+
+- Bullet points of bug fixes
+```
+
+Rules:
+
+- Keep it concise and high-level while accurately reflecting the PRs in the **exact PR list** from step 1.
+- **Use PR titles and descriptions as the primary source of truth.** If a point is not obvious from the code diff, lean on the wording in the PR body.
+- Make sure every PR from the list in step 1 influences the entry. If a PR does not warrant a line item, ensure its work is implicitly covered by another bullet.
+- Only include important changes; combine related PRs into a single bullet when appropriate.
+- Do not include PR numbers in the changelog entry.
+- Follow the existing pattern in the file.
+
+### 3. Update package.json
+
+Bump the version number in `<repo>/package.json`:
+
+```json
+"version": "X.X.X"
+```
+
+### 4. Wait for User Confirmation
+
+**STOP HERE AND WAIT FOR USER CONFIRMATION**
+
+After updating CHANGELOG.md and package.json, present the changes to the user and ask:
+
+"I've updated the following files for version X.X.X:
+
+- CHANGELOG.md (added new entry with X changes)
+- package.json (bumped version from Y.Y.Y to X.X.X)
+
+Please review the changes. Should I proceed with committing and pushing these changes to dev?"
+
+Do NOT proceed until the user explicitly confirms (e.g., "yes", "proceed", "looks good", etc.).
+
+If the user requests changes, make the adjustments and ask for confirmation again.
+
+### 5. Commit and Push Changes to Dev
+
+**CRITICAL STEP**: Only proceed after user confirmation. You MUST commit and push the version bump changes to dev BEFORE creating the PR and tag.
+
+Use conventional commit format (run from the `<repo>` directory):
+
+```bash
+git add CHANGELOG.md package.json && git commit -m "chore(version): Bump to vX.X.X" && git push origin dev
+```
+
+Request `git_write` permissions for this step.
+
+**Note**: If SSH authentication fails, the user will need to handle it manually. Wait for confirmation before proceeding.
+
+### 6. Prepare Release PR Details
+
+Prepare the PR title and body, then present to user for confirmation:
+
+**Title**: `Release vX.X.X` (must include the version)
+
+**Body**: List of all included PRs (from step 1), in `mergedAt` order. Each entry must include only the PR number:
+
+```
+- #1234
+- #1235
+...
+```
+
+**STOP AND WAIT FOR USER CONFIRMATION**
+
+Ask the user: "Should I create the release PR with the above title and description?"
+
+Do NOT proceed until the user explicitly confirms.
+
+### 7. Create Release Pull Request
+
+Prefer GitHub CLI; only use MCP if `gh` is unavailable.
+
+```bash
+# Preferred (gh)
+gh pr create \
+  --title "Release vX.X.X" \
+  --base main \
+  --head dev \
+  --body "- #1234\n- #1235\n..."
+
+# Fallback (MCP)
+mcp_github_create_pull_request({
+  owner: 'karedo-hq',
+  repo: '<repo>',
+  title: 'Release vX.X.X',
+  head: 'dev',
+  base: 'main',
+  body: '- #1234\n- #1235\n...',
+});
+```
+
+### 8. Create and Push Git Tag
+
+**STOP AND WAIT FOR MERGE CONFIRMATION**
+
+Ask the user to confirm the release PR has been merged into `main`.
+
+**ONLY after the release PR is merged into `main`**, create and push the tag from `main` (run from the `<repo>` directory):
+
+```bash
+git checkout main && git pull origin main
+git tag vX.X.X
+git push origin vX.X.X
+git checkout dev
+```
+
+Request `git_write` permissions for this step.
+
+**Important**: The tag must point to the merged release commit on `main` (not `dev`). Always return to `dev` after tagging to continue development work.
+
+## Version Numbering
+
+Follow semantic versioning:
+
+- **Patch (X.X.1)**: Bug fixes, minor UI improvements
+- **Minor (X.1.0)**: New features, significant changes
+- **Major (1.0.0)**: Breaking changes, major releases
+
+## Common Pitfalls
+
+1. **Not on dev branch**: Always verify you're on `dev` branch before starting
+2. **Wrong PRs included**: Always verify PRs were merged to `dev`, not feature branches
+3. **Skipping user confirmation**: Always wait for explicit user approval before committing or creating PR
+4. **Forgot to commit**: The tag will point to the wrong commit if you don't commit first
+5. **Wrong version type**: Carefully determine if it's a patch, minor, or major version based on the changes
+6. **SSH authentication**: If git push fails with passphrase error, user needs to handle authentication
+7. **Left on main branch**: Always return to `dev` branch after tagging to continue development work
+
+## Example Output
+
+At the end, provide a summary:
+
+```
+✅ Git Branch - Verified on dev branch with latest changes
+✅ CHANGELOG.md - Updated with vX.X.X entry (user confirmed)
+✅ package.json - Bumped version from X.X.X to X.X.X (user confirmed)
+✅ Git Commit - Committed and pushed version bump to dev
+✅ Release PR - Created #XXX from dev to main (user confirmed)
+✅ Git Tag - Created and pushed vX.X.X tag to origin
+✅ Git Branch - Returned to dev branch
+```

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { Command } from "commander";
+
+// src/install.ts
+import chalk from "chalk";
+
+// src/targets/cursor.ts
+import path2 from "path";
+
+// src/utils/fs.ts
+import path from "path";
+import { fileURLToPath } from "url";
+import fs from "fs-extra";
+function getPackageRoot() {
+  const currentFile = fileURLToPath(import.meta.url);
+  const currentDir = path.dirname(currentFile);
+  return path.resolve(currentDir, "..");
+}
+async function copyDirectory(source, target, force) {
+  let copied = 0;
+  let skipped = 0;
+  const sourceExists = await fs.pathExists(source);
+  if (!sourceExists) {
+    return { copied, skipped };
+  }
+  await fs.ensureDir(target);
+  const entries = await fs.readdir(source, { withFileTypes: true });
+  for (const entry of entries) {
+    const sourcePath = path.join(source, entry.name);
+    const targetPath = path.join(target, entry.name);
+    if (entry.isDirectory()) {
+      const result = await copyDirectory(sourcePath, targetPath, force);
+      copied += result.copied;
+      skipped += result.skipped;
+    } else {
+      const targetExists = await fs.pathExists(targetPath);
+      if (targetExists && !force) {
+        skipped++;
+      } else {
+        await fs.copy(sourcePath, targetPath);
+        copied++;
+      }
+    }
+  }
+  return { copied, skipped };
+}
+
+// src/targets/cursor.ts
+var cursorTarget = {
+  id: "cursor",
+  name: "Cursor",
+  install: async (cwd, force) => {
+    const packageRoot = getPackageRoot();
+    const targetDir = path2.join(cwd, ".cursor");
+    const rulesSource = path2.join(packageRoot, "rules");
+    const rulesTarget = path2.join(targetDir, "rules");
+    const commandsSource = path2.join(packageRoot, "commands");
+    const commandsTarget = path2.join(targetDir, "commands");
+    const rulesResult = await copyDirectory(rulesSource, rulesTarget, force);
+    const commandsResult = await copyDirectory(commandsSource, commandsTarget, force);
+    return {
+      rulesCopied: rulesResult.copied,
+      commandsCopied: commandsResult.copied,
+      skipped: rulesResult.skipped + commandsResult.skipped
+    };
+  }
+};
+
+// src/targets/index.ts
+var targets = {
+  cursor: cursorTarget
+};
+function getTarget(id) {
+  return targets[id];
+}
+function listTargets() {
+  return Object.keys(targets);
+}
+
+// src/install.ts
+async function install(targetId, force) {
+  const target = getTarget(targetId);
+  if (!target) {
+    console.error(chalk.red(`Unknown target: ${targetId}`));
+    console.error(chalk.dim(`Available targets: ${listTargets().join(", ")}`));
+    process.exit(1);
+  }
+  console.log(chalk.blue(`Installing agent configurations for ${target.name}...`));
+  try {
+    const result = await target.install(process.cwd(), force);
+    console.log(chalk.green("\nInstallation complete!"));
+    console.log(chalk.dim(`  Rules copied: ${result.rulesCopied}`));
+    console.log(chalk.dim(`  Commands copied: ${result.commandsCopied}`));
+    if (result.skipped > 0) {
+      console.log(chalk.yellow(`  Skipped (already exist): ${result.skipped}`));
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(chalk.red(`Installation failed: ${message}`));
+    process.exit(1);
+  }
+}
+
+// src/cli.ts
+var program = new Command();
+program.name("agents").description("Install shared agent skills, rules, and commands for your IDE").version("0.1.0");
+program.command("install").description("Install agent configurations to target IDE").requiredOption("-t, --target <ide>", "Target IDE (e.g., cursor)").option("-f, --force", "Overwrite existing files without prompting", false).action(async (options) => {
+  await install(options.target, options.force);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/install.ts","../src/targets/cursor.ts","../src/utils/fs.ts","../src/targets/index.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport { install } from \"./install.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"agents\")\n  .description(\"Install shared agent skills, rules, and commands for your IDE\")\n  .version(\"0.1.0\");\n\nprogram\n  .command(\"install\")\n  .description(\"Install agent configurations to target IDE\")\n  .requiredOption(\"-t, --target <ide>\", \"Target IDE (e.g., cursor)\")\n  .option(\"-f, --force\", \"Overwrite existing files without prompting\", false)\n  .action(async (options: { target: string; force: boolean }) => {\n    await install(options.target, options.force);\n  });\n\nprogram.parse();\n","import chalk from \"chalk\";\nimport { getTarget, listTargets } from \"./targets/index.js\";\n\nexport async function install(targetId: string, force: boolean): Promise<void> {\n  const target = getTarget(targetId);\n\n  if (!target) {\n    console.error(chalk.red(`Unknown target: ${targetId}`));\n    console.error(chalk.dim(`Available targets: ${listTargets().join(\", \")}`));\n    process.exit(1);\n  }\n\n  console.log(chalk.blue(`Installing agent configurations for ${target.name}...`));\n\n  try {\n    const result = await target.install(process.cwd(), force);\n\n    console.log(chalk.green(\"\\nInstallation complete!\"));\n    console.log(chalk.dim(`  Rules copied: ${result.rulesCopied}`));\n    console.log(chalk.dim(`  Commands copied: ${result.commandsCopied}`));\n\n    if (result.skipped > 0) {\n      console.log(chalk.yellow(`  Skipped (already exist): ${result.skipped}`));\n    }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    console.error(chalk.red(`Installation failed: ${message}`));\n    process.exit(1);\n  }\n}\n","import path from \"node:path\";\nimport { copyDirectory, getPackageRoot } from \"../utils/fs.js\";\nimport type { InstallResult, Target } from \"./index.js\";\n\nexport const cursorTarget: Target = {\n  id: \"cursor\",\n  name: \"Cursor\",\n  install: async (cwd: string, force: boolean): Promise<InstallResult> => {\n    const packageRoot = getPackageRoot();\n    const targetDir = path.join(cwd, \".cursor\");\n\n    const rulesSource = path.join(packageRoot, \"rules\");\n    const rulesTarget = path.join(targetDir, \"rules\");\n\n    const commandsSource = path.join(packageRoot, \"commands\");\n    const commandsTarget = path.join(targetDir, \"commands\");\n\n    const rulesResult = await copyDirectory(rulesSource, rulesTarget, force);\n    const commandsResult = await copyDirectory(commandsSource, commandsTarget, force);\n\n    return {\n      rulesCopied: rulesResult.copied,\n      commandsCopied: commandsResult.copied,\n      skipped: rulesResult.skipped + commandsResult.skipped,\n    };\n  },\n};\n","import path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport fs from \"fs-extra\";\n\ntype CopyResult = {\n  copied: number;\n  skipped: number;\n};\n\nexport function getPackageRoot(): string {\n  const currentFile = fileURLToPath(import.meta.url);\n  const currentDir = path.dirname(currentFile);\n  return path.resolve(currentDir, \"..\");\n}\n\nexport async function copyDirectory(\n  source: string,\n  target: string,\n  force: boolean\n): Promise<CopyResult> {\n  let copied = 0;\n  let skipped = 0;\n\n  const sourceExists = await fs.pathExists(source);\n  if (!sourceExists) {\n    return { copied, skipped };\n  }\n\n  await fs.ensureDir(target);\n\n  const entries = await fs.readdir(source, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const sourcePath = path.join(source, entry.name);\n    const targetPath = path.join(target, entry.name);\n\n    if (entry.isDirectory()) {\n      const result = await copyDirectory(sourcePath, targetPath, force);\n      copied += result.copied;\n      skipped += result.skipped;\n    } else {\n      const targetExists = await fs.pathExists(targetPath);\n\n      if (targetExists && !force) {\n        skipped++;\n      } else {\n        await fs.copy(sourcePath, targetPath);\n        copied++;\n      }\n    }\n  }\n\n  return { copied, skipped };\n}\n","import { cursorTarget } from \"./cursor.js\";\n\nexport type InstallResult = {\n  rulesCopied: number;\n  commandsCopied: number;\n  skipped: number;\n};\n\nexport type Target = {\n  id: string;\n  name: string;\n  install: (cwd: string, force: boolean) => Promise<InstallResult>;\n};\n\nconst targets: Record<string, Target> = {\n  cursor: cursorTarget,\n};\n\nexport function getTarget(id: string): Target | undefined {\n  return targets[id];\n}\n\nexport function listTargets(): string[] {\n  return Object.keys(targets);\n}\n"],"mappings":"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","names":["path","path"]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@karedo-hq/agents",
+  "version": "0.1.0",
+  "description": "Centralized agent skills, rules, and commands for our engineering team",
+  "type": "module",
+  "bin": {
+    "agents": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "rules",
+    "commands"
+  ],
+  "keywords": [
+    "ai",
+    "agents",
+    "cursor",
+    "ide",
+    "rules",
+    "commands",
+    "skills"
+  ],
+  "author": "Karedo",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/rules/api/controllers.mdc

@@ -0,0 +1,31 @@
+---
+description: How to define API controllers on the backend.
+alwaysApply: false
+---
+# Controllers Guidelines
+
+## Multi-Tenant Architecture
+
+- Use `@GetOrganizationId()` decorator to obtain organization scope.
+- Pass `organizationId` to all service methods for scoped database operations.
+
+## Structure
+
+- Controller Decorator: Use `@Controller('route-path')` to define base route.
+- Route Handlers: Decorate methods with HTTP decorators (`@Get()`, `@Post()`, `@Patch(':id')`, `@Delete(':id')`).
+  - Use parameter decorators: `@Body()`, `@Param()`, `@Query()`, `@Req()`, `@UploadedFile()`.
+  - Set specific status codes with `@HttpCode(HttpStatus.CREATED)`.
+
+  ```typescript
+  @Post()
+  @HttpCode(HttpStatus.CREATED)
+  public async create(
+    @GetOrganizationId() organizationId: string,
+    @Body() createItemDto: CreateItemDto,
+  ) {
+    return this.itemsService.create(organizationId, createItemDto);
+  }
+  ```
+
+- File Uploads: Use `@UseInterceptors(FileInterceptor('fieldName', options))` with `@UploadedFile()` decorator. Validate with `ParseFilePipe` and validators (`MaxFileSizeValidator`, `FileTypeValidator`).
+- Request Object: Use `@Req()` for direct request access (e.g., `req.user` from auth guards). Type as `RequestWithUser`.

package/rules/api/dtos.mdc

@@ -0,0 +1,38 @@
+---
+description: How to define DTOs (data-transfer-objects) on the backend.
+alwaysApply: false
+---
+# DTOs Guidelines
+
+## Validation
+
+Use `class-validator` decorators for input validation:
+
+```typescript
+import {
+  IsString,
+  IsNotEmpty,
+  IsEmail,
+  IsOptional,
+  MinLength,
+} from 'class-validator';
+
+export class CreateUserDto {
+  @IsString()
+  @IsNotEmpty()
+  @MinLength(3)
+  username: string;
+
+  @IsEmail()
+  email: string;
+
+  @IsOptional()
+  @IsString()
+  displayName?: string;
+}
+```
+
+## Principles
+
+- Keep DTOs focused on data structure and validation only.
+- No business logic in DTOs.