multi-agent-mux/.agents/reports/planner-reviewer-claude-01/plan-b8872c34.md

🗺️ Final Implementation Plan — Grok Build TUI Agent (grok) Integration

• Planner: planner-reviewer-claude-01
• Creator: creator-agy-01
• Job ID: a0689b27
• Version: Rev.2 (Consensus)

---

1. Overview & Architecture

Integrate Grok Build TUI (grok 1.0.5) as a 1st-class citizen across MAM using the 5-layer adapter architecture.

---

2. Exhaustive Enumeration Sites (~34 Sites)

2.1 Core Adapter Framework

1. .agents/skills/lib_py/agents/adapters/grok.py: Implement GrokAgentAdapter(BaseAgentAdapter).
2. .agents/skills/lib_py/agents/registry.py: Import and add grok to _ADAPTERS.
3. .agents/skills/lib_py/agents/sanitize.py: Ensure grok session naming passes regex.

2.2 Shell Runtime & Lifecycle

4. lib.sh:357-371: Herdr kind mapping (*-creator-grok|*-planner-grok|*-reviewer-grok).
5. lib.sh:385: Binary name recognition tuple (" claude agy hermes cline grok ").
6. lib.sh:1760-1790: send_keys_safe input prompt delimiters (❯, ───).
7. create_session.sh: CLI options and validation for --agent grok.
8. resume_session.sh: Resume CLI spec dispatch and fallback.
9. stop_session.sh: Graceful shutdown signal (/exit) and YAML state capture (grok_session_id_own).
10. reconcile.sh: Monitor reconciler session discovery for grok.
11. status.sh: Status table formatting for grok agent rows.
12. orc_onboard.sh: Orchestrator UUID registration.

2.3 Skills Documentation & Prompt Updates

13-20. Update SKILL.md files across all 8 skills to include grok in supported agents:

• multi-agent-mux-create/SKILL.md
• multi-agent-mux-resume/SKILL.md
• multi-agent-mux-stop/SKILL.md
• multi-agent-mux-status/SKILL.md
• multi-agent-mux-monitor/SKILL.md
• multi-agent-mux-delegate-job/SKILL.md
• multi-agent-mux-loop/SKILL.md
• multi-agent-mux-orc-onboard/SKILL.md

2.4 Test Suites

21. tests/test_a4_adapter_contract.py: Registry, property contract, facts bridge eval.
22. tests/test_tier1_unit.py: Unit tests for grok adapter lifecycle.

---

3. User Decisions & Action Items

• Grok Installation: Confirmed present at /Users/godopu16/.local/bin/grok (v1.0.5).
• Authentication: ~/.grok/auth.json is already configured.
• Permission Mode: Default to --permission-mode bypassPermissions for autonomous sub-agent execution (configurable via env if desired).

---

4. Definition of Done

• GrokAgentAdapter passes all contract tests.
• pytest tests/ passes with 0 regressions.
• Grok can be created, stopped, and resumed via MAM CLI.