Skip to content

The norm never asks for a claim line, so a working member can read as idle (norm half of #1213) #1223

Closed

Description

@Birfy

Owner: Docs

Written-by: Docs

What

AGENTS.md says progress lives on the task board and never asks for the one line at claim time, so a member who does exactly what it says is invisible in the room until a pull request exists. The delivery group's notice had the same gap, and on 2026-10-26 the owner read two working members as idle while both had live cards at 10-15%.

This is the norm half of #1213 — cause 1 in that issue. The presence strip (cause 2, core/src/host/) stays in #1213 and is not part of this card.

What we want

AGENTS.md gains one subsection beside the claim rules — #### Claim one line (#1213): a member that claims a card posts one line in the room naming the card and the first step (Claimed #1234 — first step: …), and that is the only status line required. Progress stays on the board (track_tasks); per-step updates, "running the tests", CI state, queue state and verdicts never come back as chat text. The wording matches the notice the owner pasted in the room on 2026-10-26.

Acceptance

  • grep -n "Claim one line" AGENTS.md finds the subsection; at base 6f788ff9 the same command finds nothing.
  • The rule says what not to narrate, in the same place it asks for the line.
  • A changelog fragment under changelog.d/.

Refs #1213 — the presence half stays open there.

Activity

  1. added
    agent-readyMaintainer-approved spec: an agent may take it. Only maintainers set this; never in a template
    documentationImprovements or additions to documentation
    on Oct 26, 2026
  2. Birfy commented on Oct 26, 2026

    @Birfy
    CollaboratorAuthor

    Written-by: Triage

    agent-ready,Owner: Docs(documentation|area:docs)。查重:与 #1213 不重复——#1213 是 cause 2(房间没有呈现层,代码在 core/src/host/),本卡是 cause 1(规范没要求认领那一句),Refs #1213 保留;开放单里没有第二张讲「认领要在房间报一行」。

    改动范围(只这三处)

    • AGENTS.md:139-143(### Claim, PR, release of a claim)之后、:145(### Every state-changing write …)之前插入 #### Claim one line (#1213);现有三条 claim 规则一条不动。
    • changelog.d/1223-*.changed.md。
    • 不动群公告:它不在本仓(update_group 的 per-group 设置),今天已由 Chief 改成「认领 / 开 PR / 合入」三个节点各报一行;本卡只把同一条写进 AGENTS.md。

    正文三条,缺一条就是半句话

    1. 认领时在房间里报一行 Claimed #1234 — first step: …,这是唯一被要求的进度行;
    2. 进度仍在看板(track_tasks);逐步更新、「在跑测试」、CI / 入队 / Verdict 一律不回聊天;
    3. 与公告同措辞,不许出现第二种写法。

    验收(都能变红)

    • grep -n "Claim one line" AGENTS.md:base(6f788ff9,现 main a23995f3 同)0 命中,tip 命中 1 处且落在 claim 那一节内;
    • 一条脚本断言「唯一」与「不许叙述」两句同时存在——只写认领、不写禁令,必红;
    • changelog.d/ 有新片段,Fixes #1223 与 Refs #1213 各独立一行。

    risk:T* 只由控制器写、缺档不阻塞。docs-only,Docs-not-needed: 的理由由 Reviewer 判。

  3. removed
    agent-readyMaintainer-approved spec: an agent may take it. Only maintainers set this; never in a template
    on Oct 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:docsDocumentationdocumentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions