Ticket

Ticket

Create tickets in tmp/tickets/ for Ralph to work on autonomously.

When to Use

• Planning work to delegate to Ralph
• Breaking down a feature into discrete tasks
• Creating a backlog of improvements
• Capturing bugs or issues to fix later

Instructions

1. Ensure Directory Exists

mkdir -p tmp/tickets/done

2. Gather Requirements

Ask the user:

• What needs to be done?
• Any reference number? (e.g., CEL-042, PROJ-123, or just use sequential numbers)
• Any specific files or areas of the codebase?
• Acceptance criteria?

3. Create Ticket

Filename format: {REFERENCE}-{short-description}.md

Examples:

• CEL-042-add-logout-button.md
• 001-fix-header-alignment.md
• PROJ-99-refactor-auth-flow.md

4. Ticket Template

# {Title}

{Clear description of what needs to be done}

## Context

{Why this is needed, background info}

## Files

{Known files that need changes, if any}

## Acceptance Criteria

- [ ] {Specific requirement 1}
- [ ] {Specific requirement 2}

Workflow

1. Single ticket: User describes one task, create it
2. Batch planning: User describes a feature, help break it into multiple tickets
3. Review: Show created tickets, let user refine before finishing

Commands

After creating tickets, suggest:

• ralph status - see pending tickets
• ralph run - start working through them

Example Session

User: I need to add user authentication

Assistant: Let me help break that down into tickets. A few questions:

1. What auth method? (OAuth, email/password, magic link?)
2. Do you have a reference prefix? (e.g., AUTH-001)
3. Any existing auth code to work with?

User: Email/password, use AUTH prefix, starting fresh

Assistant: I'll create these tickets:

1. AUTH-001-user-model.md - Create User model with email/password fields
2. AUTH-002-signup-endpoint.md - POST /api/auth/signup
3. AUTH-003-login-endpoint.md - POST /api/auth/login
4. AUTH-004-session-middleware.md - Session handling middleware
5. AUTH-005-protected-routes.md - Add auth checks to protected routes

Want me to create these, or adjust the breakdown first?

User: Create them

Assistant: Created 5 tickets:

• tmp/tickets/AUTH-001-user-model.md
• tmp/tickets/AUTH-002-signup-endpoint.md
• ...

Run ralph status to see them, or ralph run to start working.

Notes

• Keep tickets focused and atomic
• One clear deliverable per ticket
• Ralph works one ticket at a time
• Tickets should be completable in a single session