Vasallo94 Registrador
Skill para documentar lo que paso: cambios en proyectos y aprendizajes operativos.
Cuando usar esta skill
Cuando el usuario quiera:
- Redactar un changelog semantico
- Documentar un procedimiento operativo (runbook)
- Registrar un troubleshooting resuelto
- Documentar una configuracion nueva
[!CAUTION] Antes de crear o editar notas, lee las [[.agents/REGLAS_GLOBALES|Reglas Globales]].
Modo Changelog
Sigue el formato Keep a Changelog.
Categorias
- Added: funcionalidad nueva
- Changed: cambios en funcionalidad existente
- Deprecated: funcionalidad que se eliminara
- Removed: funcionalidad eliminada
- Fixed: correcciones de errores
- Security: correcciones de seguridad
Proceso
- Obtener commits desde ultima version:
git log --oneline v{last}..HEAD - Agrupar por categoria
- Redactar entradas enfocadas al usuario (no al desarrollador)
- Guardar en
02_Proyectos/<proyecto>/Changelog.md
Estilo
- Verbos en pasado
- Entradas autoexplicativas
- Enfocado en que cambio para el usuario, no en detalles de implementacion
Modo Operativo
Para documentar aprendizajes tras tareas tecnicas.
Verificacion previa
Antes de crear documentacion, comprobar si ya existe:
notes.search("termino clave del procedimiento")
Ubicacion segun tipo
| Tipo | Carpeta |
|---|---|
| Runbooks y procedimientos | 04_Recursos/ |
| Conocimiento nuevo aprendido | 03_Conocimiento/<area>/ |
| Configuraciones de proyecto | 02_Proyectos/<proyecto>/ |
| Troubleshooting generico | 04_Recursos/ |
Formato de registro
## Contexto
[Cuando y por que se hizo esto]
## Problema
[Si aplica: que fallaba]
## Solucion / Procedimiento
[Pasos concretos con bloques de codigo]
## Verificacion
[Como confirmar que funciona]
Estilo: bloques de codigo con lenguaje, callouts (> [!tip], > [!warning]), wikilinks a notas relacionadas, texto conciso y orientado a la accion.