decisions-headroom
Use when a DecisionsAI, Codex, Cursor, or Claude task contains unusually large logs, files, JSON, search results, or tool output that should be compressed locally without losing access to the original
SKILL.mdskills/decisions-headroom/SKILL.md
GitHubDecisionsAI Headroom
Headroom is bundled with DecisionsAI and its standalone MCP is enabled by default in DecisionsAI, Codex, and Cursor. The MCP keeps original content in a local store and does not require the provider traffic proxy. Use it when large context would otherwise crowd out the task instructions or implementation state.
Tools
headroom_compress: compress a large text payload locally and return a hash.headroom_retrieve: recover the original by hash, optionally filtered by a query.headroom_stats: inspect compression and retrieval savings.
DecisionsAI policy
- Keep automatic provider traffic proxying disabled. DecisionsAI callback blocks, work packets, acceptance criteria, and user instructions must never be compressed implicitly.
- Keep the standalone MCP registered and enabled. Its on-demand compression and retrieval use the MCP process's local store, with proxy access only as an optional fallback.
- Compress large logs, generated JSON, search results, or repeated tool output on demand. Do not compress short instructions or small source files.
- Preserve the returned hash in the active task or result packet when a later workflow step may need the original.
- Retrieve the original before quoting exact wording, line numbers, API values, or security-sensitive evidence.
- Treat compression as a context optimization, not verification. Tests and direct file inspection remain authoritative.
Recovery
- If the Headroom MCP is unavailable, continue with normal local file reads and targeted searches. Do not block the task.
- If an original has expired from Headroom's local store, read the source file or rerun the producing command instead of guessing.