Archivos de gestión del trabajo

methodology/TRANSITIONS/COWORK_TRANSITION_GUIDE.md

@@ -0,0 +1,262 @@
+# Guía — Transferir contexto a una nueva sesión de Claude
+
+> Cuándo y cómo transferir el contexto de un chat largo a una sesión nueva (Cowork, claude.ai, o cualquier otro cliente) sin perder calidad de las respuestas.
+
+---
+
+## Cuándo necesitás esta guía
+
+### Casos donde aplica
+
+- El chat actual alcanzó el límite de imágenes/archivos adjuntos
+- La conversación se volvió tan larga que las respuestas se sienten más lentas o menos precisas
+- Querés migrar a Cowork u otro cliente para acceder a archivos locales/cloud
+- Vas a transferir el proyecto a otro miembro del equipo
+
+### Casos donde NO aplica
+
+- Querés "empezar de cero" por gusto (perdés mucho contexto sin razón)
+- El chat funciona pero te aburre (no es razón técnica, es percepción)
+- Estás en medio de una etapa específica del sprint (terminala antes)
+
+---
+
+## Antes de transferir — checklist
+
+Antes de cerrar el chat actual, asegurate de:
+
+```
+[ ] Todos los artefactos importantes están en el repo (no solo en chat)
+[ ] Decisiones recientes están documentadas en CLAUDE.md, methodology/, 
+    o STRATEGIC_DIRECTION.md
+[ ] Los prompts de etapas en curso están en sprints/sprint-N/
+[ ] Si hay observaciones pendientes, están en OBSERVATIONS.md o TODO.md
+[ ] El último estado del trabajo está commiteado a git
+```
+
+**Si algo crítico vive solo en el chat, copialo a un archivo antes de transferir.** El chat anterior se pierde como referencia operativa después del cierre.
+
+---
+
+## El brief de transferencia — estructura recomendada
+
+Cuando arranques el chat nuevo, el primer mensaje debe ser un brief que reconstruya el contexto mínimo necesario. Estructura propuesta:
+
+### 1. Identificación del rol y misión
+
+```
+Sos mi asesor técnico-estratégico para [proyecto]. Mi rol es [director / 
+arquitecto / fundador / consultor]. El producto es [descripción breve 
+en 2 líneas].
+
+Mi objetivo de largo plazo es [contexto estratégico — ej. "construir 
+un método de trabajo con agentes que mi equipo pueda usar"].
+```
+
+### 2. Estado actual del proyecto
+
+```
+Estado actual:
+- Estamos en Sprint [N], Etapa [M]
+- Próximo paso: [acción concreta]
+- Archivos clave a leer ANTES de responder:
+  * CLAUDE.md (reglas del proyecto)
+  * methodology/PRINCIPLES.md (método de trabajo)
+  * sprints/sprint-N/BRIEF.md (alcance del sprint actual)
+  * STRATEGIC_DIRECTION.md (dirección de producto)
+```
+
+### 3. Reglas operativas que el agente debe respetar
+
+```
+Reglas operativas:
+1. [Regla más importante — ej. "Validación visual es ojo, no test"]
+2. [Política de iniciativa proactiva — Nivel 1/2/3]
+3. [Reglas de marca no negociables]
+4. [Anti-patrones específicos a evitar]
+```
+
+### 4. Tono y expectativa de respuesta
+
+```
+Esperá de mí:
+- Honestidad operativa, no complacencia
+- Crítica fundamentada cuando algo no cierra
+- Distinción entre lo validado y lo asumido
+- Auditoría adversarial al output de agentes
+
+Esperá que yo:
+- Decida lo estratégico
+- Valide visualmente artefactos
+- Cace anomalías con criterio
+- Te corrija cuando te desvías
+```
+
+### 5. Capacidades disponibles del entorno
+
+```
+En este entorno tenés acceso a:
+- [Filesystem local de mi Mac en /Users/marcos/projects/inq-roi/]
+- [Google Drive workspace InQuality — usalo proactivamente para assets de marca]
+- [ClickUp workspace InQuality — usalo para tareas y observaciones]
+- [GitHub vía MCP — repo: github.com/marcos/inq-roi]
+```
+
+**Esta sección es la más subutilizada.** Los agentes tienden a trabajar con lo que está en el chat actual. Si tenés conectores configurados, **decíselo explícitamente** y pedile que los use cuando corresponda.
+
+---
+
+## Plantilla mínima para arranque rápido
+
+Si necesitás transferir sin armar brief completo, copiá esto al chat nuevo y editá los placeholders:
+
+```
+Sos mi asesor técnico-estratégico para [PROYECTO]. Vengo de un chat 
+largo en otro cliente. Necesito que retomemos sin perder calidad.
+
+CONTEXTO MÍNIMO:
+- Proyecto: [Nombre + 1 línea de descripción]
+- Mi rol: [director / arquitecto]
+- Sprint actual: [Sprint N, Etapa M]
+- Próximo paso inmediato: [acción concreta]
+
+ARCHIVOS QUE DEBÉS LEER ANTES DE RESPONDER (en orden):
+1. [path al CLAUDE.md o reglas del proyecto]
+2. [path al brief del sprint actual]
+3. [path al methodology/PRINCIPLES.md si aplica]
+4. [path al STRATEGIC_DIRECTION.md si aplica]
+
+REGLAS NO NEGOCIABLES:
+- [Regla 1 — ej. "Marca: InQ siempre I-n-Q"]
+- [Regla 2 — ej. "Política de iniciativa proactiva: niveles 1/2/3"]
+- [Regla 3 — ej. "Validación visual mandatoria de artefactos"]
+
+CAPACIDADES DEL ENTORNO:
+- [Lista de conectores/herramientas disponibles]
+
+Confirmame que leíste los archivos y entendiste las reglas. Si algo 
+no cierra, preguntá antes de avanzar. NO arranques tareas sin mi OK 
+explícito.
+```
+
+---
+
+## Diferencias prácticas entre clientes
+
+Cada cliente de Claude tiene matices que vale la pena conocer.
+
+### claude.ai web
+
+- Acceso a herramientas configuradas por el usuario (Google Drive, ClickUp, GitHub via MCP, etc.)
+- Límites de mensaje/imagen por chat
+- Conversaciones independientes (no comparten contexto)
+- Útil para conversaciones estratégicas y revisiones
+
+### Claude Desktop
+
+- Mismo Claude que la web, distinto cliente
+- Puede tener atajos y workflows específicos
+- Acceso a clipboard del sistema operativo
+
+### Claude Code
+
+- Optimizado para tareas de código y operaciones de filesystem
+- Sesión por sesión (no comparte contexto entre sesiones, ni con claude.ai)
+- Acceso a archivos del directorio donde se ejecuta
+- Política de permisos configurable en `.claude/`
+- Ideal para implementación, no para conversación estratégica
+
+### Cowork (beta)
+
+- Producto Anthropic en beta para automatización de archivos y tareas en escritorio
+- Puede leer archivos directamente de carpetas designadas en tu Mac
+- Útil cuando necesitás procesar muchos archivos o no querés copy-paste
+- Verificá la documentación de Cowork antes de planear migración importante — el producto está en evolución
+
+### Implicación para transferencias
+
+Cuando transfieras de un cliente a otro, **mencioná explícitamente qué capacidades tiene el nuevo cliente** en el brief. Los agentes no asumen capacidades — trabajan con lo que les decís que pueden hacer.
+
+---
+
+## Errores comunes al transferir contexto
+
+### Error 1: Pegar el chat entero
+
+**Por qué falla:** los chats largos contienen mucho ruido (validaciones intermedias, idas y vueltas, exploración descartada). Pegar todo no es transferir contexto, es transferir entropía.
+
+**Qué hacer:** extraer las decisiones y el estado final. El razonamiento que llevó a las decisiones puede inferirse o consultarse si hace falta.
+
+### Error 2: No mencionar las capacidades del nuevo entorno
+
+**Por qué falla:** el agente se restringe a lo que tiene en chat porque no sabe que tiene más herramientas.
+
+**Qué hacer:** listar explícitamente conectores, paths de filesystem, MCPs configurados, etc.
+
+### Error 3: Asumir que el agente conoce tu método
+
+**Por qué falla:** una sesión nueva no tiene contexto de los patrones operativos que vos construiste.
+
+**Qué hacer:** apuntar al agente a `methodology/PRINCIPLES.md` desde el primer mensaje. Si no existe, listar las 3-5 reglas más importantes en el brief.
+
+### Error 4: No probar antes de delegar tareas críticas
+
+**Por qué falla:** el primer intercambio puede revelar que el contexto transferido no fue suficiente.
+
+**Qué hacer:** hacer 2-3 preguntas de calibración al nuevo agente antes de pasarle una tarea crítica. Ejemplos:
+- "Resumime en 3 puntos cuál es la prioridad estratégica del proyecto"
+- "¿Qué patrones de la metodología aplicarías en esta etapa?"
+- "¿Qué validarías visualmente antes de aprobar un PDF?"
+
+Si las respuestas son superficiales, el brief está incompleto. Reforzar antes de avanzar.
+
+---
+
+## Caso específico: migración a Cowork
+
+Si planeás migrar a Cowork desde claude.ai web, hacé esto en orden:
+
+### Paso 1 — Preparar el repo
+
+Asegurate de que estos archivos estén actualizados en el repo:
+- `CLAUDE.md`
+- `STRATEGIC_DIRECTION.md` (si existe)
+- `methodology/PRINCIPLES.md`
+- `sprints/sprint-N/BRIEF.md` (sprint actual)
+- `OBSERVATIONS.md` (sprint actual)
+
+### Paso 2 — Designar carpeta accesible para Cowork
+
+En Cowork, configurás qué carpetas puede leer/escribir. Designá la carpeta del repo.
+
+### Paso 3 — Brief inicial en Cowork
+
+Usá la plantilla mínima de arriba, con énfasis en:
+- Path absoluto del repo en tu Mac
+- Lista de archivos a leer
+- Capacidades específicas de Cowork (escritura de archivos, lectura de PDFs, etc.)
+
+### Paso 4 — Validación de calidad
+
+Antes de delegar tareas críticas, hacé las 3 preguntas de calibración. Si la calidad no se siente comparable, refiná el brief.
+
+### Paso 5 — Período de transición
+
+Mantené el chat anterior abierto en lectura por 1-2 días después de la migración. Si surge algo que el nuevo Claude no sabe, consultás el viejo, copiás lo necesario al nuevo, y seguís.
+
+---
+
+## Cómo evaluar si la transferencia fue exitosa
+
+Después de transferir, validá lo siguiente:
+
+```
+[ ] El nuevo Claude entiende qué proyecto estás trabajando
+[ ] El nuevo Claude conoce las reglas no negociables del proyecto
+[ ] El nuevo Claude puede acceder a los archivos críticos
+[ ] El nuevo Claude aplica la política de iniciativa correctamente
+[ ] El nuevo Claude pregunta antes de asumir, no inventa
+[ ] Las respuestas tienen la misma profundidad que el chat anterior
+```
+
+Si alguno falla, refiná el brief con la información faltante. **No te resignes a un asistente de menor calidad** — transferir contexto bien es habilidad de orquestación que vale la pena dominar.