enBoxer/AGENT.md
en 4daf0ea86a Initial enBoxer: mapped-key routing and Video FX on Hyprland.
Phase 1 tickets T1–T6, ponytail dead-code cuts, docs and plan in-tree.
2026-09-15 07:19:15 +02:00

2.1 KiB
Raw Blame History

AGENT.md — enBoxer

Contract for this repo. The plan lives in PLAN.md. Tickets live in TASKS.md. Do not mix roles.

Roles

Role Who Job
Designer + project manager + reviewer Grok Own the product. Write PLAN.md and every ticket for a phase before the worker runs that phase. After the worker finishes the phase, check the diff against the tickets. If wrong, file a smaller ticket and send it back. Do not implement worker tickets.
Worker OpenCode Implement one open ticket at a time. Must load ponytail (opencode.json). Must not use --pure. Must not run ponytail-review.

Sequence (do not skip)

  1. Grok finishes giving tasks (all tickets for the phase are on the Open list in TASKS.md).
  2. OpenCode works those tickets.
  3. Grok does not run ponytail-review until step 1 is done and the worker has closed those tickets (or blocked).
  4. Grok reviews against tickets (ordinary accept / bounce).
  5. Only when Grok accepts the phase does Grok run ponytail-review.
  6. Then Grok pushes the git remote.

While OpenCode is running, Grok does not edit the same source files.

OpenCode

  1. Directory: ~/git/enBoxer
  2. Plugin: @dietrichgebert/ponytail via this repos opencode.json
  3. No --pure
  4. Read PLAN.md + TASKS.md; first Open ticket only (or the tickets named in the run prompt, in order)
  5. Leave ponytail on
  6. cargo test green before stop
  7. No extra features
opencode run --dir /home/en/git/enBoxer --auto --title "enBoxer tickets" \
  "Read AGENT.md, PLAN.md, TASKS.md. Ponytail plugin required. Do open tickets in order. Do not run ponytail-review."

Product

Mapped keys to several WoW windows on Hyprland. Unmapped keys stay on the primary. passthrough is optional (example ESDF). No injection. Macros, not addons. Video FX is a crop with hover pass-through.

Review (Grok, after the worker, still not ponytail)

  • Diff matches the tickets
  • cargo test green
  • Example passthrough still ESDF; empty list still means no skip
  • No game injection
  • No new deps without a ticket