commits-real

Files (1)

• SKILL.md

SKILL.md (first lines)

# Skill: commits-real

Commits que cuentan una historia, no que parecen generados por una máquina.

## Trigger

- Terminaste un cambio y hay que comitear
- Estás creando un PR o issue
- Necesitás actualizar un CHANGELOG
- Vas a versionar semver

## Modos de commit

### Modo Humano (default — español rioplatense)
Cálido, claro, directo. Como si se lo explicaras a un colega.

```
feat(api): agrego endpoint de login pa que los users entren tranqui

Ahora se puede autenticar con email + password. Devuelve un JWT
con expiración de 24hs. Implementé middleware de verificación
también, así que ya estamos cubiertos del lado del server.

Closes #42
```

```
fix(data): corrijo el cálculo de interés compuesto

El error estaba en la línea 47 — estaba usando la tasa nominal
cuando tenía que ser la tasa efectiva mensual. Afectaba todos
los préstamos con periodo > 30 días.
```

```
feat(ui): agrego dark mode que tanto venías pidiendo

Toggle en el header, usa CSS variables, persiste en localStorage.
Anda en todos los browsers que importan.
```

### Modo Técnico (inglés — para proyectos open source / internacional)
Conventional Commits clásico en inglés US.

```
feat(api): add JWT authentication endpoint

Implements email+password login returning a signed JWT.
Token expires in 24h. Includes middleware for route protection.

Closes #42
```

## Reglas de oro

1. **Máximo 300 líneas por commit/PR/issue** — si supera, usá `chained-pr`
2. **Atomic commits** — un cambio lógico por commit
3. **Contá una historia** — el título dice QUÉ, el body dice POR QUÉ y el PATRÓN
4. **Nunca hagas commit sin testear antes** — primero delegá a `lend-ai-testing`
5. **Engram siempre** — guardá lo que se hizo con mem_save

## Workflow LEND

1. ANALIZAR
   ├── ¿Qué cambió? archivos, funcionalidad, bug, refactor?
   ├── Scope: ¿qué módulo? (api, ui, data, infra, docs)
   ├── Breaking: ¿rompe compatibilidad hacia atrás?
   └── Issues: ¿hay issues o PRs relacionados?

2. OFRECER (Menú del Senior)
   ├── A) Modo humano — español rioplatense, título + breve descripción
   ├── B) Modo técnico — conventional commit en inglés
   ├── C) Full — commit + PR + changelog update
   └── D) Chained PR — si supera 300 líneas, partilo en PRs encadenados

3. ELEGIR → user confirma

4. HACER (PRE-COMMIT GATES primero!)
   ├── ¿Ya corriste tests? Si no → `task('lend-ai-testing', 'verificar que todo anda')`
   ├── ¿Está todo en verde? Ok seguí
   ├── ¿Supera 300 líneas? → `task('chained-pr', ...)`, no commits gigantes
   ├── Formato humano: `tipo(scope): título en español cálido`
   ├── Tipos: feat, fix, chore, docs, refactor, test, style, perf, ci
   ├── Mensaje: imperativo, presente, < 60 chars título, < 80 chars body
   ├── Atomic: un cambio por commit
   └── Issues: `Closes #123` en el body

5. VERIFICAR
   ├── El mensaje es claro y útil para el futuro
   ├── No hay archivos no relacionados
   ├── Breaking changes están documentados
   └── Tests pasan (siempre)

### Post-task (siempre)
1. mem_save a Engram con lo que se hizo
2. Revisar si hay que actualizar docs (README, AGENTS.md, ARCHITECTURE.md)

## Regla del título (modo humano)

```
tipo(scope): qué hace, en menos de 60 caracteres, en español

Tipos: feat (nueva funcionalidad), fix (bug fix), refactor, test,
       docs, style, chore, perf, ci
Scope: api, ui, data, infra, docs, deps, config

Ejemplos:
  feat(api): agrego ruta de login con JWT
  fix(data): corrijo cálculo de interés compuesto
  refactor(ui): extraigo Navbar a componente separado
  test(api): agrego tests para auth middleware
  docs(readme): actualizo ejemplos de uso
  chore(deps): actualizo pandas a 2.0
```

## Comment/Voice rules (PRs, issues, reviews)

- **Cálido y directo**: "Che, esto está mal porque..." no "Se sugiere reconsiderar..."
- **Corto**: 1-2 oraciones. Expandí solo si hace falta.

From LeandroBenjaminL/lend-ai, MIT.

More from LeandroBenjaminL/lend-ai