Currículo de formación en Claude Code — Un día completo centrado en sesiones paralelas y Plan Mode

1. Currículo de un día

Funciona bien con 4-10 asistentes por sesión. Plan Mode y sesiones paralelas son los dos pilares (mañana / tarde). MCP y hooks por la tarde se ajustan según las convenciones de la empresa.

2. CLAUDE.md — el sitio para las convenciones

Claude Code carga automáticamente CLAUDE.md al inicio de cada sesión. Mantenlo en dos niveles: global (~/.claude/CLAUDE.md) y en la raíz del proyecto. En la formación entregamos una plantilla que cada asistente sustituye por las convenciones de su empresa.

# CLAUDE.md

## 最重要原則
1. Plan Mode で開始する。曖昧な指示はプランで合意してから実行
2. main / develop に直接コミットしない。必ず feature ブランチ + PR
3. 破壊的コマンド (rm -rf, git push -f, db migrate) は実行前に必ず確認

## コーディング規約
- pnpm を使う (npm/yarn 禁止)
- src/server/ は src/app/ から直接 import しない
- env 値を console に出力しない

## レビュー
- PR は実装エージェント名 (Claude Code / Cursor / Codex) を本文に明記
- テストなしの PR はマージしない

• Limita los "principios clave" a 3-5 líneas. Si hay muchos, nadie los sigue.
• En cada prohibición, indica el motivo (p. ej., "no push directo a main: hace falta PR para revisión").
• Lista los comandos destructivos por nombre concreto, no por categoría.

3. Plan Mode — plan, aprobar, ejecutar

Plan Mode obliga al agente a escribir el plan en prosa antes de ejecutar. Imponemos estas reglas:

1. Cualquier indicación de más de dos líneas entra en Plan Mode con shift+tab
2. Lee el plan y devuélvelo con cambios ("modifica sólo esta parte")
3. Sal de Plan Mode y ejecuta sólo tras acuerdo
4. Para cambios grandes, guarda el plan acordado en un fichero aparte antes de ejecutar

Durante la práctica de la tarde, la regla "Plan Mode al menos cinco veces por persona, implementar sólo lo que tenga plan acordado" fija el hábito.

4. Slash commands y sub-agents

Convierte los flujos frecuentes en slash commands dentro de.claude/commands/*.md. En la formación, los asistentes escriben tres: revisión de PR, investigación de librería y generación de mensaje de commit.

# .claude/commands/review-pr.md
---
description: 現在のブランチの PR をレビューし、修正案を提示する
---

# レビュー手順
1. `gh pr view` で本文を取得
2. `git diff main...HEAD` で差分を確認
3. 以下の観点でレビューする:
   - テストカバレッジ
   - エラーハンドリング
   - 命名 / 抽象度
4. 結論: Approve / Request Changes / Comment を 1 行で示す

La exploración pesada y la revisión independiente van a un sub-agent mediante la herramienta Task. El padre recibe sólo un resumen corto y el contexto principal se mantiene limpio. Practicamos con "grep en todo el markdown del repo en busca de términos legacy" para que sientan la dinámica.

5. Automatización y red de seguridad con hooks

# .claude/settings.json (抜粋)
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/block-destructive.sh"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "pnpm lint --fix" }
        ]
      }
    ]
  }
}

• PreToolUse bloquea Bash destructivo (rm -rf, git push -f)
• PostToolUse ejecuta lint + typecheck tras Edit / Write
• SessionStart carga notas previas; Stop persiste el resumen
• PreCompact archiva un resumen antes de que se compacte una sesión larga

En la formación, cada asistente codifica los comandos prohibidos de su empresa tanto en CLAUDE.md como en un hook PreToolUse: defensa en profundidad.

6. Integraciones MCP

MCP expone sistemas externos (Linear, Postgres, Slack, GitHub) como herramientas del agente. La práctica añade Linear MCP y recorre "lee mi ticket en Plan Mode → edita los ficheros enlazados → abre un PR" de extremo a extremo. Las claves API se pasan vía1password run, no pegadas en .env.

7. Sesiones paralelas — 15 tareas al día

El pico del día. Montamos tmux + git worktrees para que "una tarea = una rama = una terminal" se cumpla mecánicamente.

1. Crea un worktree: git worktree add ../<repo>-task1 -b feat/task1
2. Divide paneles en tmux y lanza claude en cada worktree
3. Un ciclo: Plan Mode → acuerdo → ejecutar → Apply, en unos 30 minutos
4. Al terminar, abre el PR y elimina el worktree

Con esa estructura los asistentes sienten lo que es llevar 10-15 tareas al día sin esperas. También compartimos cómo aplicar.cursorignore y hooks a nivel de worktree para reforzar la seguridad.

8. Flujo de PR junto con Codex y Cursor

Claude Code

Lleva muchas tareas en paralelo. Cubre exploración larga, refactor y creación end-to-end del PR.

Cursor

Acabado de un fichero o acotado. La pasada para "dejarlo presentable" antes de revisión.

Codex

Revisa cruzada los PRs de Claude Code. Una reimplementación independiente eleva la calidad de decisión.