This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git


The following commit(s) were added to refs/heads/main by this push:
     new d207818ba528 CAMEL-24603: Document JIRA workflow transition IDs in 
AGENTS.md (#26175)
d207818ba528 is described below

commit d207818ba5284b3f13a61dcb257467acc5369970
Author: Karol Krawczyk <[email protected]>
AuthorDate: Wed Sep 9 08:58:02 2026 +0200

    CAMEL-24603: Document JIRA workflow transition IDs in AGENTS.md (#26175)
    
    * CAMEL-24603: Document JIRA workflow transition IDs in AGENTS.md
    
    Agents look up the numeric transition IDs on every workflow move. List the
    three common ones next to the rule that requires the move, while keeping the
    /transitions check mandatory, since availability depends on the issue state.
    
    Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
    
    * CAMEL-24603: Correct the availability caveat for transition ID 4
    
    Start Progress is gated on the issue being assigned to the caller, not on 
the
    state it is in. An Open issue offers 4 only to its assignee, so an agent 
that
    sees 4 missing on an Open ticket should read it as "not assigned yet" rather
    than as a fault. Ties the caveat back to the assign-then-transition order 
the
    bullet already prescribes.
    
    Also point step 6 of the Merge Procedure at the ID list, and match the arrow
    style used elsewhere in the file.
    
    Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
    
    ---------
    
    Co-authored-by: Claude Opus 5 (1M context) <[email protected]>
---
 AGENTS.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 75bdfdca38f2..e0426a118a34 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -50,6 +50,15 @@ These rules apply to ALL AI agents working on this codebase.
 - An agent MUST ONLY pick up **Unassigned** JIRA tickets.
 - If a ticket is already assigned to a human, the agent must not reassign it 
or work on it.
 - Before starting work, the agent must assign the ticket to its operator and 
transition it to "In Progress".
+  The CAMEL workflow (ASF JIRA) uses these numeric transition IDs:
+  - `4` → Start Progress (In Progress)
+  - `5` → Resolve Issue (Resolved)
+  - `2` → Close Issue (Closed)
+
+  Still query the issue's `/transitions` endpoint before firing one of these 
IDs. Availability
+  depends on both the current state and on the caller — `4` is only offered 
once the issue is
+  assigned to you, which is why the assign step above comes first. The list 
saves a lookup, it
+  does not replace the availability check.
 - Before closing a ticket, always set the correct `fixVersions` field.
   Note: `fixVersions` cannot be set on an already-closed issue — set it before 
closing,
   or reopen/set/close if needed.
@@ -158,6 +167,7 @@ When merging a PR, an agent MUST perform the following 
steps **in order**:
 
 6. **Close the JIRA issue**:
    - Transition the JIRA issue to **Resolved/Fixed** (ensure `fixVersions` is 
already set from step 2).
+     The transition IDs are listed under "JIRA Ticket Ownership" above.
    - Add a comment linking to the merged PR.
 
 7. **Clean up the branch**:

Reply via email to