Harmonist v1.2.0
Maintenance release: install-UX overhaul plus reliability hardening across
hooks, memory, and the catalog. Headline fix — dropping the pack into a
workspace no longer risks Cursor treating the orchestrator template as a
live rule and demanding enforcement machinery that isn't installed yet.
Install UX
AGENTS.md(pack root) renamed toAGENTS.template.mdwith an
unmissable preamble: it is a TEMPLATE, not an active rule for the pack
folder; AI agents asked to "install" must followintegration-prompt.md
instead. The file generated in the USER's project keeps the name
AGENTS.md. All pack-owned marker blocks preserved verbatim.<PACK_DIR>convention. The pack folder may have any name; docs and
the integration prompt now detect the actual folder name and use
<PACK_DIR>/placeholders (examples assumeharmonist/). Literal
harmonist/paths inside pack-owned blocks are substituted by the merge
tooling at integration/upgrade time.- AI entry points.
README.mdopens with a self-routing block for AI
agents;integration-prompt.mdopens with "you are the installer —
execute the steps below". - Integration prompt corrections: strict-install wording fixed (6
strict agents copied incl.wcag-a11y-gate, plusbg-regression-runner
seeded in Step 7 → 7 strict files post-install); removed the redundant
hand-edit instruction forbg-regression-runnercommands (raced the
auto-seeding);.cursor/memory/file list now includesmigrations.py;
added a warning to delete the pack's CI configs when the pack was copied
into a project root; added thepentestcontrolled domain. GUIDE_EN.mdmanual path fixed — the old 4-step manual install
produced an unenforced setup (no hooks, rules, or.gitignore
hardening); it now routes throughintegrate.py+verify_integration.py.
Hooks reliability
- State-file locking around read-modify-write cycles, stop-gate
handoff fallback hardening, and further HITL dangerous-command
pattern hardening across both hook runtimes.
Memory robustness
- Pinned UTF-8 on all reads/writes, cross-platform locking, and
collision-safe rotation ids.
Catalog
wcag-a11y-gateis now installed byupgrade.pyas a pack-owned
strict reviewer (post-install strict files:repo-scout+ 5 reviewers +
seededbg-regression-runner= 7).- Strict-slug unification, the orchestrator entry marked strict, and a new
controlled domainpentestfor the authorized offensive-security
personas.
Docs & playbooks
- NEXUS tree marked as legacy: standardized banners on
QUICKSTART.md,
nexus-strategy.md, all 7 phase playbooks, all 4 scenario runbooks, and
both coordination docs — display names are not slugs; dispatch follows
AGENT: <slug>markers and the projectAGENTS.md+agents/index.json. - Phantom agents replaced with real catalog slugs: Senior Developer →
engineering-laravel-livewire-specialist, Senior Project Manager →
project-management-laravel-pm, Finance Tracker →finance-fpa-analyst,
Data Consolidation Agent →sales-pipeline-analyst. playbooks/EXECUTIVE-BRIEF.md: file tree re-rooted atplaybooks/
(wasstrategy/), "9 Divisions" branding corrected to the actual 16
categories, invented-looking statistics toned down to qualitative claims.MANIFEST.sha256coverage claim corrected: all runtime-shipped content
(agents/,hooks/,memory/,playbooks/, root docs) is hashed; CI
configs and repo metadata are pack-repo-only and excluded. CI configs
now carry explicit "pack-repo CI — delete in host projects" headers.onboard.py(teammate walkthrough) documented in the README key-scripts
table.