Skip to content

fix(kanban): forbid clarify in worker guidance — use kanban_block instead#32183

Open
JezzaHehn wants to merge 1 commit into
NousResearch:mainfrom
JezzaHehn:kanban-no-clarify
Open

fix(kanban): forbid clarify in worker guidance — use kanban_block instead#32183
JezzaHehn wants to merge 1 commit into
NousResearch:mainfrom
JezzaHehn:kanban-no-clarify

Conversation

@JezzaHehn

Copy link
Copy Markdown
Contributor

Summary

Closes #32167.

Kanban workers run headless with no live user on the other end. When a worker calls clarify(), the call always times out (~120s), the task hangs in running with no visible indicator, and no notification reaches the operator.

Changes

Two-line fix across two files:

  1. agent/prompt_builder.py — Added a "Do not call clarify" bullet to the ## Do NOT section of KANBAN_GUIDANCE. Every kanban worker sees this in their system prompt.

  2. skills/devops/kanban-worker/SKILL.md — Added the same rule to the skill-level ## Do NOT section for deeper reference.

Both entries tell workers to use kanban_comment + kanban_block instead, which is the existing documented pattern for requesting human input.

Testing

  • All 3 existing kanban guidance tests pass:
    • test_kanban_guidance_prompt_size_bounded — guidance is 3,969 chars, under the 4,096 cap
    • test_kanban_guidance_in_worker_prompt — guidance injected for kanban workers
    • test_kanban_guidance_not_in_normal_prompt — guidance not injected for normal sessions
  • Verified "clarify" appears in the updated KANBAN_GUIDANCE text

Why this approach

The issue reporter suggested exactly these two locations. The kanban_comment + kanban_block pattern is already documented and tested — workers just need an explicit rule to never reach for clarify.

…tead

Workers run headless with no live user. Calling clarify() always times
out and leaves the task stranded in 'running'. Add explicit 'Do NOT call
clarify' bullets to both KANBAN_GUIDANCE (prompt_builder.py) and the
kanban-worker skill.

Closes NousResearch#32167
@alt-glitch alt-glitch added type/bug Something isn't working P2 Medium — degraded but workaround exists comp/agent Core agent loop, run_agent.py, prompt builder tool/skills Skills system (list, view, manage) labels May 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/agent Core agent loop, run_agent.py, prompt builder P2 Medium — degraded but workaround exists tool/skills Skills system (list, view, manage) type/bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: Kanban workers should never use clarify — use kanban_block instead (task hangs in running)

2 participants