Common Workflows¶

Practical examples of using TaskRepo in different scenarios.

Personal Task Management¶

Daily Routine¶

Morning:

# Sync tasks
tsk sync

# Review today's tasks
tsk list --sort due

# Check high-priority items
tsk list --priority H

# Start first task
tsk in-progress 1

Throughout the day:

# Complete task
tsk done 1

# Start next task
tsk in-progress 2

# Add urgent task
tsk add --priority H --title "Fix production bug" --due today

Evening:

# Review completed tasks
tsk done

# Plan tomorrow
tsk list --sort due

# Sync changes
tsk sync --push

Weekly Review¶

# Review all tasks
tsk list --all

# Archive completed tasks
tsk archive 5,6,7,8

# Extend due dates if needed
tsk ext 10,11 1w

# Clean up cancelled tasks
tsk list --status cancelled
tsk del 12,13

Team Collaboration¶

Shared Repository Setup¶

Team lead:

# Create team repository
tsk create-repo --name team-backend
# Answer 'yes' to create GitHub repository

# Share repository URL with team
echo "Clone: gh repo clone {org}/tasks-team-backend ~/tasks/tasks-team-backend"

Team members:

# Clone repository
cd ~/tasks
gh repo clone {org}/tasks-team-backend

# Verify
tsk repos

Daily Standup Workflow¶

Before standup:

# Sync latest changes
tsk sync --repo team-backend

# See your tasks
tsk list --repo team-backend --assignee @alice

# Review in-progress items
tsk list --repo team-backend --status in-progress --assignee @alice

During standup:

# Show completed tasks since yesterday
tsk done --repo team-backend --assignee @alice

# Show current work
tsk list --repo team-backend --status in-progress --assignee @alice

# Show blockers
tsk list --repo team-backend --priority H --assignee @alice

After standup:

# Update task priorities based on discussion
tsk edit 5 --priority H

# Assign new tasks
tsk edit 6 --assignees @bob

# Sync changes
tsk sync --repo team-backend --push

Sprint Planning¶

At sprint start:

# Create sprint tasks
tsk add --repo team-backend \
  --title "Implement user authentication" \
  --project sprint-12 \
  --priority H \
  --assignees @alice \
  --tags feature,auth \
  --due "2025-11-15"

# Repeat for all sprint tasks...

# Review sprint backlog
tsk list --repo team-backend --project sprint-12

During sprint:

# Daily sync
tsk sync --repo team-backend --push

# Track progress
tsk list --repo team-backend --project sprint-12 --status in-progress

At sprint end:

# Review completed
tsk list --repo team-backend --project sprint-12 --status completed

# Move incomplete to next sprint
tsk edit 10,11,12 --project sprint-13

# Archive completed tasks
tsk archive 1,2,3,4,5

Project Management¶

New Project Setup¶

# Create project repository
tsk create-repo --name project-alpha

# Define project phases
tsk add --repo project-alpha \
  --title "Phase 1: Requirements gathering" \
  --project planning \
  --priority H \
  --due "2025-11-01"

tsk add --repo project-alpha \
  --title "Phase 2: System design" \
  --project planning \
  --priority H \
  --due "2025-11-15"

tsk add --repo project-alpha \
  --title "Phase 3: Implementation" \
  --project development \
  --priority M \
  --due "2025-12-31"

# Add dependencies (edit files to add depends field)
# Phase 2 depends on Phase 1
# Phase 3 depends on Phase 2

Milestone Tracking¶

# Add milestone tasks
tsk add --repo project-alpha \
  --title "Milestone 1: MVP Complete" \
  --project milestones \
  --priority H \
  --tags milestone \
  --due "2025-12-01"

# Review milestone tasks
tsk list --repo project-alpha --tag milestone

# Track progress toward milestone
tsk list --repo project-alpha --project development --status completed
tsk list --repo project-alpha --project development --status pending

Bug Tracking¶

Report Bug¶

# Add bug task
tsk add --repo work \
  --title "Login fails with expired token" \
  --project backend \
  --priority H \
  --tags bug,security \
  --links https://github.com/org/repo/issues/123 \
  --assignees @alice \
  --due "2025-11-01"

Triage Bugs¶

# List all bugs
tsk list --repo work --tag bug

# Prioritize critical bugs
tsk edit 5,6,7 --priority H --tag critical

# Assign bugs
tsk edit 8 --assignees @bob
tsk edit 9 --assignees @alice

Bug Fix Workflow¶

# Start working on bug
tsk in-progress 5

# Add investigation notes (edit description)
tsk edit 5
# (Add findings to description)

# Mark as fixed
tsk done 5

# Link to fix commit
tsk edit 5 --links https://github.com/org/repo/pull/456

Feature Development¶

Feature Breakdown¶

