/find

Task Find Command

Search and locate tasks across all orchestrations using various criteria.

Usage

/task-find [search-term] [options]

Description

Powerful search functionality to quickly locate tasks by ID, content, status, dependencies, or any other criteria. Supports regex, fuzzy matching, and complex queries.

Basic Search

By Task ID

/task-find TASK-001
/task-find TASK-*

By Title/Content

/task-find "authentication"
/task-find "payment processing"

By Status

/task-find --status in_progress
/task-find --status qa,completed

Advanced Search

Regular Expression

/task-find --regex "JWT|OAuth"
/task-find --regex "TASK-0[0-9]{2}"

Fuzzy Search

/task-find --fuzzy "autentication"  # finds "authentication"
/task-find --fuzzy "paymnt"         # finds "payment"

Multiple Criteria

/task-find --status todos --priority high --type feature
/task-find --agent dev-backend --created-after yesterday

Search Operators

Boolean Operators

/task-find "auth AND login"
/task-find "payment OR billing"
/task-find "security NOT test"

Field-Specific Search

/task-find title:"user authentication"
/task-find description:"security vulnerability"
/task-find agent:dev-frontend
/task-find blocks:TASK-001

Date Ranges

/task-find --created "2024-03-10..2024-03-15"
/task-find --modified "last 3 days"
/task-find --completed "this week"

Output Formats

Default List View

Found 3 tasks matching "authentication":

TASK-001: Implement JWT authentication
  Status: in_progress | Agent: dev-frontend | Created: 2024-03-15
  Location: /task-orchestration/03_15_2024/auth_system/tasks/in_progress/

TASK-004: Add OAuth2 authentication  
  Status: todos | Priority: high | Blocked by: TASK-001
  Location: /task-orchestration/03_15_2024/auth_system/tasks/todos/

TASK-007: Authentication middleware tests
  Status: todos | Type: test | Depends on: TASK-001
  Location: /task-orchestration/03_15_2024/auth_system/tasks/todos/

Detailed View

/task-find TASK-001 --detailed

Shows full task content including description, implementation notes, and history.

Tree View

/task-find --tree --root TASK-001

Shows task and all its dependencies in tree format.

Filtering Options

By Orchestration

/task-find --orchestration "03_15_2024/payment_system"
/task-find --orchestration "*/auth_*"

By Properties

/task-find --has-dependencies
/task-find --no-dependencies
/task-find --blocking-others
/task-find --effort ">4h"

By Relationships

/task-find --depends-on TASK-001
/task-find --blocks TASK-005
/task-find --related-to TASK-003

Special Searches

Find Circular Dependencies

/task-find --circular-deps

Find Orphaned Tasks

/task-find --orphaned

Find Duplicate Tasks

/task-find --duplicates

Find Stale Tasks

/task-find --stale --days 7

Quick Filters

Ready to Start

/task-find --ready

Shows todos with no blocking dependencies.

Critical Path

/task-find --critical-path

Shows tasks on the critical path.

High Impact

/task-find --high-impact

Shows tasks blocking multiple others.

Export Options

Copy Results

/task-find "auth" --copy

Copies results to clipboard.

Export Paths

/task-find --status todos --export paths

Exports file paths for batch operations.

Generate Report

/task-find --report

Creates detailed search report.

Examples

Example 1: Find Work for Agent

/task-find --status todos --suitable-for dev-frontend --ready

Example 2: Find Blocking Issues

/task-find --status on_hold --show-blockers

Example 3: Security Audit

/task-find "security OR auth OR permission" --type "feature,bugfix"

Example 4: Sprint Planning

/task-find --status todos --effort "<4h" --no-dependencies

Search Shortcuts

Recent Tasks

/task-find --recent 10

My Tasks

/task-find --mine  # Uses current agent context

Modified Today

/task-find --modified today

Complex Queries

Compound Search

/task-find '(title:"auth" OR description:"security") AND status:todos AND -blocks:*'

Saved Searches

/task-find --save "security-todos"
/task-find --load "security-todos"

Performance Tips

1. **Use Indexes**: Status and ID searches are fastest 2. **Narrow Scope**: Specify orchestration when possible 3. **Cache Results**: Use `--cache` for repeated searches 4. **Limit Results**: Use `--limit 20` for large result sets

Integration

With Other Commands

/task-find "payment" --status todos | /task-move in_progress

Batch Operations

/task-find --filter "priority:low" | /task-update priority:medium

Notes

• Searches across all task files in task-orchestration/
• Case-insensitive by default (use --case for case-sensitive)
• Results sorted by relevance unless specified otherwise
• Supports command chaining with pipe operator
• Search index updated automatically on file changes