agents: claim tickets by assigning them to the session's own identity #9

Merged

pit merged 1 commit from hermes/claim-by-assignment into main

2026-10-09 11:23:12 +00:00

pit commented

2026-10-09 11:12:30 +00:00

Owner

Summary

Restore a **Claim** bullet to the tracker doc's Wayfinding operations, so how a session claims a ticket is written down.

 docs/agents/issue-tracker.md
   - **Frontier query**: ... non-`done` task. Do **not** pull the whole project ...
+  - **Claim**: `task_assignees_create` naming the session's **own** Vikunja user
+    (its identity) as its first write, before any work. Identities differ per
+    agent and per deployment; a session reads its own, never one hard-coded
+    here. If the session has **no** identity configured, assign to Pedro (`pit`)
+    as the default. The assignee **is** the claim: an unassigned ticket is
+    unclaimed, and a concurrent session skips a ticket that is already assigned.
   - **Resolve**: `task_comments_create` with the answer, `tasks_update` ...

Why now: PR #8 said claim by comment, never by assignment, but its own trim (commit 9e773d6) deleted both claim bullets, leaving the doc silent while the vendored wayfinder skill still says a session claims by assigning. The repo tracker doc is the override and had no rule. This puts one back: assign, to the session's own identity, falling back to Pedro.

No agent identities are named: they differ per agent and per deployment, so naming them would go stale. A session reads its own identity from its configuration.

Evidence

Before: docs/agents/issue-tracker.md on main has no Claim bullet; grep -rn claim docs/ returns nothing.
After: the bullet above is present. Diff: 7 insertions, one file.

Merge Danger

Door: two-way

A docs-only change; revert with git revert.

Blast Radius: local

Only the tracker doc.

## Summary Restore a `**Claim**` bullet to the tracker doc's Wayfinding operations, so how a session claims a ticket is written down. ```diff docs/agents/issue-tracker.md - **Frontier query**: ... non-`done` task. Do **not** pull the whole project ... + - **Claim**: `task_assignees_create` naming the session's **own** Vikunja user + (its identity) as its first write, before any work. Identities differ per + agent and per deployment; a session reads its own, never one hard-coded + here. If the session has **no** identity configured, assign to Pedro (`pit`) + as the default. The assignee **is** the claim: an unassigned ticket is + unclaimed, and a concurrent session skips a ticket that is already assigned. - **Resolve**: `task_comments_create` with the answer, `tasks_update` ... ``` Why now: PR #8 said claim by comment, never by assignment, but its own trim (commit 9e773d6) deleted both claim bullets, leaving the doc silent while the vendored wayfinder skill still says a session claims by assigning. The repo tracker doc is the override and had no rule. This puts one back: assign, to the session's own identity, falling back to Pedro. No agent identities are named: they differ per agent and per deployment, so naming them would go stale. A session reads its own identity from its configuration. ## Evidence - **Before:** `docs/agents/issue-tracker.md` on `main` has no `Claim` bullet; `grep -rn claim docs/` returns nothing. - **After:** the bullet above is present. Diff: 7 insertions, one file. ## Merge Danger **Door:** two-way A docs-only change; revert with `git revert`. **Blast Radius:** local Only the tracker doc.

pit added 1 commit

2026-10-09 11:12:30 +00:00

agents: claim tickets by assigning them, to Tel (bot-telesphoros) a44cb7be7e

Restore a Claim bullet to the tracker doc's Wayfinding operations: a
session claims a ticket with task_assignees_create, naming the driving
user (Tel, bot-telesphoros), as its first write. The assignee is the
claim, so a concurrent session skips an assigned ticket. Efesto stays
hand-assigned, never by a planning session.

pit force-pushed hermes/claim-by-assignment from a44cb7be7e to 8db77cb5aa

2026-10-09 11:16:16 +00:00

Compare

pit changed title from ~~agents: claim tickets by assigning them, to Tel (bot-telesphoros)~~ to agents: claim tickets by assigning them to the session's own identity

2026-10-09 11:16:40 +00:00

pit force-pushed hermes/claim-by-assignment from 8db77cb5aa to 93fb2d430f

2026-10-09 11:18:05 +00:00

Compare

pit force-pushed hermes/claim-by-assignment from 93fb2d430f to 17383bafe8

2026-10-09 11:22:44 +00:00

Compare

pit merged commit 8ccc327612 into main

2026-10-09 11:23:12 +00:00

pit deleted branch hermes/claim-by-assignment

2026-10-09 11:23:12 +00:00

pit referenced this pull request from a commit