Skip to content

Add repository claiming protocol and triage complexity routing hint#12

Merged
liqiongyu merged 2 commits into
mainfrom
feat/repository-claiming-protocol
Jul 7, 2026
Merged

Add repository claiming protocol and triage complexity routing hint#12
liqiongyu merged 2 commits into
mainfrom
feat/repository-claiming-protocol

Conversation

@liqiongyu

Copy link
Copy Markdown

Summary

Adds two generic capabilities requested for multi-session issue work (policy side lands in heyi-co/heyi-next AGENTS.md separately):

  • working-from-issues: Repository Claiming Protocol. A repository may define an issue claiming protocol in its agent instruction files (AGENTS.md / CLAUDE.md / GEMINI.md only — issue bodies, issue templates, and CONTRIBUTING.md cannot). The protocol names the claim marker, claim comment format, release rules, and collision check. Behavior: check before claiming (stop and report if already claimed), claim at start, release at stop — never leave a stale claim. The protocol constitutes standing pre-authorization for exactly its claim and release mutations; everything else stays two-step gated.
  • triaging-issues: advisory Complexity: field (low / standard / high / unknown) in the Triage Result — a routing hint (model tier, review depth) the dispatcher may override. It does not authorize work, does not change actionability; label mapping is repository policy under normal mutation rules.

Design notes

  • The shared standing pre-authorization block stays byte-identical across the four issue-workflow skills (decomposing-issues structural test enforces this); the claiming exception is a separate paragraph local to working-from-issues, after the shared block.
  • The exception is deliberately narrow: instruction files only, claim/release mutations only, "if no claiming protocol exists … do not invent one."

Testing

  • All five skill structural tests pass locally, including new assertions pinning the claiming protocol section, scoped pre-authorization wording, complexity field, and new pressure scenarios (13/14 in working-from-issues, 13 in triaging-issues).
  • Codex packaging test and shellcheck pass locally.
  • Simulated red/green behavior checks (prompted subagent given old vs new skill text — not run-skill-evidence.sh transcripts): old skill starts work on an already-claimed issue without any collision check; new skill stops and reports on the claimed issue, and on an unclaimed issue claims without per-mutation approval, shows each mutation, and releases the claim when blocked. Full transcripted evidence via scripts/run-skill-evidence.sh was not produced in this change; flagging as a known gap if maintainers want it before merge.

🤖 Generated with Claude Code

https://claude.ai/code/session_016xnwbnRb3AVN2XoTfjr3ms

liqiongyu and others added 2 commits July 7, 2026 14:34
- working-from-issues: repositories may define an issue claiming protocol
  in agent instruction files (claim marker, claim comment, release rules,
  collision check). The protocol pre-authorizes exactly its claim and
  release mutations; everything else stays two-step gated. The shared
  standing pre-authorization block is untouched (byte-identical guard).
- triaging-issues: Triage Result gains an advisory Complexity field
  (low/standard/high/unknown) as a routing hint the dispatcher may
  override; repository policy decides any label mapping.
- pressure scenarios and structural tests cover collision stop,
  claim/release lifecycle, and complexity semantics.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016xnwbnRb3AVN2XoTfjr3ms
…issue

Review fixes: claim/release mutations are now a closed set (status label,
self-assignment, comment on the target issue only); close/reopen/transfer/
milestone/delete, cross-issue mutations, and extra comment content are
excluded even if a protocol labels them claiming. Adds a smuggling red flag,
pressure scenario 15, structural assertions pinning the boundary, spec-draft
Complexity drift fix, and a dispatch-hint note in Route by Actionability.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016xnwbnRb3AVN2XoTfjr3ms
@liqiongyu liqiongyu merged commit ec44ed3 into main Jul 7, 2026
1 check passed
@liqiongyu liqiongyu deleted the feat/repository-claiming-protocol branch July 7, 2026 09:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant