AI Workflow — Infraestructura de Trabajo con Claude

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 (dual: OneDrive + GitHub)

Script: claude-method/harness/claude-backup.ps1 (s82; la ruta antigua Documentation/Claude Edu/ quedó obsoleta).

# Ejecutar al final de sesiones significativas (ritual "Apaga", paso 8)
powershell -ExecutionPolicy Bypass -File "C:/dev/claude-method/harness/claude-backup.ps1" -PushGit

• Hace dos copias: .zip a OneDrive (%CLAUDE_BACKUP_ROOT%) + memoria en texto al repo CreaRackSL/claude-backups (carpeta por persona).
• Recuperar (PC nuevo / memoria perdida): claude-backup.ps1 -Restore -FromGit -Name <persona>.
• Los archivos de memoria NO están en el repo de código (son personales por dev).
• El backup SÍ está en git como red de seguridad

4. Hooks y Plugins

Plugins activos

• frontend-design (Anthropic official) — registrado disabled. Los 14 skills design-* viven en ~/.claude/skills/ user-scope (propagados por setup-claude-code.ps1 paso 4c).

Plugins descartados (s52, 07-05-2026)

• andrej-karpathy-skills: directrices embebidas en CLAUDE.md sección 12 de CreaRack-Pro (más robusto, no depende de skill descriptions).
• skill-bus: sin subscriptions activas, dropeado del listado.
• context-mode: deprecado desde 10-04-2026, registro purgado 07-05-2026.

SessionStart hook (4 comandos desde s60)

Al iniciar sesión, ejecuta automáticamente en orden:

1. git pull --rebase origin main del repo activo.
2. hot-cache-sync.ps1 refresca project_hot_cache.md con snapshot del grafo.
3. timezone-sync inyecta [Local time] ... Europe/Madrid (Regla 25 zona horaria del equipo).
4. claude-method-sync.ps1 -SkipHook -SkipMemory (s60, 13-05-2026) pulea claude-method y propaga global-agents/ + global-skills/ a ~/.claude/. Cierra Gap 1 del propagador del staff. Envuelto en try/catch + exit 0 (silent failure si offline). Coste ~2-3s/arranque cuando el repo está al día.

Tras el hook, Claude carga contexto: CLAUDE.md + memorias + project_hot_cache.md + cualquier agente/skill actualizado.

Para ascender lo local al método central (s60, cierra Gap 2): pwsh C:/dev/claude-method/harness/claude-method-promote.ps1 -Type {agent|skill} -Name <slug>. Detecta CREATE/UPDATE/IDENTICAL automáticamente, valida frontmatter, commit + push. Los demás miembros lo reciben en su próxima sesión via el 4º hook.

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. Los 4 hooks SessionStart (s60) ejecutan en cadena: git pull --rebase + hot-cache-sync + timezone-sync + claude-method-sync (propaga global-agents/skills/ automáticamente)
3. El dev describe la tarea

Durante la sesión

• Claude sigue las 26 reglas de oro de CLAUDE.md + las directrices Karpathy (CLAUDE.md sección 12)
• Actualiza docs incrementalmente (Regla 3)
• Consulta la Biblioteca antes de cualquier tarea no trivial (Regla 0 — bib_ask / bib_search_semantic / read_guide)
• Subagentes Opus/Sonnet según la tarea (Regla 10)
• Agentes/MCP especializados antes que general-purpose (Regla 26 — design-collaborator, wiki_*, bib_*)

Final de sesión

1. Commit cambios pendientes y push inmediato (sin [skip ci], sea código o docs)
2. RELEASE_NOTES.md actualizado si hubo cambios funcionales
3. WORKLOG.md actualizado con resumen de la sesión
4. claude-backup.ps1 -PushGit (backup dual OneDrive + GitHub) 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 siempre inmediato tras commit, sin [skip ci] (sea código, docs o mixto)
• 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

Véase también

• [[ia-tech—metodo—claude-method-guide]] — claude method guide
• [[crearack-tech—method—harness-guide]] — guía maestra del Harness (sustituye a ia-tech--metodo--harness-engineering archivada)
• [[workspace-tech—tecnico—workspace-technical]] — stack técnico
• [[workspace—guias—team-processes]] — procesos de equipo
• [[workspace—onboarding—onboarding-edu]] — onboarding Edu
• [[workspace—onboarding—onboarding-dani]] — onboarding Dani