Browse Source

docs: address PR #706 review — fix multiplexer + ready-for-human wording

Michael Henke 3 weeks ago
parent
commit
218cd9d040
2 changed files with 6 additions and 4 deletions
  1. 1 1
      CONTEXT.md
  2. 5 3
      docs/agents/triage-labels.md

+ 1 - 1
CONTEXT.md

@@ -31,7 +31,7 @@ A glossary of the terms used in this project's domain. Definitions describe what
 
 ## Multiplexer & Sessions
 
-- **Multiplexer** — A terminal backend (tmux, zellij, or herdr) that hosts child agent panes.
+- **Multiplexer** — A terminal backend (tmux, zellij, or herdr) that hosts child agent panes. Set via \`multiplexer.type\`, which also accepts \`auto\` (auto-detect) and \`none\` (disabled).
 - **Multiplexer type** — The selected backend: `auto`, `tmux`, `zellij`, `herdr`, or `none`.
 - **Pane** — A terminal region spawned by the multiplexer to run a child agent session.
 - **Child session** — A background agent session hosted in a multiplexer pane and tracked by the session manager.

+ 5 - 3
docs/agents/triage-labels.md

@@ -19,9 +19,11 @@ translation layer ("roles are skill behavior; strings are repo policy").
 
 - `needs-triage` has **no label** by design: an unlabeled issue is implicitly in
   the `needs-triage` state.
-- `ready-for-agent` and `ready-for-human` both map to `good-to-code`. If you want
-  to distinguish "ready for a human to merge" from "ready for an agent to pick
-  up", apply `status:in-review` alongside `good-to-code` for the human case.
+- `ready-for-agent` and `ready-for-human` both map to `good-to-code`. The
+  difference is who implements: an agent picks up `ready-for-agent`; a human
+  implements `ready-for-human`. `status:in-review` is a separate human-review
+  state (for when code already exists and awaits review) — do not apply it to
+  issues that still need implementation.
 - The following repo labels are intentionally **outside** the triage taxonomy
   and should not be applied by `/triage`:
   - `confirmed` — maintainer-acknowledged signal after `needs-triage`