Volver a la wiki

Onboarding v2 → v3 — shared-memory consolidada + bootstrap-profile

Onboarding v2 → v4 — shared-memory + bootstrap + propagador bidireccional

Actualizacion 2026-04-23 (v3): la v2 introdujo setup-claude-code.ps1 asumiendo repos clonados. La v3 añade bootstrap-profile.ps1 como script “todo-en-uno” para maquinas vacias (Windows Proxmox nuevas del equipo): prereqs check + clone 3 repos + setup Claude Code + install hooks. Ver “Como usarla” abajo. El resto del documento describe la v2 subyacente.

Actualizacion 2026-04-25 (v3.1): Step 5 de setup-claude-code.ps1 ahora registra 2 MCPs en una sola pasada — workspace (OAuth privado) + context7 (HTTP público, sin token, docs frescas de libs externas como Django, Astro, HTMX, Tailwind, CF Workers, etc.). Validado en sesión 28 Supercontexto con tests Django Channels + Astro 5. Aplicable también a las máquinas existentes ejecutando el script de nuevo (idempotente: claude mcp add no duplica). Ver claude-method/onboarding/CLAUDE-PROFILE-ARCHITECTURE.md § 3.4 para detalle.

Actualización 2026-05-13 (v4): propagador bidireccional cerrado en sesión s60. (a) Gap 1 cerrado: cuarto comando claude-method auto-sync en hook SessionStart (claude-method-sync.ps1 -SkipHook -SkipMemory envuelto en try/catch + exit 0) — los cambios upstream en global-agents/ + global-skills/ llegan automáticamente a ~/.claude/ de cada miembro al arrancar cada sesión Claude Code. (b) Gap 2 cerrado: nuevo script claude-method/harness/claude-method-promote.ps1 para ascender un agente o skill local al método central + commit + push, con detección automática CREATE/UPDATE/IDENTICAL + validación de frontmatter (name: + description:). Convención humana: antes de promover, “¿es transversal o solo del proyecto?”. Detalle en claude-method/onboarding/CLAUDE-PROFILE-ARCHITECTURE.md § 3.7 (auto-sync) + § 3.8 (promote).

Actualización 2026-07-26 (s239): la decisión v4 de “memorias a mano” quedó superada — las memorias compartidas convergen AUTOMÁTICAMENTE en cada SessionStart desde el filtro por rol (s101), y desde s237/s239 el sync aplica además tombstones, aviso anti-huérfanas e índice auto-generado shared_memory_index.md. El tooling transversal viaja desde s186 dentro de los plugins (method + crearack), leídos en vivo del repo. Ver “claude-method-sync” abajo y [[ia-tech—metodo—os-audit-y-backtrack]] §4.

Onboarding v2 — shared-memory consolidada

User value

Onboarding v2 elimina fricción de arranque de nuevas sesiones de Claude Code en el workspace. En lugar de reconstruir contexto manualmente cada vez, el agente lee una shared-memory consolidada que describe el estado real: estructura de carpetas, decisiones de arquitectura, convenciones activas y rol del agente. Resultado: primera respuesta útil llega en la primera interacción, sin rondas de preguntas exploratorias.

Cómo usarla

v3 · bootstrap-profile.ps1 (máquina vacía, recomendado para Proxmox)

Un solo comando desde una Windows nueva:

# claude-method es PRIVADO → descarga autenticada con gh (irm a raw.githubusercontent da 404)
gh auth status   # si no: gh auth login → GitHub.com → HTTPS → navegador
gh api repos/CreaRackSL/claude-method/contents/onboarding/bootstrap-profile.ps1 -H "Accept: application/vnd.github.raw" | Out-File -Encoding utf8 "$env:TEMP\bootstrap-profile.ps1"
& $env:TEMP\bootstrap-profile.ps1 -DevName "Dani" -DevRole "Dev" -BibToken "<token>" `
    -GitUserName "Dani" -GitUserEmail "dfuentes@esfericlabs.com" -GitHubUsername "dfuentes-esfericlabs"

Hace en 5 fases: verifica prereqs (git, node, pnpm, pwsh 7+, gh, bash, claude) → crea C:\dev\ y clona los 4 repos (incl. claude-backups) → invoca setup-claude-code.ps1 → instala hooks en ambos repos del proyecto → imprime guía final. Modo -DryRun disponible para validar sin side-effects.

v2 · setup-claude-code.ps1 (máquina con repos ya clonados)

Si el dev ya tiene los repos:

& C:\dev\claude-method\onboarding\setup-claude-code.ps1 `
    -DevName "Dani" -DevRole "Dev" `
    -ProjectDir "C:\dev\CreaRack-Pro" `
    -WorkspaceDir "C:\dev\CreaRackSL-workspace" `
    -BibToken "<token>" `
    -GitUserName "Dani" -GitUserEmail "dfuentes@esfericlabs.com" -GitHubUsername "dfuentes-esfericlabs"

Configura settings.json con permisos completos, copia memorias compartidas (genéricas + workspace), crea perfil + MEMORY.md, guarda BIB_MCP_TOKEN, registra MCP via OAuth, instala hooks, limpia plugins obsoletos.

claude-method-sync.ps1 (mantener sincronizado)

Desde v4 (s60, 13-05-2026) el sync se dispara solo en cada sesión Claude Code via hook SessionStart. Lo que converge hoy (estado s239, 26-07-2026):

Si necesitas forzar el sync fuera de una sesión Claude Code (ej. tras editar claude-method directamente):

powershell -ExecutionPolicy Bypass -File C:/dev/claude-method/harness/claude-method-sync.ps1

claude-method-promote.ps1 (ascender local → central, v4 / s60)

Inverso del sync. Cuando un miembro crea un agente o skill local en ~/.claude/{agents,skills} y lo quiere compartir con el resto del staff:

pwsh -NoProfile -File C:/dev/claude-method/harness/claude-method-promote.ps1 `
    -Type {agent|skill} -Name <slug>

Detecta CREATE/UPDATE/IDENTICAL/ERROR automáticamente, valida frontmatter (name: + description: obligatorios), copia al central + commit + push directo a claude-method/main. Los demás miembros lo reciben en su próxima sesión. Modos: -DryRun, -NoCommit, -NoPush, -Force (UPDATE). Cierra Gap 2 del propagador.

Implementación

shared-memory reside en C:/dev/CreaRackSL-workspace/onboarding/shared-memory/. Estructura canónica:

Template (C:/dev/claude-method/onboarding/onboarding-template.md) define schema que debe respetar cualquier README.md de shared-memory: encabezado proyecto, propósito, mapa de directorios, convenciones de commits, lista de agentes conocidos con rol. v2 añadió sección “Estado consolidado” que sustituye el bloque de resumen ad-hoc que se incluía antes en CLAUDE.md.

Decisiones

Commits relacionados

Véase también

Subir