Currículo de formación en Cursor — Programa de medio día para equipos de ingeniería

1. Currículo de medio día

Funciona mejor con 4-8 asistentes por sesión. Como formación interna, el patrón que mejor encaja es "uso de IA sin código" por la mañana y este medio día de Cursor por la tarde; así engranan los perfiles no técnicos y los mixtos.

2. Manías de Tab e Inline Edit

El autocompletado de Tab está muy acoplado al contexto. Va bien en completados de una línea y mal cuando propone un diff largo — en ese caso es más rápido parar y usar Inline Edit (⌘K) con una instrucción acotada. Compartimos estos criterios:

• Para y usa ⌘K si la sugerencia supera las cinco líneas
• Acepta las adiciones de import; lee las de lógica antes de aceptar
• Confía más en los completados en ficheros de test; sé estricto en código de producción

3. Composer — caballo de batalla para edición multi-archivo

Composer (⌘I) es el bucle "instrucción → vista del diff → Apply" para edición en varios ficheros. Practicamos tres patrones:

1. Acotar el trabajo con @Folder a un directorio de funcionalidad
2. Usar @File como ancla y @Code para referencias a nivel de símbolo
3. Leer el diff antes del Apply; iterar diciendo "reescribe la sección N como {...}"

Imponemos git add -p tras cada Apply. Esa regla por sí sola elimina los incidentes en los que un cambio metido por la IA se cuela en el commit sin que nadie lo vea.

4. Agent Mode — el límite

Agent Mode itera explorando ficheros, ejecutando en terminal y corrigiéndose. Es potente pero puede destrozar un repo si no se delimitan los permisos. Enseñamos siempre cuatro reglas:

• Los auto-run van en lista blanca. Nunca rm, git push ni migrate.
• Rama nueva siempre: git checkout -b agent/xxx antes de lanzar Agent Mode.
• Máximo 30 minutos por tarea de agente; obliga a un Apply / Reject antes de seguir.
• El .env de producción no se lee: añade .env* y secrets/ a .cursorignore.

5. Cursor Rules — convención compartida

El núcleo de la formación es escribir un fichero de reglas y usarlo hasta el Apply. Damos a los asistentes esta plantilla y la sustituyen por las convenciones de su empresa.

# .cursor/rules/team.mdc
---
description: チーム共通ルール (TypeScript / Next.js / pnpm)
globs: ["**/*.ts", "**/*.tsx"]
alwaysApply: true
---

# コーディング規約
- pnpm を使う。npm / yarn コマンドは提案しない
- 新規ファイルは Server Component を既定にする。"use client" は必要時のみ
- as any 禁止。型が複雑なら unknown + narrowing
- console.log は提案しない。logger を使う

# 禁止
- src/server/ の Server-only API を src/app/ から直接 import しない
- 環境変数の値をログ出力しない (process.env.* を直接 console に渡さない)

• Sólo un fichero debería tener alwaysApply: true; si todas las reglas se aplican siempre, se pisan
• En cada prohibición indica el motivo; sin el "por qué" el modelo lo ignora
• Divide en 3-5 ficheros en vez de una regla gigante; deja que globs autoseleccione

6. Añadir MCP

// ~/.cursor/mcp.json (グローバル) または .cursor/mcp.json (リポ単位)
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@linear/mcp"],
      "env": { "LINEAR_API_KEY": "lin_api_xxx" }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgres://..."]
    }
  }
}

La práctica añade Linear MCP y recorre "usa @Linear para traer mi ticket, luego impleméntalo en los ficheros enlazados con Composer". Las claves API viven en env sólo para el ejercicio; en producción se pasan por 1password run o el keystore del sistema operativo.

7. Flujo de revisión y datos sensibles

1. El estándar de revisión es el mismo, sea o no PR generado por IA. Pero indica el agente (Cursor / Claude Code / Codex) en la descripción del PR.
2. Sin tests no se mergea — ni para personas ni para IA.
3. Activa Privacy Mode. En planes enterprise, verifícalo por repositorio.
4. Protege datos privilegiados (empleados, PII de clientes) en tres capas: .cursorignore, Privacy Mode y moderación de entrada.
5. Cuando alguien deja la empresa, sácalo del equipo de Cursor de inmediato: las cachés pueden seguir accediendo a código anterior.

8. Convivencia con Codex y Claude Code

Cursor

Quedarse en el editor para edición de un fichero o acotada. La pasada para "dejarlo listo para revisión".

Claude Code

En terminal, varios chats en paralelo. Exploración larga, refactor amplio y trabajo repetitivo con plantillas de PR.

Codex

Segunda opinión y reimplementación paralela. Úsalo para auditar lo que produjo Cursor.