Issue Tracking Skill

Work tracking via tissue, a git-native issue tracker.

When to Use

• Creating new issues for bugs or features
• Checking what's ready to work on
• Updating issue status
• Adding comments or context to issues
• Managing dependencies between issues

Setup

Tissue stores issues in .tissue/ (git-tracked).

# Initialize (once per project)
tissue init

Core Operations

List issues

tissue list                    # All issues
tissue list --status open      # Open only
tissue list --tag bug          # By tag
tissue list --priority 1       # High priority

Show ready issues

tissue ready                   # No blockers, ready to work

Show issue details

tissue show <id>

Create issue

tissue new "title"
tissue new "title" -t bug              # With tag
tissue new "title" -p 1                # Priority 1 (highest)
tissue new "title" -t feature -p 2     # Both

Update status

tissue status <id> open
tissue status <id> in_progress
tissue status <id> closed

Add comment

tissue comment <id> -m "message"

Tags and Priority

Standard Tags

Tag	Purpose
bug	Something broken
feature	New functionality
refactor	Code improvement
docs	Documentation
trivial	Quick fix

Priority Levels

Priority	Meaning
1	Critical - do first
2	High - do soon
3	Medium - normal
4	Low - when time permits
5	Backlog - someday

Dependencies

# Add dependency (A blocks B)
tissue dep add <blocker-id> blocks <blocked-id>

# Remove dependency
tissue dep rm <blocker-id> blocks <blocked-id>

# Show what blocks an issue
tissue show <id>   # Lists blockers

Workflow Integration

Use tissue to track work items. When working on an issue:

1. Check tissue ready to see what's available
2. Start working: tissue status <id> in_progress
3. Add comments as you discover things
4. Close when done: tissue status <id> closed

Issue Naming

Issues get IDs like auth-a3f2. The prefix comes from the title:

• "Fix auth bug" → auth-xxxx
• "Add caching" → caching-xxxx

Examples

# Create a bug
tissue new "Login fails on Safari" -t bug -p 2

# Check ready work
tissue ready

# Start working
tissue status auth-a3f2 in_progress

# Add finding
tissue comment auth-a3f2 -m "Root cause: cookie SameSite attribute"

# Close it
tissue status auth-a3f2 closed

Querying

# High priority bugs
tissue list --tag bug --priority 1

# All open features
tissue list --tag feature --status open

# Everything assigned to current sprint
tissue list --tag sprint-42

Integration with jwz

Issue topics in jwz follow the pattern issue:<id>:

# Post to issue topic
jwz post "issue:auth-a3f2" -m "Starting work on this"

# Read issue discussion
jwz read "issue:auth-a3f2"

This connects tissue issues with agent discussions.