Skip to content
This repository was archived by the owner on Apr 21, 2026. It is now read-only.

docs: clarify who sets breeze:human (responder-elevated pattern)#13

Open
serenakeyitan wants to merge 1 commit intoagent-team-foundation:mainfrom
serenakeyitan:docs/responder-elevates-human
Open

docs: clarify who sets breeze:human (responder-elevated pattern)#13
serenakeyitan wants to merge 1 commit intoagent-team-foundation:mainfrom
serenakeyitan:docs/responder-elevates-human

Conversation

@serenakeyitan
Copy link
Copy Markdown
Contributor

Summary

DESIGN.md already specifies the four states (new / wip / human / done) but doesn't say who transitions wip → human. This PR adds that rule.

The rule

breeze:human is labeled by the agent attempting the work, not by reviewers.

Signal comes from reviewer behavior (repeated CHANGES_REQUESTED, unclear feedback). Action is taken by the agent that tracks attempts across rounds.

Why

While wiring this labeling system into repo-gardener (gardener-respond fixes sync PRs after reviewer feedback), I hit the question: after N unsuccessful rounds, who labels breeze:human?

  • Not the reviewer — reviewers only see current PR state, not how many rounds this is
  • The agent — it tracks attempts and decides "I give up, needs human"

Without this clarification, different agents (breeze-runner, gardener-respond, future agents) may implement different thresholds or each expect the other to do it → PRs never escalate.

Test plan

  • DESIGN.md renders — new section added after "Four States" table, before "Statusline only shows new count"
  • No breaking change — existing text untouched, only added a subsection

Closes #12


🤖 Generated with Claude Code

DESIGN.md already specifies the four states (new / wip / human / done)
but doesn't say who transitions wip → human. This matters because
reviewers and agents may both think it's the other's job, leading to
PRs that never escalate.

Adds a subsection after the Four States table:

- Signal comes from reviewer behavior (repeated CHANGES_REQUESTED etc.)
- Action is taken by the agent that tracks attempts across rounds
- Suggested threshold: 5 rounds

Keeps breeze-runner and gardener-respond consistent.

Closes agent-team-foundation#12

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clarify: who sets breeze:human and when (responder-elevated pattern)

1 participant