swl-ses 3.3.2

package/habilidades/workflow-claude-code/SKILL.md

@@ -0,0 +1,359 @@
+---
+name: workflow-claude-code
+description: >
+  Patrones de flujo de trabajo diario con Claude Code: gestion de sesiones,
+  atajos de teclado, Plan Mode, feature-per-session, gestion de contexto,
+  jerarquia de memoria, handoff multi-sesion y mejores practicas de productividad.
+  Cargar cuando el usuario pregunte como usar Claude Code eficientemente, cuando
+  necesite optimizar su flujo de trabajo, o cuando inicie un proyecto nuevo.
+  NO cargar para estructura de proyecto (usar estructura-proyecto-claude).
+---
+
+# Workflow con Claude Code
+
+Fuente: `referencias/Claude Code WorkFlow Cheatsheet.jpg` (2026 Edition)
+
+Esta skill cubre COMO trabajar con Claude Code de forma efectiva.
+Para ESTRUCTURA de proyecto, usar `estructura-proyecto-claude`.
+
+## Cuando cargar esta skill
+
+- El usuario pregunta como usar Claude Code eficientemente
+- Se necesita optimizar el flujo de trabajo diario
+- Se inicia un proyecto nuevo y se necesita onboarding
+- Hay problemas de contexto o productividad
+- Se requiere handoff entre sesiones
+- Se necesita entender Plan Mode, atajos o memoria
+
+---
+
+## Patron de flujo diario
+
+El Workflow Cheatsheet recomienda este flujo por feature:
+
+```
+1. cd proyecto && claude            # Iniciar sesion
+2. Shift+Tab+Tab -> Plan Mode       # Entrar a Plan Mode
+3. Describir intent de la feature    # Claude planea primero
+4. Shift+Tab -> Auto Accept          # Cambiar a ejecucion
+5. /compact cuando sea necesario     # Liberar contexto
+6. Esc Esc + rewind si algo falla    # Retroceder
+7. Commit frecuentemente             # Puntos de recuperacion
+8. Nueva sesion por feature          # Contexto fresco
+```
+
+**Regla de oro**: Una sesion = una feature. Sesiones largas degradan la calidad.
+
+---
+
+## Modos de operacion
+
+### Plan Mode (Shift+Tab+Tab)
+
+- Claude analiza y planifica ANTES de escribir codigo
+- Genera un plan con pasos, dependencias y riesgos
+- NO ejecuta herramientas — solo razona
+- Ideal para: features complejas, decisiones de arquitectura, debugging
+
+**Cuando usar Plan Mode**:
+- Feature nueva con multiples componentes
+- Refactoring que toca muchos archivos
+- Bug complejo sin causa obvia
+- Antes de cualquier cambio que toque >5 archivos
+
+### Auto Accept Mode (Shift+Tab)
+
+- Claude ejecuta herramientas sin pedir confirmacion
+- Mas rapido pero menos control
+- Ideal para: tareas bien definidas, generacion de boilerplate, tests
+
+**Cuando usar Auto Accept**:
+- Tarea clara con scope pequeno
+- Generacion de tests para codigo existente
+- Refactoring mecanico (renombrar, mover)
+- Despues de aprobar un plan en Plan Mode
+
+### Default Mode
+
+- Claude pide confirmacion antes de cada tool use
+- Maximo control, minima velocidad
+- Ideal para: operaciones destructivas, deploy, cambios en produccion
+
+---
+
+## Atajos de teclado esenciales
+
+| Atajo | Accion |
+|-------|--------|
+| `Shift+Tab` | Toggle extended thinking / Auto Accept |
+| `Shift+Tab+Tab` | Plan Mode |
+| `Esc Esc` | Menu de rewind (deshacer ultimo paso) |
+| `Tab` | Toggle extended thinking |
+| `/compact` | Compactar contexto |
+| `/init` | Generar CLAUDE.md inicial |
+| `/clear` | Limpiar sesion (nueva conversacion) |
+| `Ctrl+C` | Interrumpir operacion actual |
+| `!comando` | Ejecutar comando shell directo |
+
+---
+
+## Gestion de contexto
+
+### Rangos de uso
+
+| Rango | Accion | Senal |
+|-------|--------|-------|
+| **0-40%** | Trabajar normalmente | Verde |
+| **40-70%** | Monitorear — considerar compactar pronto | Amarillo |
+| **70-90%** | Ejecutar `/compact` inmediatamente | Naranja |
+| **90-100%** | `/clear` o nueva sesion obligatoria | Rojo |
+
+### Senales de degradacion de contexto (context rot)
+
+- Claude repite preguntas que ya respondio
+- Olvida decisiones tomadas anteriormente
+- Genera codigo inconsistente con lo que acaba de escribir
+- Pierde track de archivos que ya leyo
+- Mas de 40 turnos en la conversacion
+- Mas de 5 archivos grandes cargados
+
+### Estrategias anti context rot
+
+1. **Una feature por sesion** — El patron mas importante
+2. **Commits frecuentes** — Punto de recuperacion ante compactacion
+3. **CLAUDE.md < 200 lineas** — Reduce carga base de contexto
+4. **Subagentes** — Delegan trabajo a contextos frescos
+5. **`.claude/rules/` con paths** — Carga lazy, solo lo necesario
+6. **/compact proactivo** — No esperar a que se degrade
+
+### Hook PreCompact — Salvar estado
+
+Configurar en `settings.json` para salvar estado critico antes de compactar:
+
+```json
+{
+  "hooks": {
+    "PreCompact": [
+      {
+        "matcher": "auto",
+        "type": "command",
+        "command": "node .claude/hooks/save-state.js"
+      }
+    ],
+    "PostCompact": [
+      {
+        "matcher": "auto",
+        "type": "command",
+        "command": "node .claude/hooks/restore-context.js"
+      }
+    ]
+  }
+}
+```
+
+---
+
+## Jerarquia de memoria
+
+### CLAUDE.md en cascada
+
+```
+~/.claude/CLAUDE.md              # User — aplica a TODOS tus proyectos
+   |
+   +-- /CLAUDE.md                # Project — compartido via git
+       |
+       +-- /frontend/CLAUDE.md   # Subdirectory — scoped context
+       +-- /backend/CLAUDE.md    # Subdirectory — scoped context
+```
+
+**Reglas**:
+- Cada nivel **agrega** al anterior, NUNCA sobreescribe
+- Mantener cada archivo bajo **200 lineas**
+- Subdirectorios se cargan **lazy** (solo al trabajar con archivos en esa ruta)
+
+### Auto Memory (Claude se recuerda a si mismo)
+
+Claude mantiene notas persistentes en:
+```
+~/.claude/projects/<proyecto>/memory/
++-- MEMORY.md              # Indice (primeras 200 lineas cargadas al inicio)
++-- debugging.md           # Archivos tematicos (cargados bajo demanda)
++-- api-conventions.md
++-- patterns.md
+```
+
+- **Scope**: Por repositorio git (todos los worktrees comparten una memoria)
+- **Persistencia**: Entre sesiones, solo en tu maquina
+- **Control**: Toggle con `/memory` o setting `autoMemoryEnabled`
+
+### Que poner en cada nivel
+
+| Nivel | Contenido | Ejemplo |
+|-------|-----------|---------|
+| **User** (`~/.claude/CLAUDE.md`) | Preferencias globales, estilo personal | "Usar conventional commits en todos los proyectos" |
+| **Project** (`./CLAUDE.md`) | Stack, arquitectura, convenciones del equipo | "Python 3.12 + FastAPI, pytest para tests" |
+| **Subdirectory** | Convenciones especificas de un modulo | "Este directorio usa Angular 20 con signals" |
+| **Auto Memory** | Aprendizajes de sesiones previas | "El usuario prefiere pnpm sobre npm" |
+
+---
+
+## Handoff entre sesiones
+
+### Cuando cerrar sesion
+
+- Feature completada y commiteada
+- Contexto >70% usado
+- Mas de 40 turnos
+- Cambio de tarea/dominio significativo
+
+### Protocolo de handoff
+
+1. **Commit** todo el trabajo en progreso
+2. **Documentar** estado actual (si incompleto):
+   - Que esta listo
+   - Que falta por hacer
+   - Decisiones pendientes
+3. **Compactar o nueva sesion**
+4. En la nueva sesion, Claude lee CLAUDE.md + auto memory automaticamente
+
+### Usar /checkpoint para handoff SWL
+
+En proyectos con sistema SWL, usar el comando `/swl:checkpoint`:
+```
+/swl:checkpoint
+```
+Esto guarda el estado en `.planning/STATE.md` y crea un punto de restauracion.
+
+---
+
+## Patrones de productividad
+
+### Para features nuevas
+
+```
+Plan Mode -> describir feature -> aprobar plan -> Auto Accept -> implementar -> commit
+```
+
+### Para debugging
+
+```
+Plan Mode -> describir bug + evidence -> Claude investiga -> diagnostico
+-> Auto Accept -> fix -> test -> commit
+```
+
+### Para refactoring
+
+```
+Plan Mode -> describir que refactorizar y por que -> Claude analiza impacto
+-> aprobar plan -> Auto Accept -> refactorizar en pasos atomicos
+-> test despues de cada paso -> commit
+```
+
+### Para code review
+
+```
+Default Mode -> "review PR #123" -> Claude analiza cambios
+-> sugiere mejoras -> discutir -> aplicar fixes
+```
+
+### Para onboarding en proyecto existente
+
+```
+claude
+> "Analiza este codebase y explicame la arquitectura"
+> "Que tecnologias usa y como estan organizadas?"
+> "Cuales son los flujos principales?"
+-> Claude lee el codebase -> genera resumen -> usuario refina CLAUDE.md
+```
+
+---
+
+## Mejores practicas
+
+### Lo que SI hacer
+
+1. **Correr `/init` primero** — Genera un CLAUDE.md inicial que puedes refinar
+2. **Ser especifico en instrucciones** — "Agrega endpoint POST /invoices con validacion" > "agrega facturacion"
+3. **Referenciar archivos con @** — `@src/api/routes.py` carga el archivo en contexto
+4. **Agregar workflow rules** — Automatizar patrones repetitivos en CLAUDE.md
+5. **Mantener memoria concisa** — Solo lo no obvio del codigo
+6. **Commitear para compartir aprendizaje** — CLAUDE.md en git = equipo alineado
+7. **Usar subagentes** para tareas independientes — No saturar un solo contexto
+
+### Lo que NO hacer
+
+1. **Sesiones largas** — Mas de 40 turnos = degradacion
+2. **CLAUDE.md gigante** — Mas de 200 lineas = desperdicio de contexto
+3. **Ignorar /compact** — Si estas en 70%+, compacta YA
+4. **Todo en una sesion** — Una feature, una sesion
+5. **Instrucciones vagas** — Claude es literal, se especifico
+6. **Mockear la BD en integration tests** — Ya paso, no lo hagas
+7. **Secretos en CLAUDE.md** — Variables de entorno, siempre
+
+---
+
+## Skills bundled de Claude Code
+
+Claude Code incluye 17 skills predefinidos que NO requieren instalacion.
+Se invocan con `/nombre-skill` directamente en cualquier sesion:
+
+### Documentos y datos
+| Skill | Que hace |
+|-------|---------|
+| `/pdf` | Leer, crear, combinar, dividir PDFs |
+| `/pptx` | Crear presentaciones PowerPoint |
+| `/docx` | Crear documentos Word |
+| `/xlsx` | Analizar hojas de calculo Excel |
+
+### Frontend y diseno
+| Skill | Que hace |
+|-------|---------|
+| `/frontend-design` | Interfaces frontend de alta calidad visual |
+| `/web-artifacts-builder` | Componentes web complejos (React + shadcn/ui) |
+| `/brand-guidelines` | Aplicar guias de marca Anthropic |
+| `/canvas-design` | Diseno en canvas HTML |
+| `/theme-factory` | Crear temas y design systems |
+| `/algorithmic-art` | Arte algoritmico y generativo |
+
+### Desarrollo y testing
+| Skill | Que hace |
+|-------|---------|
+| `/claude-api` | Desarrollar con la API de Claude / Anthropic SDK |
+| `/mcp-builder` | Construir servidores MCP |
+| `/webapp-testing` | Testing de aplicaciones web |
+| `/skill-creator` | Crear nuevos skills para Claude Code |
+
+### Comunicacion
+| Skill | Que hace |
+|-------|---------|
+| `/internal-comms` | Comunicaciones internas (status reports, FAQs) |
+| `/doc-coauthoring` | Co-escribir documentos |
+| `/slack-gif-creator` | Crear GIFs para Slack |
+
+### Combinando con flujo SWL
+
+Estos skills se combinan naturalmente con el flujo SWL:
+
+- `/swl:ejecutar-fase` + `/frontend-design` — Implementar UI con alta calidad visual
+- `/swl:verificar` + `/webapp-testing` — Verificar con tests de aplicacion web
+- `documentador-swl` + `/pdf` + `/pptx` — Generar entregables en multiples formatos
+- `producto-prd-swl` + `/docx` — Exportar PRD como documento Word
+- `datos-swl` + `/xlsx` — Analizar datos de Excel para ETL
+- `auto-evolucion-swl` + `/skill-creator` — Crear nuevos skills del sistema
+
+---
+
+## Quick Reference
+
+| Comando | Funcion |
+|---------|---------|
+| `/init` | Generar CLAUDE.md inicial |
+| `/compact` | Comprimir contexto |
+| `/clear` | Nueva conversacion |
+| `/memory` | Toggle auto memory |
+| `/help` | Ayuda de Claude Code |
+| `Shift+Tab` | Toggle extended thinking |
+| `Shift+Tab+Tab` | Plan Mode |
+| `Esc Esc` | Rewind menu |
+| `!comando` | Ejecutar shell command |
+| `@archivo` | Cargar archivo en contexto |