Tickets

Tickets are the core unit of work in Operator. They describe tasks for LLM agents to complete.

Ticket Format

Tickets are markdown files with a specific naming convention:

{TYPE}-{ID}-{project}-{description}.md

Examples

INV-001-backend-investigate-login-failure.md
FIX-042-api-fix-null-pointer.md
FEAT-123-frontend-add-dark-mode.md
SPIKE-007-platform-evaluate-kubernetes.md

Ticket Structure

A typical ticket contains:

# FEAT-123: Add Dark Mode

## Summary
Implement a dark mode toggle in the application settings.

## Requirements
- Add toggle switch in settings page
- Persist preference to local storage
- Apply theme to all components
- Support system preference detection

## Acceptance Criteria
- [ ] Toggle switch works
- [ ] Theme persists across sessions
- [ ] All components support both themes

## Notes
See design mockup in Figma: [link]

Creating Tickets

Manual Creation

  1. Create a markdown file in .tickets/queue/
  2. Follow the naming convention
  3. Add ticket content

Using Operator CLI

# Show current queue
cargo run -- queue

# Launch next ticket
cargo run -- launch

Ticket Directories

.tickets/
├── queue/        # Pending work
├── in-progress/  # Currently being worked
└── completed/    # Finished work

Ticket Lifecycle

  1. Created - Ticket added to queue/
  2. Assigned - Moved to in-progress/ when agent starts
  3. Completed - Moved to completed/ when done

Best Practices