/gaia-action-items

user-facing
Category:
Sprint Management
Lifecycle phase:
4 -- Implementation
Arguments:
[action-id | status]

What it does

/gaia-action-items processes open action items that accumulated since the last sprint. It walks through each item, routes it to the appropriate agent or asks you directly, records the resolution with reasoning, and updates the tracker. This is the pre-sprint triage pass -- resolve action items before planning the next sprint.

When to use it

  • Before sprint planning, to clear the action-item backlog.
  • Sprint planning halted because a HIGH-priority action item is blocking -- resolve it here.
  • You want a dashboard view of all action items (/gaia-action-items status).

Prerequisites

  • Action items must exist. The tracker at .gaia/artifacts/planning-artifacts/action-items.yaml is populated by /gaia-retro, /gaia-triage-findings, and /gaia-correct-course.

How to invoke

/gaia-action-items

Processes all open items. Or target a single item:

/gaia-action-items AI-42

Or view the dashboard only:

/gaia-action-items status

What it does step by step

  1. Load and display Reads the tracker, applies escalation rules (items open 3+ sprints auto-escalate), and renders the dashboard or processing list.
  2. Process each item Routes each item by type to the appropriate handler: clarification items go to the assigned agent, implementation items to the Scrum Master, process items directly to you, and automation items to the Scrum Master.
  3. Update tracker Persists the resolution (done, invalid, deferred, in-progress) with reasoning for each processed item.
  4. Summary report Displays the processing summary: resolved, invalid, deferred, and in-progress counts.

Inputs

InputSourceDescription
Action items tracker.gaia/artifacts/planning-artifacts/action-items.yamlAll action items with status, priority, and escalation count.

Outputs

OutputLocationDescription
Updated tracker.gaia/artifacts/planning-artifacts/action-items.yamlStatuses, resolutions, and related stories updated.
New stories (if applicable).gaia/artifacts/implementation-artifacts/Backlog stories created from implementation-type action items.

Example session

> /gaia-action-items

Action Items: 4 open

| # | ID    | Title                        | Type          | Priority | Age |
|---|-------|------------------------------|---------------|----------|-----|
| 1 | AI-15 | Add mock server for APIs     | implementation| HIGH     | 1   |
| 2 | AI-16 | Automate test data seeding   | automation    | MEDIUM   | 1   |
| 3 | AI-12 | Clarify auth token lifetime  | clarification | HIGH     | 2   |
| 4 | AI-9  | Update CI timeout to 10min   | process       | LOW      | 3   |

Processing 4 items...

Item AI-15: Add mock server for third-party APIs
  Type: implementation | Priority: HIGH
  SM (Nate): Recommends creating a new story.
  Classification: backlog story. Confirm? yes
  Creating story E5-S18 via /gaia-create-story...
  Resolved: done (story E5-S18 created).

Item AI-12: Clarify auth token lifetime
  Type: clarification | Priority: HIGH (escalated, 2 sprints)
  Architect (Theo): Token lifetime should be 24h with refresh.
  Resolved: done.

Processed: 4 | Resolved: 3 | Deferred: 1 | In Progress: 0

All action items resolved. Ready for /gaia-sprint-plan.

What to run next

Troubleshooting

"No action items tracked yet"

The tracker file does not exist yet. Action items are created by /gaia-retro, /gaia-triage-findings, and /gaia-correct-course.