AI Workflow — Infraestructura de Trabajo con Claude

Documento técnico que describe la infraestructura completa de trabajo con Claude Code en CreaRack Pro. Cubre: configuración, memorias, hooks, backups, reglas, sincronización y rutinas.

Última actualización: 07-04-2026

1. Arquitectura General

CreaRackSL-workspace/          ← Contexto compartido equipo (Claude Code — todos)
├── CLAUDE.md                  ← Instrucciones para Claude en este repo
├── agents/                    ← 15 agentes IA (biz/dev/support)
├── profiles/                  ← Perfiles de comportamiento
├── docs/technical/            ← Onboarding, notas, este documento
└── WORKLOG.md                 ← Dietario diario del equipo

CreaRack-Pro/                  ← Código fuente del producto
├── CLAUDE.md                  ← Instrucciones para Claude Code (11 reglas de oro)
├── RELEASE_NOTES.md           ← Registro de cambios orientado a producto
├── CHANGELOG.md               ← Registro técnico detallado
├── Documentation/             ← 60+ documentos técnicos
│   └── FEATURE_CATALOG.md     ← Inventario completo funcionalidades (punto cero)
└── ...código...

~/.claude/projects/C--dev-CreaRack-Pro/
├── memory/                    ← Memorias persistentes de Claude (per-dev)
│   ├── MEMORY.md              ← Índice de memorias
│   ├── user_*.md              ← Perfil del usuario
│   ├── feedback_*.md          ← Directivas de trabajo
│   ├── footguns_*.md          ← Errores técnicos a evitar
│   ├── infra_*.md             ← Configuraciones de infraestructura
│   ├── project_*.md           ← Estado de proyectos activos
│   └── reference_*.md         ← Punteros a recursos externos
└── settings.json              ← Hooks y configuración local

Flujo de información

Claude Code (Txell)  ←→  CreaRackSL-workspace  ←→  Claude Code (Edu/Dani)
                              ↕ git sync
                         CreaRack-Pro

• Claude Code — Txell (Desktop app): Usado por Txell para tareas de negocio. Abre en CreaRackSL-workspace/, CLAUDE.md carga 5 agentes BIZ automáticamente. Claude gestiona archivos y git sin intervención manual.
• Claude Code (CLI): Usado por Edu y Dani para desarrollo. Cada uno tiene su propia instancia con memorias independientes.
• CreaRackSL-workspace: Puente entre ambos. El conocimiento compartido vive aquí y en Documentation/.

2. CLAUDE.md — Sistema de Contexto Automático

Cómo funciona

1. Claude Code detecta CLAUDE.md en la raíz del proyecto al iniciar sesión
2. El contenido se inyecta como “project instructions” antes del primer mensaje
3. La sintaxis @ruta/archivo.md carga documentos en cascada (límite ~50KB)

Archivos cargados automáticamente en CreaRack-Pro

CLAUDE.md                                    ← Raíz (11 reglas, stack, equipo)
  └── @Documentation/INDEX.md                ← Índice de 60+ documentos
  └── @Documentation/guides/AGENT_RULES.md   ← Reglas detalladas
  └── @Documentation/frontend/DESIGN_GUIDELINES.md  ← Reglas UI
  └── @Documentation/architecture/task.md    ← Tareas actuales

Reglas de Oro (resumen)

3. Sistema de Memorias

Qué son

Archivos Markdown en ~/.claude/projects/C--dev-CreaRack-Pro/memory/ que persisten entre conversaciones. Claude los lee al inicio de cada sesión via MEMORY.md (índice).

Tipos de memoria

Reglas de las memorias

• No guardar lo que se puede derivar del código o git history
• Sí guardar decisiones no obvias, preferencias del usuario, footguns descubiertos
• Verificar antes de actuar — una memoria puede estar desactualizada
• Las memorias son per-dev (Edu y Dani tienen memorias independientes)

Backup de memorias

Script: Documentation/Claude Edu/claude-backup.ps1

# Ejecutar al final de sesiones significativas
powershell -ExecutionPolicy Bypass -File "C:/dev/CreaRack-Pro/Documentation/Claude Edu/claude-backup.ps1"

• Copia memory/ y settings.json a Documentation/Claude Edu/backup/
• Los archivos de memoria NO están en git (son personales por dev)
• El backup SÍ está en git como red de seguridad

4. Hooks y Plugins

context-mode (MCP Plugin)

Plugin que protege la ventana de contexto de Claude Code:

• ctx_execute / ctx_execute_file: Procesa datos grandes sin inundar el contexto
• ctx_batch_execute: Ejecuta múltiples comandos con indexación automática
• ctx_search: Busca en contenido previamente indexado
• ctx_fetch_and_index: Fetch + indexación de URLs

SessionStart hook

Al iniciar sesión, ejecuta automáticamente:

• git pull --rebase origin main para sincronizar
• Carga contexto de sesión previa si existe

Backup reminder

Regla en memoria (feedback_backup_sessions.md): ejecutar claude-backup.ps1 al final de sesiones significativas.

5. Documentos de Referencia

En CreaRack-Pro (código)

En CreaRackSL-workspace (equipo)

6. Rutinas de Trabajo

Inicio de sesión

1. Claude Code carga CLAUDE.md + memorias automáticamente
2. Hook SessionStart hace git pull --rebase
3. El dev describe la tarea

Durante la sesión

• Claude sigue las 11 reglas de oro
• Actualiza docs incrementalmente (regla 3)
• context-mode protege la ventana de contexto
• Subagentes Opus/Sonnet según la tarea (regla 10)

Final de sesión

1. Commit cambios pendientes (código: push inmediato, docs: [skip ci])
2. RELEASE_NOTES.md actualizado si hubo cambios funcionales
3. WORKLOG.md actualizado con resumen de la sesión
4. claude-backup.ps1 si hubo memorias nuevas o trabajo significativo
5. CreaRackSL-workspace sync si hubo cambios de stack/infra/arquitectura

Sincronización entre repos

Solo ante cambios significativos (no en cada commit):

• Nueva dependencia o versión → agents/dev/dev-backend.md
• Cambio frontend → agents/dev/dev-frontend.md
• Infraestructura → agents/dev/dev-devops.md
• IA/visión → agents/dev/dev-vision.md
• Stack general → CLAUDE.md

7. Multi-Dev (Edu + Dani)

Instancias independientes

• Cada dev tiene su propia instancia de Claude Code con memorias propias
• El conocimiento compartido vive en CLAUDE.md y Documentation/ (via git)
• CreaRackSL-workspace es el puente entre todo el equipo (Edu, Dani, Txell usan Claude Code)

Convenciones git

• Rama principal: main
• Feature branches: edu/<feature>, dani/<feature>
• git pull --rebase origin main SIEMPRE antes de push
• Push de código: inmediato. Push de docs: acumulado con [skip ci]
• Nunca incluir “Co-authored-by: CLAUDE” en commits

WORKLOG como coordinación

El WORKLOG.md permite a cada dev ver qué hizo el otro sin preguntar. Claude de cada dev añade su entrada al final de sesiones significativas.

Mantenido por: Equipo CreaRack