Skill: Cost Management
Prerequisito: @docs/rules/domain/billing-model.md, @docs/rules/domain/cost-tracking.md
Orquesta timesheet logging, budget tracking, forecasting y generación de invoices.
Flujo 1 — Log de horas (log)
- Validar entrada:
date, user, task_id, project, hours (todos requeridos)
hours es decimal ≥ 0.5
user tiene perfil
project existe en projects/{proj}/CLAUDE.md
- Leer rates de
.flow-data/rates.json (o .flow-data/{project}/.rates.local.json)
- Calcular cost = hours × rate_for_role
- Crear entrada JSONL en
.flow-data/timesheets/{user}/{YYYY-MM}.jsonl
- Actualizar ledger: añadir entrada type "time" a
.flow-data/ledger/{project}.jsonl
- Output: confirmación + acumulado del mes
Error handling:
- Horas duplicadas (misma user/task/date): advertir, preguntar si actualizar
- Rate no encontrado: sugerir
/cost-center budget --create-rates
- User sin perfil: sugerir
/profile-setup {user}
Flujo 2 — Informe de costes (report)
Parámetros: --period {YYYY-MM}, --team {nombre}, --project {slug}, --client {slug}
- Recopilar timesheet entries según filtros
- Agregar por:
- Proyecto
- Equipo (si
--team)
- Cliente (si
--client)
- Rol
- Calcular KPIs: cost-per-SP, utilization-rate, burn-rate
- Generar tabla resumen:
Project │ Hours │ Cost (€) │ Team │ Status
────────────┼────────┼──────────┼───────────┼─────────
sala-reservas │ 160 │ 13,600 │ Backend │ On-budget
api-v3 │ 120 │ 14,400 │ Backend │ 5% over
- Guardar en
output/cost-report-{periodo}.md
Flujo 3 — Gestión de presupuestos (budget)
Subcomandos:
--create {project}: crear presupuesto inicial (solicitar total, moneda, fechas)
--update {project}: modificar presupuesto (total, alerts)
--burn {project}: mostrar burn actual vs. presupuesto
--status: comparar todos los proyectos
Output: tabla con budget/actual/remaining/% spent + alertas
Project │ Total │ Spent │ Remaining │ Status
────────────────┼─────────┼────────┼───────────┼──────────
sala-reservas │ €50,000 │ €42,500 │ €7,500 │ 85% ⚠️
api-v3 │ €60,000 │ €48,000 │ €12,000 │ 80% ⚠️
Flujo 4 — Pronóstico (forecast)
- Leer ledger del proyecto
- Calcular:
elapsed_days = hoy - fecha_inicio_presupuesto
burn_rate = actual_burn / elapsed_days
remaining_days = fecha_fin_presupuesto - hoy
EAC = burn_rate × (elapsed_days + remaining_days)
- Comparar
EAC vs. BAC:
- Si EAC > BAC: mostrar riesgo y opciones (reducir scope, extender)
- Si EAC < BAC: proyecto bajo presupuesto
Output: gráfico ASCII de proyección + recomendaciones
Forecast: EAC = €55,200 (BAC = €50,000)
Risk: 10.4% over budget
Options:
1. Reduce scope (descope €5,200 worth of features)
2. Extend timeline (add 2 weeks)
3. Increase budget (request €5,200 approval)
Flujo 5 — Generación de invoices (invoice)
Parámetros: --client {slug}, --period {YYYY-MM}, --status draft|final
- Recopilar timesheet entries para cliente + período
- Agrupar por (project, role)
- Generar invoice JSON con schema de @billing-model.md
- Guardar en
output/invoices/{client}-{YYYY-MM}.json
- Status = "draft" (editable), cambiar a "final" cuando aprobado
- Output: resumen + ruta del PDF
Errores
| Problema |
Solución |
| Horas duplicadas |
Advertir, preguntar si mezclar o descartar |
| Rate no definido |
Crear rate primero con /cost-center budget --create-rates |
| Proyecto sin presupuesto |
Crear presupuesto con /cost-center budget --create {project} |
| Período sin datos |
Mostrar período más reciente disponible |
Seguridad
- Rates are git-ignored:
.flow-data/rates.json nunca en commit
- No PII in invoices: solo @handles, nunca nombres reales
- Ledger is immutable: no editar historial, solo adjustments adelante
- Auditable: cada entrada tiene timestamp y user para trazabilidad
1---2name: cost-management3description: "Skill: Cost Management"4---56# Skill: Cost Management78> Prerequisito: @docs/rules/domain/billing-model.md, @docs/rules/domain/cost-tracking.md910Orquesta timesheet logging, budget tracking, forecasting y generación de invoices.1112## Flujo 1 — Log de horas (`log`)13141. Validar entrada:15 - `date`, `user`, `task_id`, `project`, `hours` (todos requeridos)16 - `hours` es decimal ≥ 0.517 - `user` tiene perfil18 - `project` existe en `projects/{proj}/CLAUDE.md`192. Leer rates de `.flow-data/rates.json` (o `.flow-data/{project}/.rates.local.json`)203. Calcular cost = hours × rate_for_role214. Crear entrada JSONL en `.flow-data/timesheets/{user}/{YYYY-MM}.jsonl`225. Actualizar ledger: añadir entrada type "time" a `.flow-data/ledger/{project}.jsonl`236. Output: confirmación + acumulado del mes2425Error handling:26- Horas duplicadas (misma user/task/date): advertir, preguntar si actualizar27- Rate no encontrado: sugerir `/cost-center budget --create-rates`28- User sin perfil: sugerir `/profile-setup {user}`2930## Flujo 2 — Informe de costes (`report`)3132Parámetros: `--period {YYYY-MM}`, `--team {nombre}`, `--project {slug}`, `--client {slug}`33341. Recopilar timesheet entries según filtros352. Agregar por:36 - Proyecto37 - Equipo (si `--team`)38 - Cliente (si `--client`)39 - Rol403. Calcular KPIs: cost-per-SP, utilization-rate, burn-rate414. Generar tabla resumen:42 ```43 Project │ Hours │ Cost (€) │ Team │ Status44 ────────────┼────────┼──────────┼───────────┼─────────45 sala-reservas │ 160 │ 13,600 │ Backend │ On-budget46 api-v3 │ 120 │ 14,400 │ Backend │ 5% over47 ```485. Guardar en `output/cost-report-{periodo}.md`4950## Flujo 3 — Gestión de presupuestos (`budget`)5152Subcomandos:53- `--create {project}`: crear presupuesto inicial (solicitar total, moneda, fechas)54- `--update {project}`: modificar presupuesto (total, alerts)55- `--burn {project}`: mostrar burn actual vs. presupuesto56- `--status`: comparar todos los proyectos5758Output: tabla con budget/actual/remaining/% spent + alertas5960```61Project │ Total │ Spent │ Remaining │ Status62────────────────┼─────────┼────────┼───────────┼──────────63sala-reservas │ €50,000 │ €42,500 │ €7,500 │ 85% ⚠️64api-v3 │ €60,000 │ €48,000 │ €12,000 │ 80% ⚠️65```6667## Flujo 4 — Pronóstico (`forecast`)68691. Leer ledger del proyecto702. Calcular:71 - `elapsed_days` = hoy - fecha_inicio_presupuesto72 - `burn_rate` = actual_burn / elapsed_days73 - `remaining_days` = fecha_fin_presupuesto - hoy74 - `EAC` = burn_rate × (elapsed_days + remaining_days)753. Comparar `EAC` vs. `BAC`:76 - Si EAC > BAC: mostrar riesgo y opciones (reducir scope, extender)77 - Si EAC < BAC: proyecto bajo presupuesto7879Output: gráfico ASCII de proyección + recomendaciones8081```82Forecast: EAC = €55,200 (BAC = €50,000)83Risk: 10.4% over budget84Options:85 1. Reduce scope (descope €5,200 worth of features)86 2. Extend timeline (add 2 weeks)87 3. Increase budget (request €5,200 approval)88```8990## Flujo 5 — Generación de invoices (`invoice`)9192Parámetros: `--client {slug}`, `--period {YYYY-MM}`, `--status draft|final`93941. Recopilar timesheet entries para cliente + período952. Agrupar por (project, role)963. Generar invoice JSON con schema de @billing-model.md974. Guardar en `output/invoices/{client}-{YYYY-MM}.json`985. Status = "draft" (editable), cambiar a "final" cuando aprobado996. Output: resumen + ruta del PDF100101## Errores102103| Problema | Solución |104|----------|----------|105| Horas duplicadas | Advertir, preguntar si mezclar o descartar |106| Rate no definido | Crear rate primero con `/cost-center budget --create-rates` |107| Proyecto sin presupuesto | Crear presupuesto con `/cost-center budget --create {project}` |108| Período sin datos | Mostrar período más reciente disponible |109110## Seguridad111112- **Rates are git-ignored**: `.flow-data/rates.json` nunca en commit113- **No PII in invoices**: solo @handles, nunca nombres reales114- **Ledger is immutable**: no editar historial, solo adjustments adelante115- **Auditable**: cada entrada tiene timestamp y user para trazabilidad