How gammalabtechnologies/harmonist works
Harmonist is a portable AI-agent pack for coding assistants, combining a curated specialist catalogue and project integration tools with IDE-hook protocol enforcement and validated memory. The main workflow is: a user integrates the pack into a project, selects/configures agents, then an assistant works under hooks that gate completion and record task memory. The graph also includes conversion, upgrades, and related pack operations. Edges reflect README statements or shown source references; unsampled subsystem internals are not expanded.
Main entry points: integrate.py Integration Runner · hook_runner.py Hook Runtime · agents Agent Definitions · memory.py Memory CLI
Components 25
Project Integration
- Integration Prompt
integration-prompt.md - Integration Runner
agents/scripts/integrate.py - Project Rules Merge
agents/scripts/merge_agents_md.py - Pack Upgrade
agents/scripts/upgrade.py - Integration Audit
agents/scripts/verify_integration.py - Specialist Installer
agents/scripts/install_extras.py
Agent Catalogue
- Specialist Catalogue
agents/index.json - Agent Definitions
agents - Agent Converter
agents/scripts/convert.py - Essentials Extractor
agents/scripts/extract_essentials.py
Protocol Enforcement
- IDE Hook Configuration
hooks/hooks.json - Hook Runtime
hooks/scripts/hook_runner.py - Strict Agent Registry
agents/scripts/strict_slugs.py
Validated Memory
- Memory CLI
memory/memory.py - Memory Validator
memory/validate.py - Project Memory
memory - Memory Migrations
memory/migrations.py
Pack Operations
- Agent Schema Migrator
agents/scripts/migrate_schema.py - Pack Health Check
agents/scripts/check_pack_health.py - Rules Conflict Scanner
agents/scripts/scan_rules_conflicts.py - Regression Command Detector
agents/scripts/detect_regression_commands.py - Project Onboarding
agents/scripts/onboard.py - Workflow Playbooks
playbooks
Other components
- Developer
- Coding Assistant
Connections 26
- Developer → Integration Prompt: starts integration
README.md - Integration Prompt → Integration Runner: automates steps
- Integration Runner → Project Rules Merge: merges rules
agents/scripts/integrate.py - Integration Runner → Pack Upgrade: runs upgrade
agents/scripts/integrate.py - Integration Runner → Integration Audit: audits integration
agents/scripts/integrate.py - Developer → Specialist Installer: adds specialists
agents/scripts/install_extras.py - Specialist Catalogue → Specialist Installer: selects entries
agents/scripts/install_extras.py - Specialist Catalogue → Agent Definitions: indexes agents
- Agent Definitions → Coding Assistant: guides work
README.md - Agent Definitions → Agent Converter: converts formats
agents/scripts/convert.py - Agent Converter → Essentials Extractor: extracts essentials
agents/scripts/convert.py - IDE Hook Configuration → Hook Runtime: dispatches events
README.md - Coding Assistant → Hook Runtime: triggers hooks
README.md - Hook Runtime → Project Memory: checks memory state
README.md - Hook Runtime → Strict Agent Registry: checks reviewers
- Coding Assistant → Memory CLI: records entries
README.md - Memory CLI → Project Memory: appends entries
memory/memory.py - Memory CLI → Memory Validator: validates entries
README.md - Memory Migrations → Memory Validator: uses schema
memory/migrations.py - Agent Schema Migrator → Agent Converter: supports conversion
agents/scripts/convert.py - Pack Health Check → Strict Agent Registry: checks registry
agents/scripts/check_pack_health.py - Project Onboarding → Strict Agent Registry: uses registry
agents/scripts/onboard.py - Developer → Workflow Playbooks: uses workflows
README.md - Integration Runner → Pack Health Check: checks pack
agents/scripts/integrate.py - Integration Runner → Regression Command Detector: detects commands
- Integration Audit → Rules Conflict Scanner: checks conflicts
agents/scripts/verify_integration.py