Saltar al contenido principal

PARA TODOS

Estructura un proyecto — /kit-init

/kit-init es la forma en que un proyecto consigue su equipo. Lo ejecutas una vez, respondes unas pocas preguntas amables, y el kit escribe un .claude/ ordenado y autocontenido, moldeado en torno al tipo de trabajo que haces.

Qué te pregunta​

Cuando ejecutas /kit-init, te guía por una configuración breve:

  • Perfil — el equipo de partida (software, content, research, automation o minimal).
  • Repo — tu repo de GitHub, para que el flujo de trabajo de tareas tenga dónde vivir.
  • Tablero — si quieres activar un tablero de GitHub Projects.
  • Memoria — si quieres mantener una memoria por proyecto (desactivada por defecto).
  • Idioma — el idioma en el que se comunica el equipo.

Luego estructura .claude/ y un punto de entrada CLAUDE.md. Todo lo demás — roles, hitos, formato del plan — se deriva de tus elecciones.

Vista previa antes de confirmar​

Nunca tienes que estructurar a ciegas. Pídele a /kit-init una vista previa, o ejecútalo con --dry-run, y te imprimirá exactamente qué archivos escribiría — sin escribir nada.

# Mira primero, luego hazlo de verdad
/kit-init --dry-run
/kit-init

Configuración de herramientas opcional​

Durante la configuración, /kit-init ofrece conectar algunas herramientas — y explica cada una antes de tocar nada:

  • gh (GitHub CLI) — comprueba que has iniciado sesión y se ofrece a iniciarla por ti. Impulsa el flujo de trabajo de tareas/PR.
  • MemPalace — solo si activas la memoria. Registra el servidor de memoria (o te guía para instalarlo). Permanece inactivo y nunca da error hasta que está presente.
  • gws (Google Workspace CLI) — solo si trabajas con Google Docs/Sheets/Slides/Drive/Gmail. En caso contrario, se omite.

Nada se instala ni se autentica sin tu visto bueno.

Qué aterriza en tu proyecto​

your-project/
  CLAUDE.md              # entry point — points the team at .claude/
  .claude/               # agents · skills · rules · kit.config.json · settings
  docs/plans/            # implementation / ops plans
  scripts/               # kit helpers (labels, milestones, task board, …)
  …your code…

Haz commit de .claude/ y todo tu equipo compartirá exactamente la misma configuración.

Un proyecto cada vez​

claude-kit es por proyecto. En un espacio de trabajo o monorepo, ejecuta /kit-init en cada proyecto en lugar de una sola vez en la raíz — detecta en qué situación te encuentras y recomienda en consecuencia. Por qué: cada proyecto obtiene su propia "ala" de memoria, y su configuración viaja con su repo. Más en Múltiples proyectos.

Cómo funciona por dentro
  • El motor. /kit-init ejecuta scripts/init.sh, un sencillo motor de sustitución y condicionales en bash. Lee el profiles/*.json elegido, sustituye los valores de tu proyecto en las templates/ ({{VARS}}) y resuelve los bloques condicionales — IF:MEMORY, IF:PROJECTS_V2, IF:PLANS, IF:DESIGN — en un .claude/ recién creado.
  • Flags. --profile <software|content|research|automation|minimal>, --target <dir>, --name, --slug, --repo, --memory <on|off>, --speckit <on|off>, --prepush "<command>", --lang, además de --dry-run (solo plan) y --upgrade (la fusión segura que usa /kit-update).
  • Una única fuente de verdad. Las skills leen los valores en vivo desde .claude/kit.config.json en tiempo de ejecución, así que el proyecto tiene una sola configuración con la que todo el equipo está de acuerdo.
  • Requisitos. jq, perl, git y bash 3.2+. gh (autenticado) para el flujo de trabajo.

A dónde ir después​