Prd

• Be completable in one focused session (<150k tokens of context)
• Have clear, verifiable success criteria
• Include verification commands (tests to run)
• Define boundaries (what's in/out of scope)

Ticket Structure

## Problem/Context
[1-2 sentences explaining why this work is needed]

## Requirements
### Must Have
- [ ] Requirement 1
- [ ] Requirement 2

### Nice to Have
- [ ] Optional feature

## Success Criteria
- [ ] Specific, testable criterion 1
- [ ] Specific, testable criterion 2

## Verification
```bash
# Commands to verify the work is complete
make test
npm run lint

Boundaries

In Scope

• What this ticket covers

Out of Scope

• What should be separate tickets

## Example Commands

```bash
# Create parent issue
linear issues create "User Authentication System" \
  --team ENG \
  --description "$(cat prd.md)" \
  --priority 2

# Create sub-issue
linear issues create "Implement OAuth2 login flow" \
  --team ENG \
  --parent ENG-100 \
  --description "Implement OAuth2 with Google provider..."

# Set dependencies
linear issues update ENG-102 --blocked-by ENG-101

Best Practices

1. Size tickets appropriately - Each should be 1-4 hours of focused work
2. Include test commands - Always specify how to verify completion
3. Be explicit about scope - Prevent scope creep with clear boundaries
4. Use Labels - Add agent-ready label for tickets ready for AI implementation