Harmonist offers a unique approach to AI agent orchestration by enforcing project protocols mechanically, rather than relying on LLM adherence to prompts. It targets developers and teams who require strict, auditable compliance from AI coding assistants, providing a robust framework to prevent AI-driven code changes from bypassing essential development steps like reviews or QA. The primary benefit is guaranteed adherence to project rules, mitigating risks associated with AI-generated code.

How It Works

Harmonist implements protocol enforcement through IDE-level hooks, acting as mechanical gates that intercept and validate AI agent actions. These hooks, written in bash or Python, monitor subagent dispatches, file edits, and session completions. If required checks (e.g., QA verification, reviewer presence, memory updates) fail, the AI's turn is blocked, preventing incomplete or non-compliant code from being committed. This approach ensures that project rules are enforced as a state machine on disk, independent of the LLM's instructions.

Quick Start & Requirements

Integration is primarily achieved by pasting the integration-prompt.md file into a Cursor Agent-mode session, allowing the AI to self-configure the project. Alternatively, a CLI integration script is available. Requirements include Python 3.9+, bash (for POSIX systems), Git, and a supported AI coding assistant (Cursor, Claude Code, Copilot, etc.). A key advantage is its lack of third-party Python dependencies, utilizing only the standard library.

Highlighted Details

• Mechanical Protocol Enforcement: Utilizes IDE hooks to mechanically gate AI actions, preventing protocol skips.
• Supply-Chain Verification: Every shipped file is hashed in MANIFEST.sha256, and upgrade scripts verify sources before integration, preventing tampered agent definitions.
• 186 Curated Domain Specialists: A comprehensive catalogue of specialized agents across various domains (engineering, design, marketing, finance, etc.), enabling precise role selection.
• Schema-Validated Memory: Memory entries are validated against a schema, deduplicated, and scanned for approximately 30 classes of secrets, with correlation IDs cryptographically ordered by hooks.

Maintenance & Community

Harmonist is built and maintained by GammaLab. Community interaction and support primarily revolve around the GitHub repository.

Licensing & Compatibility

Harmonist is released under the MIT License, making it free for commercial use, modification, and distribution without significant restrictions.

Limitations & Caveats

While Harmonist supports multiple AI coding assistants via adapters, its most robust enforcement layer is with Cursor due to its native hook support. Integrations with other tools fall back to a "convention-plus-validation" model, which may offer less stringent enforcement compared to the Cursor integration.