# Create feature epic
tsk add --repo work \
  --title "User Authentication System" \
  --project auth \
  --priority H \
  --tags feature,epic

# Break down into tasks
tsk add --repo work \
  --title "Design authentication flow" \
  --project auth \
  --priority H \
  --tags feature,design

tsk add --repo work \
  --title "Implement JWT tokens" \
  --project auth \
  --priority H \
  --tags feature,backend

tsk add --repo work \
  --title "Create login UI" \
  --project auth \
  --priority M \
  --tags feature,frontend

tsk add --repo work \
  --title "Write integration tests" \
  --project auth \
  --priority M \
  --tags feature,testing

Feature Progress Tracking¶

# View all feature tasks
tsk list --repo work --project auth

# Track completed
tsk list --repo work --project auth --status completed

# Check remaining work
tsk list --repo work --project auth --status pending

# Update priorities as needed
tsk edit 10 --priority H  # Block on this task

Research and Documentation¶

Research Task¶

# Create research task
tsk add --repo research \
  --title "Evaluate authentication libraries" \
  --project tech-research \
  --priority M \
  --tags research \
  --links https://docs.library-a.com,https://docs.library-b.com

# Add findings to description
tsk edit 1
# (Add evaluation criteria, pros/cons, recommendation)

# Complete research
tsk done 1

Documentation Workflow¶

# Track documentation tasks
tsk add --repo work \
  --title "Update API documentation" \
  --project docs \
  --priority M \
  --tags documentation \
  --links https://github.com/org/repo/tree/main/docs

# Link to docs PR
tsk edit 1 --links https://github.com/org/repo/pull/789

# Complete
tsk done 1

Maintenance and Cleanup¶

Weekly Cleanup¶

# Review old pending tasks
tsk list --sort created

# Cancel outdated tasks
tsk cancelled 15,16,17

# Archive old completed tasks
tsk done  # See completed tasks
tsk archive 20,21,22,23

# Extend due dates for remaining tasks
tsk list --sort due
tsk ext 5,6 1w

Repository Maintenance¶

# List repositories
tsk repos

# Sync all repositories
tsk sync

# Archive old completed tasks in all repos
tsk archive --repo work
tsk archive --repo personal
tsk archive --repo research

Time-Based Workflows¶

GTD (Getting Things Done)¶

Capture:

# Quickly add tasks as they come
tsk add --title "Review design doc" --repo work
tsk add --title "Buy groceries" --repo personal
tsk add --title "Call dentist" --repo personal

Clarify:

# Review and organize captured tasks
tsk list --status pending

# Add details
tsk edit 1 --priority H --due tomorrow --project reviews
tsk edit 2 --tags errands --due today
tsk edit 3 --priority L

Organize:

# By context
tsk list --repo work --project reviews
tsk list --repo personal --tag errands

# By priority
tsk list --priority H

Reflect:

# Weekly review
tsk list --all
tsk done  # Review completed

Engage:

# Work on next task
tsk list --priority H --sort due
tsk in-progress 1

Pomodoro Technique¶

# Select task for session
tsk list --priority H
tsk in-progress 5

# After pomodoro
# Either complete or continue
tsk done 5
# OR leave as in-progress for next session

# Track completed pomodoros in description
tsk edit 5
# Add: "Completed 3 pomodoros"

Eisenhower Matrix¶

Urgent + Important (Do first):

tsk list --priority H --due today

Important, Not Urgent (Schedule):

tsk list --priority H --sort due
# Schedule with specific due dates

Urgent, Not Important (Delegate):

tsk list --priority M --due today
# Assign to others
tsk edit 10 --assignees @bob

Neither (Eliminate):

tsk list --priority L
# Cancel if not needed
tsk cancelled 15,16

Integration Workflows¶

Email to Task¶

Manual process: 1. Receive email requiring action 2. Copy email URL (Gmail, Outlook, etc.) 3. Create task with email link

tsk add --title "Respond to client inquiry" \
  --links https://mail.google.com/mail/u/0/#inbox/abc123 \
  --priority H \
  --due tomorrow

GitHub Issue to Task¶

# Create task from GitHub issue
gh issue view 123 --json title,url | \
  jq -r 'tsk add --title "\(.title)" --links "\(.url)"'

# Or manually
tsk add --title "Fix bug #123: Login error" \
  --links https://github.com/org/repo/issues/123 \
  --priority H \
  --tags bug

Calendar Event to Task¶

# After meeting, create follow-up task
tsk add --title "Send meeting notes" \
  --due today \
  --priority M

# Add action items from meeting
tsk add --title "Implement feature discussed in meeting" \
  --project backend \
  --due "2025-11-15"

Next Steps¶

Configuration Examples - Configuration setups for different use cases
Task Management Guide - Detailed task operations
Search & Filters - Advanced filtering techniques