diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 42352f1863..ddda65f61e 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -11,6 +11,7 @@ Thank you for helping improve Hive. This guide is for contributing code and docu - Not sure why the hive has not picked up your issue? It automatically works issues only from OWNER, MEMBER, and COLLABORATOR authors; anyone else waits for a maintainer to add `triage/accepted`. See [Reporter trust and escalation](GOVERNANCE.md#reporter-trust-and-escalation) for what those roles mean, [how to become a trusted reporter](GOVERNANCE.md#how-to-become-a-trusted-reporter), and how to escalate. - Pull requests are welcome too, and nothing above changes how they are reviewed. - Discuss design and review questions in public issues and pull requests so decisions remain public and searchable. +- A proposal or design question goes in an issue labelled `proposal` (or `kind/design`). Until someone claims it, the hive shows it as **Open for discussion** (`stage/018-open-for-discussion`), not as agent work waiting to be picked up; `/claim` it when you want to take it on, and it moves through the pipeline like any other issue. See [stage labels](src/docs/labels-and-control-signals/stage-labels.md). - Follow the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md), adopted in [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md), and [Hive governance](GOVERNANCE.md). - Report vulnerabilities privately; see [SECURITY.md](SECURITY.md). - Extending Hive? Start with the [Integration guide](src/docs/integration-guide.md) for the current work source, ClankeR/Flue-style external execution, and Spektacular Project Inception seams. diff --git a/changelog.d/fixed-17150-open-for-discussion.md b/changelog.d/fixed-17150-open-for-discussion.md new file mode 100644 index 0000000000..15d70f36ab --- /dev/null +++ b/changelog.d/fixed-17150-open-for-discussion.md @@ -0,0 +1 @@ +- An open issue labelled `proposal` or `kind/design` that nobody has claimed now derives the new `stage/018-open-for-discussion` and reads **Open for discussion** in the activity monitor instead of sitting at `stage/010-actionable` as agent work no lane will usefully pick up — including a proposal whose `Refs` RFC PR merged and left it `hive/partially-addressed`, a `040 → 018` fall booked as progress, not a regression. The stage reason names the label (`open for discussion: proposal`). The issue stays claimable: the claim gate is unchanged, a `/claim`, relay or agent claim stages it 020 / 030 as before, and removing the label returns it to 010 ([#17150](https://github.com/hivecommons/hive/issues/17150)). diff --git a/src/docs/adr/0025-central-stage-engine.md b/src/docs/adr/0025-central-stage-engine.md index 4e55ca7623..6735591478 100644 --- a/src/docs/adr/0025-central-stage-engine.md +++ b/src/docs/adr/0025-central-stage-engine.md @@ -425,6 +425,15 @@ enumerator's filtered-reason) the way it reproduces 045 from `needs-spec`, and the resume sweep removes it on `/hive decision proceed` / `exists`. Leaving 017 for 010 or closed is never a regression. +**Open for discussion (`stage/018-open-for-discussion`, #17150).** Added +after the epic: an issue-only stage between 017 and 020 with no dwell. +Unlike 017 it is derived, not written by a gate: `DeriveIssue` returns it +for an open issue labelled `proposal` or `kind/design` with no live claim +(`IssueFacts.DiscussionLabel`, resolved in `pkg/github`), reason +`open for discussion: