# Cost Projection

> Extrapolación de gasto a futuro. Calcula una tasa de USD por día a partir de la ventana reciente, proyecta a horizontes de 7d/30d/90d/365d y muestra los días que faltan para agotar el presupuesto.

Fuente: https://skillsagentes.com/skills/ruvnet/ruflo/cost-projection
Markdown: https://skillsagentes.com/skills/ruvnet/ruflo/cost-projection.md

Repositorio: https://github.com/ruvnet/ruflo
Autor: ruvnet
Licencia: MIT
Actualizado: hace 2 meses
Coste de contexto: 67 tok instalada, 704 tok al activarse, 704 tok con todos los archivos del bundle
Bundle: 1 archivo, 3 KB
Permisos que pide: bash

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add ruvnet/ruflo --skill cost-projection --agent claude-code
# Cursor
npx -y skills add ruvnet/ruflo --skill cost-projection --agent cursor
# Codex
npx -y skills add ruvnet/ruflo --skill cost-projection --agent codex
# Gemini CLI
npx -y skills add ruvnet/ruflo --skill cost-projection --agent gemini
# Windsurf
npx -y skills add ruvnet/ruflo --skill cost-projection --agent windsurf
# Cline
npx -y skills add ruvnet/ruflo --skill cost-projection --agent cline
```

## Qué hace

- Calcula una tasa de gasto en USD/día a partir de la ventana de medición reciente (7 días por defecto).
- Extrapola linealmente el gasto a horizontes de 7d/30d/90d/365d.
- Si hay presupuesto configurado, calcula cuántos días faltan para consumir el 75/90/100% al ritmo actual.

## Cuándo usarla

- En planificación de finanzas o SRE, para entregar el dato a un dashboard de presupuesto.
- En gates de CI, para fallar builds cuando el 100% del presupuesto se agotará en menos de una semana.
- Después de un cambio grande de carga de trabajo, para verificar que la tasa no se aceleró más de lo esperado.

## Qué la activa

- "¿Cuándo se va a agotar el presupuesto al ritmo actual?"
- "Proyecta el gasto de los próximos 30 días"
- "¿Cuántos días faltan para llegar al 90% del presupuesto?"

## Antes de instalar

- Lee los registros `session-*` de `cost-tracking`; el desglose de agotamiento de presupuesto requiere tener uno configurado con `cost-budget set`.
- runs shell commands

## Archivos

- SKILL.md — 3 KB

## SKILL.md

Reproducido tal cual desde ruvnet/ruflo bajo MIT. Esta sección es el documento original y está en inglés.

Forward-looking cost projection that pairs with `cost-budget-check`:

- **`cost-budget-check`** answers "have we crossed the line?" — reactive
- **`cost-projection`** answers "when will we cross the line?" — predictive

## Algorithm

1. Read all `session-*` records from the `cost-tracking` namespace (same source `cost-budget-check` uses).
2. Filter to a measurement window (default last 7 days on `capturedAt`/`startedAt`).
3. Compute the per-day burn rate: `windowSpend / windowDays`.
4. Linear-extrapolate to each requested horizon (default 7d/30d/90d/365d).
5. If a budget is configured (`budget-config` key set by `cost-budget set`):
   - Compute "days until 75% / 90% / 100% consumed" at the current rate.
   - Surface as a separate table block with `ALREADY REACHED` markers for thresholds already exceeded.

## Flags

  --window <duration>     Measurement window. `Nh|Nd|Nw|Nm`. Default `7d`.
  --horizons <csv>        Projection horizons. Default `7d,30d,90d,365d`.
  --format table|json     Default `table` (markdown).

Env: `PROJECTION_NAMESPACE` override (default `cost-tracking`), `PROJECTION_QUIET=1` (alias for `--format json`).

## Smoke transcript (3 sessions × $1 over 7d, $20 budget)

```
| Sessions in window | 3 |
| Window spend | $3.000000 |
| **USD per day** | **$0.428571** |
| All-time spend | $3.000000 across 3 sessions |

## Projected spend (linear extrapolation)
| Horizon | Days | Projected spend |
|---|---:|---:|
| 7d | 7 | $3.0000 |
| 30d | 30 | $12.8571 |

## Budget exhaustion ($20.00 configured)
| Threshold | Target | Remaining | Time at current rate |
|---|---:|---:|---|
| 75% | $15.00 | $12.00 | 28.0 days |
| 90% | $18.00 | $15.00 | 35.0 days |
| 100% | $20.00 | $17.00 | 39.7 days |
```

## When to use

- **Finance / SRE planning**: hand the JSON output to a budget dashboard for "are we on track for the quarter?".
- **CI gates**: `cost-projection --format json | jq '.budget.exhaustion[2].daysUntilReached < 7'` → fail builds when 100% exhaustion is < 1 week away.
- **Post-workload-shift sanity check**: after a big feature lands, re-run to verify the rate hasn't accelerated past expectations.

## Stationarity assumption

Linear extrapolation assumes the current rate holds. The footer reminds operators to re-run after workload shifts. For drift detection over MULTIPLE windows, pair with `cost-trend` (which already covers benchmark-drift).

## Dónde encaja

- Categoría: [Finanzas](https://skillsagentes.com/categorias/finanzas.md) — Contabilidad, modelado financiero y flujos de reportes.
- Creador: [ruvnet](https://skillsagentes.com/creators/ruvnet.md) — 275 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Harness Gepa](https://skillsagentes.com/skills/ruvnet/ruflo/harness-gepa.md): Inspecciona y audita genomas GEPA: carga y valida un genoma, renderiza el system prompt que compila, o clasifica los modos de fallo de una transcripción de ejecución.
- [Deepseek Reason](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-reason.md): Completion en modo razonamiento contra deepseek-reasoner (R1) de DeepSeek. Devuelve el chain-of-thought por separado de la respuesta final. Lee DEEPSEEK_API_KEY y degrada si falta o la API no responde.
- [Deepseek Chat](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-chat.md): Completion de un solo turno contra el modelo deepseek-chat de DeepSeek vía /v1/chat/completions. Lee DEEPSEEK_API_KEY y degrada con status:degraded si falta o la API no responde. Para tareas sin razonamiento.
- [Adr Index](https://skillsagentes.com/skills/ruvnet/ruflo/adr-index.md): Construye o reconstruye el índice de ADRs y su grafo de dependencias ejecutando scripts/import.mjs, en vez de cientos de llamadas MCP.
- [Agntcy Status](https://skillsagentes.com/skills/ruvnet/ruflo/agntcy-status.md): Muestra el estado de la integración AGNTCY/SLIM/CASA: si los paquetes están instalados, qué transporte está activo y si el enforcement de CASA está habilitado.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)