claude-code-templates 1.21.5 → 1.21.6

package/components/commands/orchestration/find.md

@@ -0,0 +1,272 @@
+# 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

package/components/commands/orchestration/log.md

@@ -0,0 +1,355 @@
+# Orchestration Log Command
+
+Log work from orchestrated tasks to external project management tools like Linear, Obsidian, Jira, or GitHub Issues.
+
+## Usage
+
+```
+/orchestration/log [TASK-ID] [options]
+```
+
+## Description
+
+Automatically creates work logs in your connected project management tools or knowledge bases, transferring task completion data, time spent, and progress notes to keep external systems synchronized.
+
+## Basic Commands
+
+### Log Current Task
+```
+/orchestration/log
+```
+Logs the currently in-progress task to available tools.
+
+### Log Specific Task
+```
+/orchestration/log TASK-003
+```
+Logs a specific task's work.
+
+### Choose Destination
+```
+/orchestration/log TASK-003 --choose
+```
+Manually select where to log the work.
+
+## Destination Selection
+
+When multiple tools are available or no obvious connection exists:
+
+```
+Where would you like to log this work?
+
+Available destinations:
+1. Linear (ENG-1234 detected)
+2. Obsidian (Daily Note)
+3. Obsidian (Project: Authentication)
+4. GitHub Issue (#123)
+5. None - Skip logging
+
+Choose destination [1-5]: 
+```
+
+## Obsidian Integration
+
+### Daily Note Logging
+```
+/orchestration/log --obsidian-daily
+```
+Appends to today's daily note:
+
+```markdown
+## Work Log - 15:30
+
+### TASK-003: JWT Implementation ✅
+
+**Time Spent**: 4.5 hours (10:00 - 14:30)
+**Status**: Completed → QA
+
+**What I did:**
+- Implemented JWT token validation middleware
+- Added refresh token logic  
+- Created comprehensive test suite
+- Fixed edge case with token expiration
+
+**Code Stats:**
+- Files: 8 modified
+- Lines: +245 -23
+- Coverage: 95%
+
+**Related Tasks:**
+- Next: [[TASK-005]] - User Profile API
+- Blocked: [[TASK-007]] - Waiting for this
+
+**Commits:**
+- `abc123`: feat(auth): implement JWT validation
+- `def456`: test(auth): add validation tests
+
+#tasks/completed #project/authentication
+```
+
+### Project Note Logging
+```
+/orchestration/log --obsidian-project "Authentication System"
+```
+Creates or appends to project-specific note.
+
+### Custom Obsidian Location
+```
+/orchestration/log --obsidian-path "Projects/Sprint 24/Work Log"
+```
+
+## Linear Integration
+```
+/orchestration/log TASK-003 --linear-issue ENG-1234
+```
+Creates work log comment in Linear issue.
+
+## Smart Detection
+
+The system detects available destinations:
+
+```
+Analyzing task context...
+
+Found connections:
+✓ Linear: ENG-1234 (from branch name)
+✓ Obsidian: Project note exists
+✓ GitHub: No issue reference
+✗ Jira: Not connected
+
+Suggested: Linear ENG-1234
+Use suggestion? [Y/n/choose different]
+```
+
+## Work Log Formats
+
+### Obsidian Format
+```markdown
+## 📋 Task: TASK-003 - JWT Implementation
+
+### Summary
+- **Status**: 🟢 Completed  
+- **Duration**: 4h 30m
+- **Date**: 2024-03-15
+
+### Progress Details
+- [x] Token structure design
+- [x] Validation middleware
+- [x] Refresh mechanism
+- [x] Test coverage
+
+### Technical Notes
+- Used RS256 algorithm for signing
+- Tokens expire after 15 minutes
+- Refresh tokens last 7 days
+
+### Links
+- Linear: [ENG-1234](linear://issue/ENG-1234)
+- PR: [#456](github.com/...)
+- Docs: [[JWT Implementation Guide]]
+
+### Next Actions
+- [ ] Code review feedback
+- [ ] Deploy to staging
+- [ ] Update API documentation
+
+---
+*Logged via Task Orchestration at 15:30*
+```
+
+### Linear Format
+```
+Work log comment in Linear with task details, time tracking, and progress updates.
+```
+
+## Multiple Destination Logging
+
+```
+/orchestration/log TASK-003 --multi
+
+Select all destinations for logging:
+[x] Linear - ENG-1234
+[x] Obsidian - Daily Note
+[ ] Obsidian - Project Note
+[ ] GitHub - Create new issue
+
+Press Enter to confirm, Space to toggle
+```
+
+## Batch Operations
+
+### Daily Summary to Obsidian
+```
+/orchestration/log --daily-summary --obsidian
+
+Creates summary in daily note:
+
+## Work Summary - 2024-03-15
+
+### Completed Tasks
+- [[TASK-003]]: JWT Implementation (4.5h) ✅
+- [[TASK-008]]: Login UI Updates (2h) ✅
+
+### In Progress  
+- [[TASK-005]]: User Profile API (1.5h) 🔄
+
+### Total Time: 8 hours
+
+### Key Achievements
+- Authentication system core complete
+- All tests passing
+- Ready for code review
+
+### Tomorrow's Focus
+- Complete user profile endpoints
+- Start OAuth integration
+```
+
+### Weekly Report
+```
+/orchestration/log --weekly --obsidian-path "Weekly Reviews/Week 11"
+```
+
+## Templates
+
+### Configure Obsidian Template
+```yaml
+obsidian_template:
+  daily_note:
+    heading: "## Work Log - {time}"
+    include_stats: true
+    add_tags: true
+    link_tasks: true
+  
+  project_note:
+    create_if_missing: true
+    append_to_section: "## Task Progress"
+    include_commits: true
+```
+
+### Configure Linear Template
+```yaml
+linear_template:
+  include_time: true
+  update_status: true
+  add_labels: ["from-orchestration"]
+```
+
+## Interactive Mode
+
+```
+/orchestration/log --interactive
+
+Task: TASK-003 - JWT Implementation
+Status: Completed
+Time: 4.5 hours
+
+Where to log? (Space to select, Enter to confirm)
+> [x] Linear (ENG-1234)
+> [x] Obsidian Daily Note
+> [ ] Obsidian Project Note
+> [ ] New GitHub Issue
+
+Add custom notes? [y/N]: y
+> Implemented using RS256, ready for review
+
+Logging to 2 destinations...
+✓ Linear: Comment added to ENG-1234
+✓ Obsidian: Added to daily note
+
+View logs? [y/N]: 
+```
+
+## Examples
+
+### Example 1: End of Day Logging
+```
+/orchestration/log --eod
+
+End of Day Summary:
+- 3 tasks worked on
+- 7.5 hours logged
+- 2 completed, 1 in progress
+
+Log to:
+1. Obsidian Daily Note (recommended)
+2. Linear (update all 3 issues)
+3. Both
+4. Skip
+
+Choice [1]: 1
+
+✓ Daily work log created in Obsidian
+```
+
+### Example 2: Sprint Review
+```
+/orchestration/log --sprint-review --week 11
+
+Gathering week 11 data...
+- 15 tasks completed
+- 3 in progress
+- 52 hours logged
+
+Create sprint review in:
+1. Obsidian - "Sprint Reviews/Sprint 24"
+2. Linear - Sprint 24 cycle
+3. Both
+
+Choice [3]: 3
+
+✓ Sprint review created in both systems
+```
+
+### Example 3: No Connection Found
+```
+/orchestration/log TASK-009
+
+No automatic destination found for TASK-009.
+
+Where would you like to log this?
+1. Obsidian - Daily Note
+2. Obsidian - Create Project Note
+3. Linear - Search for issue
+4. GitHub - Create new issue  
+5. Skip logging
+
+Choice: 2
+
+Enter project name: Security Audit
+✓ Created "Security Audit" note with work log
+```
+
+## Configuration
+
+### Default Destinations
+```yaml
+log_defaults:
+  no_connection: "ask"  # ask|obsidian-daily|skip
+  multi_connection: "ask"  # ask|all|first
+  
+  obsidian:
+    default_location: "daily"  # daily|project|custom
+    project_folder: "Projects"
+    daily_folder: "Daily Notes"
+  
+  linear:
+    auto_update_status: true
+    include_commits: true
+```
+
+## Best Practices
+
+1. **Set Preferences**: Configure default destinations
+2. **Link Early**: Connect tasks to PM tools when creating
+3. **Use Daily Notes**: Great for personal tracking
+4. **Project Notes**: Better for team collaboration
+5. **Regular Syncs**: Don't let logs pile up
+
+## Notes
+
+- Respects MCP connections and permissions
+- Obsidian logs create backlinks automatically
+- Supports multiple simultaneous destinations
+- Preserves formatting across systems
+- Can be automated with task status changes