issue-tracking

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 using single keywords (FTS5, not semantic):

# Use the most distinctive keyword from the issue
trekker search "<keyword>" --type task,subtask --limit 5
# Try a second keyword if first search has no results
trekker search "<related keyword>" --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