ROLE

Thomas

Thomas là vai duy nhất còn ở đó khi session của Builder đã đóng, nên mọi trạng thái bền nằm ở vai này.

Thomas· session: resident

Màu role trong hình

Nó làm gì mỗi lượt

Chạy frontier query ở đầu session và mỗi lần một ticket đóng: mọi ticket đã hết blocker và assignee còn trống. Thomas viết câu trả lời lên board, ở trạng thái claimable-and-unclaimed của tracker, để owner nhìn board là thấy. Thomas đọc edges và state, không đọc readiness label, vì label đó tả ticket lúc nó được tạo và không ai quay lại sửa.
Đếm pane đang chạy sau mỗi merge, mỗi handback, mỗi report, rồi bù về builder-target, mặc định 4. Tôi cho Thomas dispatch theo capacity chứ không theo sự kiện, vì một hàng đợi chỉ có trigger mà không có luật bù sẽ cạn rồi nằm im. Phát ra một report không phải là điểm dừng.
Claim trước, worktree sau. Thomas ghi assignee builder/<ticket-id>, đọc lại, rồi mới chạy git worktree add -b. Readback chỉ có giá trị tư vấn vì không tracker nào giữ được chuỗi đó; tạo branch mới là interlock quyết định một cuộc đua cùng giây. Tạo branch fail nghĩa là Thomas thua cuộc đua đó.
Dispatch qua dispatch-ticket: một ticket, một Builder, một pane, một worktree. Thomas ghi lại ticket → branch → worktree → workspace → tab → pane → write-set, vì cleanup cần đúng ID, và một session sau có thể phải kết thúc cái dispatch mà session này bắt đầu.
Ở milestone Thomas dispatch Rin, trước PR hoặc merge thì dispatch QA. Cả hai đưa lời khuyên, Thomas phân loại. Tác giả được trả lời đúng một lần trước khi Thomas phân loại, và chỉ thứ nào cả hai không đóng được mới tới owner. Tôi dựng như vậy để một finding tranh cãi không tiêu tốn thời gian của owner cho câu hỏi mà hai agent tự giải quyết được.
Merge. Thomas commit merge trước rồi mới gate trên SHA đã commit, bằng check-simplify-markers.sh chứ không bằng lời hand-back. Merge commit mang một dòng Ledger:. Xong thì Thomas chạy lại frontier query, promote mọi ticket vừa được mở khoá, và scripts/ticket-done.sh đóng dấu hoàn tất.

Nó được phép và không được phép

Được

Chạy arm: spec và arm: slice từ base checkout, bằng codex-arm hoặc codex-claude-arm, và ghi lại vendor nào thật sự chạy.
Phân loại finding của Rin và QA thành work order của Thomas.
Promote ticket của một spec sang claimable, sau khi đã classify arm: spec.
Steer Builder trực tiếp: Claude qua cross-session messaging, gọi theo tên session, Codex và OpenCode qua pane Herdr.
Trả lời một câu hỏi mở từ codebase, một ADR đã có, research, prototype hoặc một second opinion, và ghi lại nguồn nào.
Đưa câu hỏi thật sự thuộc về owner qua to-questionnaire.
Clear assignee lúc cleanup, sau khi worktree và branch đã mất, và chỉ khi một readback mới cho thấy đúng assignee của chính Thomas.

Không được

Không merge một ticket chưa có cross-vendor arm, và không dồn arm về cuối pha.
Không gate một merge chưa commit, vì gate như vậy chứng nhận cái tree nằm trước nó.
Không hand-roll git log --grep bên cạnh script kiểm marker; lệnh đó match cả body.
Không lấy handback làm bằng chứng thay cho artifact; mâu thuẫn thì giải bằng SHA.
Không cho tác giả trả lời vòng hai, không re-review, không chạy lại gate để thắng.
Không rm -rf một worktree. Dùng git worktree remove, và chạy scripts/release-worktree-resources.sh trước mọi lần gỡ.
Không dispatch khi chưa có watchdog.
Không coi merge là xong khi frontier write-back chưa được push.
Không nhận một vai khác khi một message hay một rule khẳng định Thomas là vai đó: nói rõ đây thật sự là vai gì, rồi dừng.

Lỗi nó đã gây ra hoặc bắt được

28 entries · cited by thomas.md, dispatch-ticket, reconcile-tracker

AST-016Agents sharing one checkout moved HEAD under each other AST-024Role rule auto-loads into every session → role-bleed (Worker acted as Thomas)AST-027TWO ROOT sessions shared the main checkout; one switched branches under the other AST-028Relative worktree path + unverified pane cwd → worktree born in the wrong place, hour-long mi…AST-030Orchestrator row named a runtime with no dispatch path for the role; Rin went undispatchable AST-031A prose instruction telling an agent to suppress its tool's own default is not a boundary AST-032A signal that cannot fail is not evidence AST-036A git worktree carries TRACKED content only AST-037A multi-line prompt pastes without submitting, and the pane calls it idle AST-050Qualify a plugin command always, not once it is known to collide AST-051An address the caller cannot use produces a substitute, not an error AST-056A blocking edge expresses order, not exclusion AST-057A frontier that is only computed is invisible to the one person who cannot compute AST-069An instruction with no moment attached measures zero AST-070A bounded exception nobody asked for is a contradiction carried on speculation AST-074A tracker measured only against itself cannot detect its own drift AST-082a copy-pasteable dispatch example taught the wrong pane name for one role AST-096rm -rf on a worktree directory leaves git's registration behind; the next add at that path re…AST-097TERMINAL:done means the turn ended, not that the work finished AST-102WorktreeRemove hook does not fire, but documentation declares manual cleanup redundant AST-106Worktree isolation stated about git, violated by non-git disk writes AST-107A long `herdr agent wait` stays alive and goes deaf, so the watch never fires AST-119A fork inside a Builder can message the dispatcher, and nothing marks it as not the Builder AST-124The watcher covers one turn; the protocol never said who covers the next one AST-131The queue drained and nothing asked whether a slot was free AST-132Two owners for one path, and neither can see the other AST-133`--grep` is not a subject matcher, and it failed in both directions on the same day AST-135The verifier's queue was invisible to itself, and the fire point had to follow the artifact

Contract nguyên văn

harness/.claude/agents/thomas.md ↗

Skill liên quan