| name | cost-budgeting |
| description | Cost Budget Enforcement (COST-001) — enforces per-session, per-hour, and per-day AI spend limits across all agents and models. Blocks task execution when budgets are exceeded and emits structured alerts for operator action. Integrates with model-selection (COST-003) to pre-screen model choices against budget headroom.
|
| license | Proprietary |
| compatibility | agentic-engineers framework v5.10+ |
| metadata | {"author":"agentic-engineers","version":"1.0","category":"cost","role":"orchestrator","model":"claude-haiku-4-5","effort":"low","runtime":"python3","spec":"COST-001"} |
| entry_points | ["scripts/cost_budgeter.py"] |
| tests | ["tests/test_cost_budgeter.py"] |
| coverage_minimum | 85 |
COST-001: Cost Budget Enforcement
Enforces per-session, per-hour, and per-day spend limits on AI usage across all agents.
API
CostBudgeter
from src.skills.cost_budgeting.scripts.cost_budgeter import CostBudgeter
budgeter = CostBudgeter(session_limit=1.0, hourly_limit=5.0, daily_limit=20.0)
result = budgeter.check_budget(estimated_cost=0.05)
Usage
Use this skill to gate task execution against configured spend limits. Invoked
automatically by the Orchestrator before delegating to expensive models.
Budget tiers
| Tier | Default | Configurable |
|---|
| Session | $1.00 | Yes |
| Hourly | $5.00 | Yes |
| Daily | $20.00 | Yes |
Dependencies
- No runtime dependencies on other skills.
model-selection (COST-003) depends on this skill to check headroom before recommending models.
Spec compliance
Implements COST-001 from src/specs/SPEC.md.
Self-Improvement
This skill participates in the framework's continuous improvement cycle
(see skill-improvement-feedback).
When you use cost-budgeting during a task, include a skill_feedback entry
in your HANDBACK to help improve it over time:
skill_feedback:
- skill_name: cost-budgeting
effectiveness_score: 0.85
clarity_score: 0.90
coverage_gaps:
- "Specific scenario the skill did not address"
improvement_suggestions:
- "Concrete change that would have helped"
usage_context: "One sentence on how you used this skill"
Positive feedback is as valuable as critical feedback. Three or more
feedback items for this skill automatically trigger an improvement task.
