--- name: solix-agents description: "Audit and unify agent instruction files (AGENTS.md, CLAUDE.md, GEMINI.md, Windsurf rules, …) so every agent CLI on this machine reads the same rules. Use when asked to unify agent memory/instructions, check instruction drift, or when agents are behaving differently because they read different rule files." argument-hint: "[audit | unify | unify for ]" --- # Solix Agents — instruction unify Every agent CLI reads its own instruction file. Solix inventories them all (user-global plus every project directory that has them) and repoints drift at one canonical `AGENTS.md` per scope. ```text solix agents audit inventory + drift report solix agents unify [--scope dir|user] fix plan — dry run, writes nothing solix agents unify --apply [--scope …] write it (originals backed up first) ``` Audit markers: `✓` canonical · `●` sole file · `~` divergent · `→` pointer to canonical · `·` empty · `–` missing · `≠` exempt. ## Flow 1. `solix agents audit`. No `~` rows → say "unified" and stop. 2. For each divergent file, read it next to the canonical one and list what it holds that the canonical lacks. Unify replaces it with a pointer — anything unique in it is lost from that agent's view unless merged first. 3. Merge the unique, still-true rules into the canonical `AGENTS.md` yourself. Drop duplicates and stale rules; say which you dropped. 4. `solix agents unify` — show the user the plan (backup / write / point / link lines) plus your merge summary. Ask before applying. 5. On yes: `solix agents unify --apply`, then `solix agents audit` again and confirm zero divergent. Never hand-edit pointer files or delete backups — `unify` owns both. Scope the run with `--scope ` when the user named one project.