Reconcile Risk and Problem Tickets
AIN-3 Order: #3 Construction Has Dependencies
Updated 1 month, 2 weeks ago
Guidance
Objective
Apply the measured variable results to a stable, idempotent Risk/Problem ticket lifecycle.
Procedure
- Load
VARIABLE_RESULTS.jsonand the configured GH/Jira adapter. - For each variable derive
concern_key = <project_id>:<variable_id>. - Fan out read-only ticket lookup if useful, then serialize all creates/updates/closes per
concern_key. Never let two workers mutate the same concern. - Apply this state machine:
- Green with no open concern: no action.
- Yellow/Orange: create or update one Risk ticket.
- Red: create or update one Problem ticket; convert the same concern when the adapter supports type change, otherwise link/close the old representation atomically.
- Unknown: never close or green a concern. Create/update the same concern as a measurement-health Risk unless the Charter declares a stricter treatment.
- Return to Green: resolve the open concern only with fresh Green evidence. - On Yellow↔Orange, band changes, new evidence, changed severity, or gating-policy changes, update the existing ticket even when its type does not change.
- Use
<run_id>:<variable_id>as the idempotency key. Retry must yield the same ticket and action record. - Emit
TICKET_ACTIONS.jsonwith prior/new state, action, ticket ID/URL, evidence, gating policy, and errors.
Failure handling
A ticket-adapter failure does not erase the measurement. Mark the action failed, keep the run incomplete, and retry idempotently. Never create a substitute duplicate.
Completion evidence
Every non-Green/Unknown variable has exactly one stable concern; lifecycle changes reflect evidence; gating signals are explicit; and a repeated run/retry creates no duplicate ticket.
Details
- Order:
- #3
- Phase:
- Predecessor:
- AIN-2 Assess Charter Variables
- Successor:
- AIN-6 Converge Assessment & Publish Report
- Created:
- Sep 21, 2026
- Last Updated:
- Sep 21, 2026
Workflow
Assess the Iteration
Independent supervisory workflow that may run manually or on a Huginn schedule several times during one RIN cycle. Each run …
View WorkflowAssigned Agent
Delivery Manager (DM)
Single merged PM/DM role. Staffed at Kickoff. Owns the Charter, is the recipient of all …
Required Skills
No skills linked
Rules
-
Band → Ticket Type Mapping
band-ticket-type-mapping -
One Ticket Per Concern
one-ticket-per-concern -
Ticket Lifecycle Transitions
ticket-lifecycle-transitions
Input Artifacts 2
-
Assessment Run Record
Document
Required
Produced by: Open an Assessment Run -
Variable Assessment Evidence
Document
Required
Produced by: Assess Charter Variables
Output Artifacts 2
- Project-Management Ticket Other
- Ticket Action Record Document Required