github-workflowlisted
Install: claude install-skill derj90/agent-project-template
# Cuándo usar
Usar cuando haya que modificar código, documentación, configuración o artefactos versionados.
# Objetivo
Trabajar con un flujo controlado basado en issues, ramas, commits, pull requests, revisión y verificación antes de integrar cambios.
# Principios
- No trabajar directo sobre `main` salvo cambios triviales explícitamente autorizados.
- Cada cambio debe tener propósito claro.
- Cada rama debe corresponder a una tarea, issue o mejora concreta.
- No mezclar cambios no relacionados.
- No hacer merge sin verificación.
- No desplegar sin confirmación si existe producción real.
# Flujo estándar
1. Revisar estado del repositorio.
2. Identificar o crear issue/tarea.
3. Crear rama de trabajo.
4. Implementar cambios acotados.
5. Verificar localmente.
6. Commit con mensaje claro.
7. Push de la rama.
8. Crear pull request.
9. Revisar diff, CI, seguridad y alcance.
10. Merge solo después de verificación y aprobación requerida.
11. Verificar post-merge si aplica.
# Comandos base
```bash
git status --short --branch
git log --oneline -5
git checkout -b feat/descripcion-corta
git add <archivos>
git commit -m "tipo(scope): descripcion corta"
git push -u origin nombre-rama
```
# Tipos de commit
- `feat`
- `fix`
- `docs`
- `refactor`
- `test`
- `chore`
# Plantilla de PR
```md
## Resumen
## Issue relacionado
## Cambios realizados
## Verificación
## Riesgos
## Evidencia
```
# Anti-patrones
- Trabajar directo en `main` sin motivo.
- Mezclar varias features en una