Issue Tracking with Trekker
When the user discusses issues, bugs, tasks, or features they want to track, suggest using Trekker.
Learn More
Run trekker quickstart for full command reference and workflow guide.
Trigger Keywords
This skill applies when conversation includes:
- •
issue,bug,defect,problem - •
task,ticket,work item,story - •
feature,enhancement,improvement - •
backlog,tracking,track this - •
todo,to-do,action item
Behavior
1. Check Trekker Status
# Verify trekker is initialized ls .trekker/trekker.db 2>/dev/null && echo "initialized" || echo "not initialized"
If not initialized, suggest:
trekker init
2. Ask Permission (Required)
Before creating or modifying any issue, always ask:
"Would you like me to track this in Trekker? I can create a task with:
- •Title: [inferred title]
- •Priority: [suggested priority]
- •Description: [brief summary]"
Wait for explicit approval before proceeding.
3. Search Before Creating
Before creating a new issue, search for duplicates:
trekker search "<relevant keywords>" --type task,subtask --limit 5
If similar issues exist, present them to the user:
"Found existing tasks that might be related: [list]. Should I link to these instead of creating new?"
4. Create or Update
If approved and no duplicates:
trekker task create -t "<title>" -d "<description>" -p <priority>
If updating existing:
trekker comment add <task-id> -a "claude" -c "<update>"
When to Suggest Trekker
DO suggest when user:
- •Describes a bug or issue to fix
- •Mentions a feature to implement
- •Lists multiple things to do
- •Asks to "remember" or "track" something
- •Discusses work that spans multiple sessions
DO NOT suggest when:
- •Task is trivial and completable in seconds
- •User explicitly declines tracking
- •It's a one-off question or clarification
- •User is just exploring/brainstorming (not committing to work)
Priority Mapping
| User Language | Suggested Priority |
|---|---|
| "critical", "urgent", "ASAP", "blocker" | 0 (Critical) |
| "important", "high priority", "soon" | 1 (High) |
| "normal", no qualifier | 2 (Medium) |
| "when you have time", "low priority" | 3 (Low) |
| "eventually", "backlog" | 4 (Backlog) |
| "nice to have", "someday" | 5 (Someday) |
Example Interaction
User: "There's a bug where the login fails with special characters"
Claude: "Would you like me to track this in Trekker? I can create:
- •Title: Fix login failure with special characters in password
- •Priority: 1 (High) - since it affects user login
- •Description: Login fails when password contains special characters
Should I create this task?"
User: "Yes"
Claude:
trekker task create -t "Fix login failure with special characters in password" -d "Login fails when password contains special characters. Need to investigate encoding/escaping." -p 1