governor

Governor is an advanced tool designed to optimize the usage of Claude Code by ensuring concise, clean, and manageable outputs. This project focuses on enhancing the efficiency of complex coding tasks through features such as context hygiene, tool-output filtering, professional output management, telemetry, and drift guardrails. Ideal for heavy users, Governor minimizes resource waste by addressing common problems faced during lengthy interactions, such as:

• Excessive context from files like CLAUDE.md, notes, and rules.
• Large Bash/test/build outputs that clutter conversation context.
• Broad prompts resulting in inefficient code scans and repeated failures.
• Scope drift during prolonged coding tasks.
• Preventable context growth leading to compaction issues.

Key Features

• Always-on compact mode: Automatically maintains concise responses in all conversations by utilizing hooks during session starts and user prompt submissions.
• Professional memory compression: Transforms verbose memory files into succinct summaries using the command /governor:compress CLAUDE.md while protecting critical content.
• Tool-output filtering: Efficiently summarizes noisy Bash/test/build outputs while retaining essential failure signals.
• Telemetry management: Provides insights into token usage, failures, and memory compressions through the /governor:status command.
• Planning and drift guard: Establishes contracts for major tasks, ensuring adherence to expected scopes with commands like /governor:plan and /governor:guard.

Efficiency Benchmarks

Governor's architecture has been tested and proven to enhance performance dramatically:

• Output Tokens Savings: Compared to control versions, Governor achieved a 55.5% reduction in output tokens during different scenarios.
• Memory Compression: Efficiency in compressing memory files results in an impressive average savings of approximately 55.4% compared to original files.
• Filtered Tool Outputs: By summarizing initial noisy outputs, Governor successfully eliminates up to 96.8% of unnecessary tokens.

Commands Overview

Governor provides a simple command structure for easy access:

Command	Purpose
/governor:on	Enable compact professional response mode
/governor:off	Disable response compression
/governor:status	Display usage dashboard and waste heat map
/governor:audit	Identify bloated memory/rule files and context waste
/governor:compress CLAUDE.md	Compress memory files while ensuring content integrity
/governor:plan "task"	Generate an implementation contract prior to major coding tasks

By leveraging Governor, users can effectively optimize their interaction with Claude Code, leading to more controlled and productive coding experiences.