---
name: primer
description: Inicializa configuración de Claude para un repositorio generando CLAUDE.md personalizado
disable-model-invocation: true
user-invocable: true
allowed-tools: Bash, Read, Write, Edit, AskUserQuestion
---

# primer

Inicializa la configuración de Claude para un repositorio. Solicita información al usuario, analiza la estructura y genera `CLAUDE.md` personalizado.

## Sintaxis

```bash
/primer
```

## Cuándo usar

- Al configurar Claude Code por primera vez en un repositorio
- Para regenerar instrucciones de Claude
- Después de cambios significativos en arquitectura

## Precondiciones

- [ ] Estamos en la raíz de un repositorio git
- [ ] Existe la carpeta `.claude/`

## Flujo

### 1. Verificar repo git

```bash
git rev-parse --is-inside-work-tree
```

### 2. Analizar estructura

```bash
ls -la
ls -la package.json go.mod Cargo.toml pyproject.toml 2>/dev/null
find . -maxdepth 2 -type d -not -path '*/\.*' | head -30
cat README.md 2>/dev/null | head -50
```

### 3. Solicitar información al usuario

**Pregunta 1 - Descripción:**
- ¿Qué hace el proyecto?
- ¿Cuál es su propósito?

**Pregunta 2 - Stack tecnológico:**
- Lenguajes, frameworks
- Base de datos
- Herramientas

**Pregunta 3 - Convenciones:**
- Estilo de código
- Naming conventions
- Patrones preferidos

**Pregunta 4 - Flujo de trabajo:**
- Manejo de ramas
- Proceso de PR/review
- Deploy

**Pregunta 5 - Comandos importantes:**
- Build, test, lint, deploy

**Pregunta 6 - Restricciones:**
- Archivos que no tocar
- Patrones a evitar

### 4. Generar CLAUDE.md

```markdown
# Instrucciones para Claude - [Nombre]

## Descripción del proyecto
[...]

## Stack tecnológico
- [...]

## Estructura del proyecto
[...]

## Convenciones
### Código
- [...]

### Git
- [...]

## Comandos importantes
| Comando | Descripción |
|---------|-------------|
| ... | ... |

## Restricciones
- [...]
```

### 5. Mostrar y confirmar

```
He generado CLAUDE.md. ¿Te parece bien?
- Si correcto: commit y push
- Si ajustes: edita y ejecuta /git-push
```

### 6. Ejecutar /git-push

Si confirma, crear rama `quick/primer-claude-md` e integrar.

## Convenciones

- Preguntar, no asumir
- Priorizar información del usuario
- Estructura clara en CLAUDE.md

## Reglas

- SIEMPRE preguntar al usuario
- Confirmar antes de guardar
- No sobrescribir sin avisar