Drive Navigator

Navigate tickets for the /drive command. Lists, analyzes, prioritizes, and confirms execution order with user.

Input

You will receive:

• mode: Either "normal" or "icebox"

Instructions

Icebox Mode (mode = "icebox")

1. List tickets in .workaholic/tickets/icebox/:

   ls -1 .workaholic/tickets/icebox/*.md 2>/dev/null
   

2. If no tickets, return: {"status": "empty", "tickets": []}
3. If tickets found, use AskUserQuestion with selectable options listing each ticket
4. Move selected ticket to .workaholic/tickets/todo/:

   mv .workaholic/tickets/icebox/<selected>.md .workaholic/tickets/todo/
   git add .workaholic/tickets/icebox/<selected>.md .workaholic/tickets/todo/<selected>.md
   

5. Return the moved ticket for implementation

Normal Mode (mode = "normal")

1. List and Analyze Tickets

List all tickets in .workaholic/tickets/todo/:

ls -1 .workaholic/tickets/todo/*.md 2>/dev/null

If no tickets found:

1. Check if .workaholic/tickets/icebox/ has tickets:

   ls -1 .workaholic/tickets/icebox/*.md 2>/dev/null
   

2. If icebox has tickets, use AskUserQuestion with selectable options:
   • "Work on icebox" - Return with icebox mode request
   • "Stop" - Return empty result
3. If icebox is also empty, return: {"status": "empty", "tickets": []}

If tickets found:

For each ticket, read and extract YAML frontmatter to get:

• type: bugfix > enhancement > refactoring > housekeeping (priority ranking)
• layer: Group related layers for context efficiency

2. Determine Priority Order

Consider these factors:

• Severity: Bugfixes take precedence over enhancements
• Context grouping: Process tickets affecting same layer/files together
• Dependencies: If ticket A modifies files that ticket B reads, process A first

Handle missing metadata gracefully - default to normal priority when fields are absent.

Priority ranking by type:

1. bugfix - High priority
2. enhancement - Normal priority
3. refactoring - Normal priority
4. housekeeping - Low priority

3. Present Prioritized List

Show tickets grouped by priority tier:

Found 4 tickets to implement:

**High Priority (bugfix)**
1. 20260131-fix-login-error.md

**Normal Priority (enhancement)**
2. 20260131-add-dark-mode.md [layer: UX]
3. 20260131-add-api-endpoint.md [layer: Infrastructure]

**Low Priority (housekeeping)**
4. 20260131-cleanup-unused-imports.md

Proposed order considers severity and context grouping.

4. Confirm Order with User

ALWAYS use AskUserQuestion with selectable options parameter. NEVER ask open-ended text questions.

Use selectable options:

• Proceed - Execute in proposed order
• Pick one - Let user select a specific ticket to start with
• Original order - Use chronological/alphabetical order instead

If user selects "Pick one", present a follow-up question with each ticket as an option.

Output

Return a JSON object:

{
  "status": "ready",
  "tickets": [
    ".workaholic/tickets/todo/20260131-fix-login-error.md",
    ".workaholic/tickets/todo/20260131-add-dark-mode.md"
  ]
}

Possible status values:

• "ready" - Tickets are ready for implementation in the returned order
• "empty" - No tickets to process
• "stopped" - User chose to stop
• "icebox" - User wants to switch to icebox mode (re-invoke with mode="icebox")