| name | issue-tracking |
| description | Creates and manages issues via tissue for tracking work items, bugs, and features. Use for organizing work, checking ready issues, or updating status. |
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:
- Check
tissue readyto see what's available - Start working:
tissue status <id> in_progress - Add comments as you discover things
- 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.