Quick Start del método Claude

Quick Start — Aplicar Claude Method a un proyecto nuevo

Setup completo en ~30 minutos (proyecto nuevo). Onboarding de un dev en un equipo con el metodo ya instalado: ~5 minutos con bootstrap-profile.ps1.

Prerequisitos

Git instalado
Node.js 18+ (npm install -g @anthropic-ai/claude-code)
pnpm (npm install -g pnpm)
PowerShell 7+ (Windows) o bash (macOS/Linux)
GitHub CLI (gh) — necesario para la Regla “verificar CI tras push”
Cuenta Claude con plan Max/Pro
El proyecto ya tiene un repo git

Caso A · Onboardear a un dev nuevo en un equipo con claude-method ya instalado

Si el proyecto ya usa el metodo y un nuevo dev se incorpora, el flujo recomendado es una sola invocacion de bootstrap-profile.ps1 (Windows Proxmox o cualquier Windows):

irm https://raw.githubusercontent.com/<ORG>/claude-method/main/onboarding/bootstrap-profile.ps1 -OutFile $env:TEMP\bootstrap-profile.ps1

& $env:TEMP\bootstrap-profile.ps1 -DevName "Dani" -DevRole "Dev" -BibToken "<bearer-token-personal>" `
    -GitUserName "Dani" -GitUserEmail "dfuentes@esfericlabs.com" -GitHubUsername "dfuentes-esfericlabs"

-GitUserName/-GitUserEmail son necesarios: sin identidad git, git commit falla y el backup de memoria queda staged sin subir (lección s82).

Hace: verifica prereqs → crea C:\dev\ → clona los 3 repos del equipo → invoca setup-claude-code.ps1 (que configura 4 hooks SessionStart desde s60: auto-pull + hot-cache + timezone-sync + claude-method auto-sync) → instala hooks pre-commit en ambos repos → copia global-agents/ + global-skills/ (Design Toolkit) a ~/.claude/ → registra el MCP via .mcp.json local con los 3 headers (Bearer + 2 CF Access) → imprime guia final.

El lead del proyecto debe haber completado primero los pasos de claude-method/onboarding/lead-checklist.md (invitar en GitHub, generar Bearer token personal, compartirlo por canal privado).

Caso B · Arrancar Claude Method en un proyecto nuevo

Si aplicas el metodo a un proyecto que nunca lo ha usado, sigue los pasos 1-6 abajo (setup completo ~30 min).

Paso 1: CLAUDE.md (5 min)

cp claude-method/templates/CLAUDE.md.template mi-proyecto/CLAUDE.md

Editar y rellenar:

Nombre del proyecto, version, descripcion
Stack tecnico completo
Equipo (nombres, roles)
Comandos de desarrollo (start, test, logs)
URLs del entorno
Estructura del proyecto

Esto es lo mas importante. Un buen CLAUDE.md elimina el 80% de los errores del agente porque le da contexto correcto desde el inicio.

Paso 2: Harness Engineering (5 min)

El instalador canonico escribe el git hook en el repo destino (los 4 checks corren desde claude-method/harness/, no se copian):

cd mi-proyecto
bash C:/dev/claude-method/harness/install_hooks.sh

Escribe mi-proyecto/.git/hooks/pre-commit, que invoca estos 4 checks desde la fuente:

Check	Que valida
`pre_commit_check.py`	LOC < 500 · SQL injection (patterns MAYUSCULAS) · `\|safe` en templates · settings criticos (CONN_MAX_AGE) · formatter gemelo del CI (ruff/biome)
`bib_report_check.py`	Cada archivo de codigo MODIFIED tiene `bib_report_change` en los ultimos 10 min. Bypass puntual: `BIB_SKIP=1` (logueado en Pulse). Requiere MCP workspace con Biblioteca
`wiki_front_matter_check.py`	Paginas Supercontexto (wiki) tienen front-matter valido (type/slug/status/owner)
`check_astro_schemas.py`	Si cambia `content.config.ts` o `src/content/`, correr `pnpm astro sync` para validar schema Zod

Si tu proyecto no tiene Biblioteca todavia, bib_report_check.py degrada gracefully con warning (requiere BIB_MCP_TOKEN env var; sin eso hace skip).

Personalizar pre_commit_check.py en claude-method/harness/ (fuente única, ya no hay copias por repo) si hace falta: ajustar MAX_LOGIC_LOC, anadir SETTINGS_CHECKS propios, etc. Regla 18 (Pre-commit gemelo de CI): cada check que corre en tu CI debe tener su gemelo local aqui.

Fitness tests opcionales:

cp C:/dev/claude-method/harness/fitness_template.py mi-proyecto/tests/test_architecture_fitness.py

Paso 3: Agentes (10 min por agente)

Si tienes un workspace separado:

mkdir -p mi-workspace/agents/{dev,biz,ops,support}
cp claude-method/agents/TEMPLATE.md mi-workspace/agents/dev/mi-agente.md

Rellenar las 8 secciones del template. Empezar con 1-2 agentes y anadir segun necesidad.

Paso 4: Onboarding (10 min)

Para el primer dev del proyecto (tu mismo, el lead):

# Desde cualquier carpeta en PowerShell
& C:\dev\claude-method\onboarding\setup-claude-code.ps1 `
    -DevName "Edu" -DevRole "CEO-Dev" `
    -ProjectDir "C:\dev\mi-proyecto" `
    -WorkspaceDir "C:\dev\mi-workspace" `
    -McpUrl "https://workspace.miempresa.com/api/mcp" `
    -BibToken "<bearer-token-personal>" `
    -GitUserName "Edu" -GitUserEmail "eesquembri@esfericlabs.com" -GitHubUsername "Esquembri"

Para los devs siguientes el onboarding es via bootstrap-profile.ps1 (ver Caso A arriba).

Personalizar onboarding-template.md con los placeholders del proyecto (ver onboarding/lead-checklist.md § 4) y copiarlo al workspace para que los devs lo consulten.

Anadir memorias especificas del proyecto en mi-workspace/onboarding/shared-memory/ (footguns, feedback, infra). Las genericas reusables viven en claude-method/onboarding/shared-memory/ y se sincronizan via claude-method-sync.ps1 — desde s60 el 4º hook SessionStart pulea claude-method y propaga global-agents/ + global-skills/ a ~/.claude/ automáticamente en cada sesión (las memorias compartidas siguen requiriendo setup-claude-code.ps1 para evitar pisar divergencias locales).

Ascender un agente o skill local al método central (s60)

Si un dev creó un agente o skill en ~/.claude/{agents,skills} y lo quiere compartir con el staff: pwsh C:/dev/claude-method/harness/claude-method-promote.ps1 -Type {agent|skill} -Name <slug>. Detecta CREATE/UPDATE/IDENTICAL, valida frontmatter (name: + description: obligatorios), copia al central + commit + push. Los demás reciben en su próxima sesión via el 4º hook. Convención humana: antes de invocar, “¿esto es transversal o solo del proyecto?” — si es del proyecto, va en <repo>/.claude/skills/, no aquí.

Paso 5: Workflow (5 min)

Integrar las reglas de git flow en el CLAUDE.md del proyecto:

Rebase obligatorio antes de push
Feature branches por dev
Commit rules (tipos, docs incrementales)

Si hay 2+ devs: crear WORKLOG.md:

cp claude-method/templates/WORKLOG.md.template mi-workspace/WORKLOG.md

Paso 6: Biblioteca + Wiki Supercontexto (recomendado si >50 endpoints)

Para proyectos grandes, la Biblioteca da a Claude contexto on-demand sin inflar la ventana. Dos componentes complementarios:

Knowledge graph — bib_* tools (bib_ask, bib_context_query, bib_impact_query, etc.). Indexa codigo + docs del proyecto. Ver biblioteca/ARCHITECTURE.md.
Wiki Supercontexto — wiki_* tools. Wiki auto-mantenida por bibliotecarios latentes (Ingest post-merge, Curator diario, Lint diario, Utility diario). Implementacion de referencia: CreaRackSL-workspace (Fases 0-6 completadas 22-04-2026).

Si adoptas el Supercontexto para iniciativas largas: public/supercontext/STATE.md + LOG.md + briefings/NEXT.md (patron de continuidad multi-sesion).

Para proyectos pequenos (<50 endpoints, 1-2 devs): el harness pre-commit + memoria local de Claude Code basta.

Verificacion

CLAUDE.md existe y tiene las secciones basicas
git commit muestra [OK] Harness checks passed
Claude Code carga el contexto al iniciar (/memory muestra memorias)
Al menos 1 agente definido
WORKLOG.md creado (si multi-dev)
Onboarding probado con al menos 1 dev

Despues del setup

Anadir footguns a shared-memory/ cuando los descubras
Revisar y actualizar agentes cuando el dominio evolucione
Actualizar CLAUDE.md con cada cambio de stack o arquitectura
Las memorias de feedback se acumulan automaticamente

Véase también

[[ia-tech—metodo—lead-checklist]]
[[ia-tech—metodo—onboarding-template]]
[[ia-tech—metodo—harness-engineering]]
[[ia-tech—metodo—biblioteca-architecture]]
[[ia-tech—metodo—claude-method-guide]]
[[feature—method—onboarding-v2]]