Skill: Client Profile Manager
Regla: @docs/rules/domain/client-profile-config.md Hub: @docs/rules/domain/savia-hub-config.md
Prerequisitos
SaviaHub debe existir. Verificar:
[ -d "$SAVIA_HUB_PATH/.git" ] || echo "ERROR: Run /savia-hub init first"
Variable SAVIA_HUB_PATH default: $HOME/.savia-hub
Flujo: Crear cliente
- Recibir nombre del cliente
- Generar slug: minúsculas, sin acentos, kebab-case
- Verificar unicidad:
[ ! -d "$SAVIA_HUB_PATH/clients/$SLUG" ] - Crear directorio:
mkdir -p "$SAVIA_HUB_PATH/clients/$SLUG/projects" - Crear
profile.mdcon plantilla:--- name: "{nombre}" slug: "{slug}" sector: "" since: "{YYYY-MM}" status: "active" sla_tier: "standard" primary_contact: "" last_updated: "{YYYY-MM-DD}" --- ## Descripción (Completar con datos del cliente) ## Dominio (Área de negocio, terminología, conceptos clave) ## Stack tecnológico (Lenguajes, frameworks, infraestructura) ## Metodología (Scrum/Kanban/Savia Flow, sprint duration) - Crear
contacts.mdcon plantilla:# Contactos — {nombre} | Nombre | Rol | Área | Email | Notas | |--------|-----|------|-------|-------| - Crear
rules.mdcon plantilla:# Reglas — {nombre} ## Reglas de negocio (Definir reglas del dominio del cliente) ## Restricciones técnicas (Limitaciones de infraestructura, compatibilidad) ## Convenciones de comunicación - Idioma: - Horario: - Canal preferido: - Actualizar
.index.md: añadir fila con slug, nombre, sector, 0 proyectos, fecha - Git commit:
[savia-hub] client: create {slug} - Si remote + no flight-mode → push (delegar a savia-hub-sync skill)
Flujo: Mostrar cliente
- Verificar existencia:
[ -d "$SAVIA_HUB_PATH/clients/$SLUG" ] - Leer frontmatter de
profile.md→ extraer campos - Contar líneas en
contacts.md(excluir header) → N contactos - Contar reglas en
rules.md→ N reglas - Listar subdirectorios en
projects/→ N proyectos - Obtener última fecha commit:
git log -1 --format=%ci -- "clients/$SLUG/" - Formatear output con banner 🏢
Flujo: Editar cliente
- Verificar existencia del slug
- Mapear sección al fichero: profile→profile.md, contacts→contacts.md, rules→rules.md
- Leer fichero actual → mostrar al PM
- Aplicar ediciones solicitadas
- Actualizar
last_updateden profile.md si se modificó cualquier fichero - Commit:
[savia-hub] client: update {slug}/{section} - Si remote + no flight-mode → push
Flujo: Listar clientes
- Leer
clients/.index.md - Verificar coherencia: comparar con directorios reales en
clients/ - Si hay discrepancias → regenerar índice:
- Recorrer cada
clients/*/profile.md - Extraer name, sector del frontmatter
- Contar subdirs en projects/
- Obtener fecha último commit
- Recorrer cada
- Mostrar tabla formateada con total
Flujo: Añadir proyecto a cliente
- Verificar existencia del slug del cliente
- Generar project-slug: kebab-case
- Crear
clients/{slug}/projects/{project-slug}/metadata.md:--- name: "{project-name}" slug: "{project-slug}" status: "active" stack: [] pm_tool: "" created: "{YYYY-MM-DD}" --- - Actualizar conteo en
.index.md - Commit:
[savia-hub] client: add project {slug}/{project-slug}
Errores y recuperación
| Error | Mensaje | Acción |
|---|---|---|
| SaviaHub no existe | ❌ SaviaHub no inicializado |
Sugerir /savia-hub init |
| Cliente ya existe | ⚠️ Cliente {slug} ya existe |
Mostrar /client-show |
| Slug no encontrado | ❌ Cliente {slug} no encontrado |
Listar similares con fuzzy match |
| Profile sin frontmatter | ⚠️ profile.md sin frontmatter |
Regenerar desde plantilla |
Seguridad
- NUNCA escribir secrets, tokens o passwords en ficheros de cliente
- SIEMPRE confirmar con PM antes de push al remote
- contacts.md con PII → informar que puede añadirse a
.gitignore