From b9299c5af0dc2d946e9b436e94c9c01627378013 Mon Sep 17 00:00:00 2001 From: neno Date: Sat, 21 Jun 2025 20:48:20 +0200 Subject: [PATCH] feat: Claude Code slash commands for Task Master (#774) * Fix Cursor deeplink installation with copy-paste instructions (#723) * fix: expand-task (#755) * docs: Update o3 model price (#751) * docs: Auto-update and format models.md * docs: Auto-update and format models.md * feat: Add Claude Code task master commands Adds Task Master slash commands for Claude Code under /project:tm/ namespace --------- Co-authored-by: Joe Danziger Co-authored-by: Ralph Khreish <35776126+Crunchyman-ralph@users.noreply.github.com> Co-authored-by: Volodymyr Zahorniak <7808206+zahorniak@users.noreply.github.com> Co-authored-by: github-actions[bot] Co-authored-by: neno-is-ooo <204701868+neno-is-ooo@users.noreply.github.com> --- .changeset/chatty-rats-talk.md | 5 + .changeset/large-wolves-strive.md | 5 + .changeset/nasty-chefs-add.md | 8 + .claude/TM_COMMANDS_GUIDE.md | 147 ++++++++++++++++++ .claude/commands/tm/add-dependency/index.md | 55 +++++++ .claude/commands/tm/add-subtask/from-task.md | 71 +++++++++ .claude/commands/tm/add-subtask/index.md | 76 +++++++++ .claude/commands/tm/add-task/index.md | 78 ++++++++++ .../commands/tm/analyze-complexity/index.md | 121 ++++++++++++++ .claude/commands/tm/clear-subtasks/all.md | 93 +++++++++++ .claude/commands/tm/clear-subtasks/index.md | 86 ++++++++++ .../commands/tm/complexity-report/index.md | 117 ++++++++++++++ .claude/commands/tm/expand/all.md | 51 ++++++ .claude/commands/tm/expand/index.md | 49 ++++++ .claude/commands/tm/fix-dependencies/index.md | 81 ++++++++++ .claude/commands/tm/generate/index.md | 121 ++++++++++++++ .claude/commands/tm/help.md | 81 ++++++++++ .claude/commands/tm/index.md | 130 ++++++++++++++++ .claude/commands/tm/init/index.md | 50 ++++++ .claude/commands/tm/init/quick.md | 46 ++++++ .claude/commands/tm/learn.md | 103 ++++++++++++ .claude/commands/tm/list/by-status.md | 39 +++++ .claude/commands/tm/list/index.md | 43 +++++ .claude/commands/tm/list/with-subtasks.md | 29 ++++ .claude/commands/tm/models/index.md | 51 ++++++ .claude/commands/tm/models/setup.md | 51 ++++++ .claude/commands/tm/next/index.md | 66 ++++++++ .claude/commands/tm/parse-prd/index.md | 49 ++++++ .../commands/tm/parse-prd/with-research.md | 48 ++++++ .../commands/tm/remove-dependency/index.md | 62 ++++++++ .claude/commands/tm/remove-subtask/index.md | 84 ++++++++++ .claude/commands/tm/remove-task/index.md | 107 +++++++++++++ .../commands/tm/set-status/to-cancelled.md | 55 +++++++ .claude/commands/tm/set-status/to-deferred.md | 47 ++++++ .claude/commands/tm/set-status/to-done.md | 44 ++++++ .../commands/tm/set-status/to-in-progress.md | 36 +++++ .claude/commands/tm/set-status/to-pending.md | 32 ++++ .claude/commands/tm/set-status/to-review.md | 40 +++++ .claude/commands/tm/setup/install.md | 117 ++++++++++++++ .claude/commands/tm/setup/quick-install.md | 22 +++ .claude/commands/tm/show/index.md | 82 ++++++++++ .claude/commands/tm/status/index.md | 64 ++++++++ .claude/commands/tm/sync-readme/index.md | 117 ++++++++++++++ .claude/commands/tm/update/from-id.md | 108 +++++++++++++ .claude/commands/tm/update/index.md | 72 +++++++++ .claude/commands/tm/update/single.md | 119 ++++++++++++++ .claude/commands/tm/utils/analyze.md | 97 ++++++++++++ .../tm/validate-dependencies/index.md | 71 +++++++++ .../commands/tm/workflows/auto-implement.md | 97 ++++++++++++ .claude/commands/tm/workflows/pipeline.md | 77 +++++++++ .claude/commands/tm/workflows/smart-flow.md | 55 +++++++ 51 files changed, 3555 insertions(+) create mode 100644 .changeset/chatty-rats-talk.md create mode 100644 .changeset/large-wolves-strive.md create mode 100644 .changeset/nasty-chefs-add.md create mode 100644 .claude/TM_COMMANDS_GUIDE.md create mode 100644 .claude/commands/tm/add-dependency/index.md create mode 100644 .claude/commands/tm/add-subtask/from-task.md create mode 100644 .claude/commands/tm/add-subtask/index.md create mode 100644 .claude/commands/tm/add-task/index.md create mode 100644 .claude/commands/tm/analyze-complexity/index.md create mode 100644 .claude/commands/tm/clear-subtasks/all.md create mode 100644 .claude/commands/tm/clear-subtasks/index.md create mode 100644 .claude/commands/tm/complexity-report/index.md create mode 100644 .claude/commands/tm/expand/all.md create mode 100644 .claude/commands/tm/expand/index.md create mode 100644 .claude/commands/tm/fix-dependencies/index.md create mode 100644 .claude/commands/tm/generate/index.md create mode 100644 .claude/commands/tm/help.md create mode 100644 .claude/commands/tm/index.md create mode 100644 .claude/commands/tm/init/index.md create mode 100644 .claude/commands/tm/init/quick.md create mode 100644 .claude/commands/tm/learn.md create mode 100644 .claude/commands/tm/list/by-status.md create mode 100644 .claude/commands/tm/list/index.md create mode 100644 .claude/commands/tm/list/with-subtasks.md create mode 100644 .claude/commands/tm/models/index.md create mode 100644 .claude/commands/tm/models/setup.md create mode 100644 .claude/commands/tm/next/index.md create mode 100644 .claude/commands/tm/parse-prd/index.md create mode 100644 .claude/commands/tm/parse-prd/with-research.md create mode 100644 .claude/commands/tm/remove-dependency/index.md create mode 100644 .claude/commands/tm/remove-subtask/index.md create mode 100644 .claude/commands/tm/remove-task/index.md create mode 100644 .claude/commands/tm/set-status/to-cancelled.md create mode 100644 .claude/commands/tm/set-status/to-deferred.md create mode 100644 .claude/commands/tm/set-status/to-done.md create mode 100644 .claude/commands/tm/set-status/to-in-progress.md create mode 100644 .claude/commands/tm/set-status/to-pending.md create mode 100644 .claude/commands/tm/set-status/to-review.md create mode 100644 .claude/commands/tm/setup/install.md create mode 100644 .claude/commands/tm/setup/quick-install.md create mode 100644 .claude/commands/tm/show/index.md create mode 100644 .claude/commands/tm/status/index.md create mode 100644 .claude/commands/tm/sync-readme/index.md create mode 100644 .claude/commands/tm/update/from-id.md create mode 100644 .claude/commands/tm/update/index.md create mode 100644 .claude/commands/tm/update/single.md create mode 100644 .claude/commands/tm/utils/analyze.md create mode 100644 .claude/commands/tm/validate-dependencies/index.md create mode 100644 .claude/commands/tm/workflows/auto-implement.md create mode 100644 .claude/commands/tm/workflows/pipeline.md create mode 100644 .claude/commands/tm/workflows/smart-flow.md diff --git a/.changeset/chatty-rats-talk.md b/.changeset/chatty-rats-talk.md new file mode 100644 index 00000000..6a6e7ad5 --- /dev/null +++ b/.changeset/chatty-rats-talk.md @@ -0,0 +1,5 @@ +--- +"task-master-ai": patch +--- + +Fix Cursor deeplink installation by providing copy-paste instructions for GitHub compatibility diff --git a/.changeset/large-wolves-strive.md b/.changeset/large-wolves-strive.md new file mode 100644 index 00000000..f170b09a --- /dev/null +++ b/.changeset/large-wolves-strive.md @@ -0,0 +1,5 @@ +--- +"task-master-ai": patch +--- + +Update o3 model price diff --git a/.changeset/nasty-chefs-add.md b/.changeset/nasty-chefs-add.md new file mode 100644 index 00000000..304aeb24 --- /dev/null +++ b/.changeset/nasty-chefs-add.md @@ -0,0 +1,8 @@ +--- +"task-master-ai": patch +--- + +Fixes issue with expand CLI command "Complexity report not found" + +- Closes #735 +- Closes #728 diff --git a/.claude/TM_COMMANDS_GUIDE.md b/.claude/TM_COMMANDS_GUIDE.md new file mode 100644 index 00000000..c88bcb1c --- /dev/null +++ b/.claude/TM_COMMANDS_GUIDE.md @@ -0,0 +1,147 @@ +# Task Master Commands for Claude Code + +Complete guide to using Task Master through Claude Code's slash commands. + +## Overview + +All Task Master functionality is available through the `/project:tm/` namespace with natural language support and intelligent features. + +## Quick Start + +```bash +# Install Task Master +/project:tm/setup/quick-install + +# Initialize project +/project:tm/init/quick + +# Parse requirements +/project:tm/parse-prd requirements.md + +# Start working +/project:tm/next +``` + +## Command Structure + +Commands are organized hierarchically to match Task Master's CLI: +- Main commands at `/project:tm/[command]` +- Subcommands for specific operations `/project:tm/[command]/[subcommand]` +- Natural language arguments accepted throughout + +## Complete Command Reference + +### Setup & Configuration +- `/project:tm/setup/install` - Full installation guide +- `/project:tm/setup/quick-install` - One-line install +- `/project:tm/init` - Initialize project +- `/project:tm/init/quick` - Quick init with -y +- `/project:tm/models` - View AI config +- `/project:tm/models/setup` - Configure AI + +### Task Generation +- `/project:tm/parse-prd` - Generate from PRD +- `/project:tm/parse-prd/with-research` - Enhanced parsing +- `/project:tm/generate` - Create task files + +### Task Management +- `/project:tm/list` - List with natural language filters +- `/project:tm/list/with-subtasks` - Hierarchical view +- `/project:tm/list/by-status ` - Filter by status +- `/project:tm/show ` - Task details +- `/project:tm/add-task` - Create task +- `/project:tm/update` - Update tasks +- `/project:tm/remove-task` - Delete task + +### Status Management +- `/project:tm/set-status/to-pending ` +- `/project:tm/set-status/to-in-progress ` +- `/project:tm/set-status/to-done ` +- `/project:tm/set-status/to-review ` +- `/project:tm/set-status/to-deferred ` +- `/project:tm/set-status/to-cancelled ` + +### Task Analysis +- `/project:tm/analyze-complexity` - AI analysis +- `/project:tm/complexity-report` - View report +- `/project:tm/expand ` - Break down task +- `/project:tm/expand/all` - Expand all complex + +### Dependencies +- `/project:tm/add-dependency` - Add dependency +- `/project:tm/remove-dependency` - Remove dependency +- `/project:tm/validate-dependencies` - Check issues +- `/project:tm/fix-dependencies` - Auto-fix + +### Workflows +- `/project:tm/workflows/smart-flow` - Adaptive workflows +- `/project:tm/workflows/pipeline` - Chain commands +- `/project:tm/workflows/auto-implement` - AI implementation + +### Utilities +- `/project:tm/status` - Project dashboard +- `/project:tm/next` - Next task recommendation +- `/project:tm/utils/analyze` - Project analysis +- `/project:tm/learn` - Interactive help + +## Key Features + +### Natural Language Support +All commands understand natural language: +``` +/project:tm/list pending high priority +/project:tm/update mark 23 as done +/project:tm/add-task implement OAuth login +``` + +### Smart Context +Commands analyze project state and provide intelligent suggestions based on: +- Current task status +- Dependencies +- Team patterns +- Project phase + +### Visual Enhancements +- Progress bars and indicators +- Status badges +- Organized displays +- Clear hierarchies + +## Common Workflows + +### Daily Development +``` +/project:tm/workflows/smart-flow morning +/project:tm/next +/project:tm/set-status/to-in-progress +/project:tm/set-status/to-done +``` + +### Task Breakdown +``` +/project:tm/show +/project:tm/expand +/project:tm/list/with-subtasks +``` + +### Sprint Planning +``` +/project:tm/analyze-complexity +/project:tm/workflows/pipeline init → expand/all → status +``` + +## Migration from Old Commands + +| Old | New | +|-----|-----| +| `/project:task-master:list` | `/project:tm/list` | +| `/project:task-master:complete` | `/project:tm/set-status/to-done` | +| `/project:workflows:auto-implement` | `/project:tm/workflows/auto-implement` | + +## Tips + +1. Use `/project:tm/` + Tab for command discovery +2. Natural language is supported everywhere +3. Commands provide smart defaults +4. Chain commands for automation +5. Check `/project:tm/learn` for interactive help \ No newline at end of file diff --git a/.claude/commands/tm/add-dependency/index.md b/.claude/commands/tm/add-dependency/index.md new file mode 100644 index 00000000..78e91546 --- /dev/null +++ b/.claude/commands/tm/add-dependency/index.md @@ -0,0 +1,55 @@ +Add a dependency between tasks. + +Arguments: $ARGUMENTS + +Parse the task IDs to establish dependency relationship. + +## Adding Dependencies + +Creates a dependency where one task must be completed before another can start. + +## Argument Parsing + +Parse natural language or IDs: +- "make 5 depend on 3" → task 5 depends on task 3 +- "5 needs 3" → task 5 depends on task 3 +- "5 3" → task 5 depends on task 3 +- "5 after 3" → task 5 depends on task 3 + +## Execution + +```bash +task-master add-dependency --id= --depends-on= +``` + +## Validation + +Before adding: +1. **Verify both tasks exist** +2. **Check for circular dependencies** +3. **Ensure dependency makes logical sense** +4. **Warn if creating complex chains** + +## Smart Features + +- Detect if dependency already exists +- Suggest related dependencies +- Show impact on task flow +- Update task priorities if needed + +## Post-Addition + +After adding dependency: +1. Show updated dependency graph +2. Identify any newly blocked tasks +3. Suggest task order changes +4. Update project timeline + +## Example Flows + +``` +/project:tm/add-dependency 5 needs 3 +→ Task #5 now depends on Task #3 +→ Task #5 is now blocked until #3 completes +→ Suggested: Also consider if #5 needs #4 +``` \ No newline at end of file diff --git a/.claude/commands/tm/add-subtask/from-task.md b/.claude/commands/tm/add-subtask/from-task.md new file mode 100644 index 00000000..ab20730f --- /dev/null +++ b/.claude/commands/tm/add-subtask/from-task.md @@ -0,0 +1,71 @@ +Convert an existing task into a subtask. + +Arguments: $ARGUMENTS + +Parse parent ID and task ID to convert. + +## Task Conversion + +Converts an existing standalone task into a subtask of another task. + +## Argument Parsing + +- "move task 8 under 5" +- "make 8 a subtask of 5" +- "nest 8 in 5" +- "5 8" → make task 8 a subtask of task 5 + +## Execution + +```bash +task-master add-subtask --parent= --task-id= +``` + +## Pre-Conversion Checks + +1. **Validation** + - Both tasks exist and are valid + - No circular parent relationships + - Task isn't already a subtask + - Logical hierarchy makes sense + +2. **Impact Analysis** + - Dependencies that will be affected + - Tasks that depend on converting task + - Priority alignment needed + - Status compatibility + +## Conversion Process + +1. Change task ID from "8" to "5.1" (next available) +2. Update all dependency references +3. Inherit parent's context where appropriate +4. Adjust priorities if needed +5. Update time estimates + +## Smart Features + +- Preserve task history +- Maintain dependencies +- Update all references +- Create conversion log + +## Example + +``` +/project:tm/add-subtask/from-task 5 8 +→ Converting: Task #8 becomes subtask #5.1 +→ Updated: 3 dependency references +→ Parent task #5 now has 1 subtask +→ Note: Subtask inherits parent's priority + +Before: #8 "Implement validation" (standalone) +After: #5.1 "Implement validation" (subtask of #5) +``` + +## Post-Conversion + +- Show new task hierarchy +- List updated dependencies +- Verify project integrity +- Suggest related conversions \ No newline at end of file diff --git a/.claude/commands/tm/add-subtask/index.md b/.claude/commands/tm/add-subtask/index.md new file mode 100644 index 00000000..d909dd5d --- /dev/null +++ b/.claude/commands/tm/add-subtask/index.md @@ -0,0 +1,76 @@ +Add a subtask to a parent task. + +Arguments: $ARGUMENTS + +Parse arguments to create a new subtask or convert existing task. + +## Adding Subtasks + +Creates subtasks to break down complex parent tasks into manageable pieces. + +## Argument Parsing + +Flexible natural language: +- "add subtask to 5: implement login form" +- "break down 5 with: setup, implement, test" +- "subtask for 5: handle edge cases" +- "5: validate user input" → adds subtask to task 5 + +## Execution Modes + +### 1. Create New Subtask +```bash +task-master add-subtask --parent= --title="" --description="<desc>" +``` + +### 2. Convert Existing Task +```bash +task-master add-subtask --parent=<id> --task-id=<existing-id> +``` + +## Smart Features + +1. **Automatic Subtask Generation** + - If title contains "and" or commas, create multiple + - Suggest common subtask patterns + - Inherit parent's context + +2. **Intelligent Defaults** + - Priority based on parent + - Appropriate time estimates + - Logical dependencies between subtasks + +3. **Validation** + - Check parent task complexity + - Warn if too many subtasks + - Ensure subtask makes sense + +## Creation Process + +1. Parse parent task context +2. Generate subtask with ID like "5.1" +3. Set appropriate defaults +4. Link to parent task +5. Update parent's time estimate + +## Example Flows + +``` +/project:tm/add-subtask to 5: implement user authentication +→ Created subtask #5.1: "implement user authentication" +→ Parent task #5 now has 1 subtask +→ Suggested next subtasks: tests, documentation + +/project:tm/add-subtask 5: setup, implement, test +→ Created 3 subtasks: + #5.1: setup + #5.2: implement + #5.3: test +``` + +## Post-Creation + +- Show updated task hierarchy +- Suggest logical next subtasks +- Update complexity estimates +- Recommend subtask order \ No newline at end of file diff --git a/.claude/commands/tm/add-task/index.md b/.claude/commands/tm/add-task/index.md new file mode 100644 index 00000000..0c1c09c3 --- /dev/null +++ b/.claude/commands/tm/add-task/index.md @@ -0,0 +1,78 @@ +Add new tasks with intelligent parsing and context awareness. + +Arguments: $ARGUMENTS + +## Smart Task Addition + +Parse natural language to create well-structured tasks. + +### 1. **Input Understanding** + +I'll intelligently parse your request: +- Natural language → Structured task +- Detect priority from keywords (urgent, ASAP, important) +- Infer dependencies from context +- Suggest complexity based on description +- Determine task type (feature, bug, refactor, test, docs) + +### 2. **Smart Parsing Examples** + +**"Add urgent task to fix login bug"** +→ Title: Fix login bug +→ Priority: high +→ Type: bug +→ Suggested complexity: medium + +**"Create task for API documentation after task 23 is done"** +→ Title: API documentation +→ Dependencies: [23] +→ Type: documentation +→ Priority: medium + +**"Need to refactor auth module - depends on 12 and 15, high complexity"** +→ Title: Refactor auth module +→ Dependencies: [12, 15] +→ Complexity: high +→ Type: refactor + +### 3. **Context Enhancement** + +Based on current project state: +- Suggest related existing tasks +- Warn about potential conflicts +- Recommend dependencies +- Propose subtasks if complex + +### 4. **Interactive Refinement** + +```yaml +Task Preview: +───────────── +Title: [Extracted title] +Priority: [Inferred priority] +Dependencies: [Detected dependencies] +Complexity: [Estimated complexity] + +Suggestions: +- Similar task #34 exists, consider as dependency? +- This seems complex, break into subtasks? +- Tasks #45-47 work on same module +``` + +### 5. **Validation & Creation** + +Before creating: +- Validate dependencies exist +- Check for duplicates +- Ensure logical ordering +- Verify task completeness + +### 6. **Smart Defaults** + +Intelligent defaults based on: +- Task type patterns +- Team conventions +- Historical data +- Current sprint/phase + +Result: High-quality tasks from minimal input. \ No newline at end of file diff --git a/.claude/commands/tm/analyze-complexity/index.md b/.claude/commands/tm/analyze-complexity/index.md new file mode 100644 index 00000000..807f4b12 --- /dev/null +++ b/.claude/commands/tm/analyze-complexity/index.md @@ -0,0 +1,121 @@ +Analyze task complexity and generate expansion recommendations. + +Arguments: $ARGUMENTS + +Perform deep analysis of task complexity across the project. + +## Complexity Analysis + +Uses AI to analyze tasks and recommend which ones need breakdown. + +## Execution Options + +```bash +task-master analyze-complexity [--research] [--threshold=5] +``` + +## Analysis Parameters + +- `--research` → Use research AI for deeper analysis +- `--threshold=5` → Only flag tasks above complexity 5 +- Default: Analyze all pending tasks + +## Analysis Process + +### 1. **Task Evaluation** +For each task, AI evaluates: +- Technical complexity +- Time requirements +- Dependency complexity +- Risk factors +- Knowledge requirements + +### 2. **Complexity Scoring** +Assigns score 1-10 based on: +- Implementation difficulty +- Integration challenges +- Testing requirements +- Unknown factors +- Technical debt risk + +### 3. **Recommendations** +For complex tasks: +- Suggest expansion approach +- Recommend subtask breakdown +- Identify risk areas +- Propose mitigation strategies + +## Smart Analysis Features + +1. **Pattern Recognition** + - Similar task comparisons + - Historical complexity accuracy + - Team velocity consideration + - Technology stack factors + +2. **Contextual Factors** + - Team expertise + - Available resources + - Timeline constraints + - Business criticality + +3. **Risk Assessment** + - Technical risks + - Timeline risks + - Dependency risks + - Knowledge gaps + +## Output Format + +``` +Task Complexity Analysis Report +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +High Complexity Tasks (>7): +📍 #5 "Implement real-time sync" - Score: 9/10 + Factors: WebSocket complexity, state management, conflict resolution + Recommendation: Expand into 5-7 subtasks + Risks: Performance, data consistency + +📍 #12 "Migrate database schema" - Score: 8/10 + Factors: Data migration, zero downtime, rollback strategy + Recommendation: Expand into 4-5 subtasks + Risks: Data loss, downtime + +Medium Complexity Tasks (5-7): +📍 #23 "Add export functionality" - Score: 6/10 + Consider expansion if timeline tight + +Low Complexity Tasks (<5): +✅ 15 tasks - No expansion needed + +Summary: +- Expand immediately: 2 tasks +- Consider expanding: 5 tasks +- Keep as-is: 15 tasks +``` + +## Actionable Output + +For each high-complexity task: +1. Complexity score with reasoning +2. Specific expansion suggestions +3. Risk mitigation approaches +4. Recommended subtask structure + +## Integration + +Results are: +- Saved to `.taskmaster/reports/complexity-analysis.md` +- Used by expand command +- Inform sprint planning +- Guide resource allocation + +## Next Steps + +After analysis: +``` +/project:tm/expand 5 # Expand specific task +/project:tm/expand/all # Expand all recommended +/project:tm/complexity-report # View detailed report +``` \ No newline at end of file diff --git a/.claude/commands/tm/clear-subtasks/all.md b/.claude/commands/tm/clear-subtasks/all.md new file mode 100644 index 00000000..6cd54d7d --- /dev/null +++ b/.claude/commands/tm/clear-subtasks/all.md @@ -0,0 +1,93 @@ +Clear all subtasks from all tasks globally. + +## Global Subtask Clearing + +Remove all subtasks across the entire project. Use with extreme caution. + +## Execution + +```bash +task-master clear-subtasks --all +``` + +## Pre-Clear Analysis + +1. **Project-Wide Summary** + ``` + Global Subtask Summary + ━━━━━━━━━━━━━━━━━━━━ + Total parent tasks: 12 + Total subtasks: 47 + - Completed: 15 + - In-progress: 8 + - Pending: 24 + + Work at risk: ~120 hours + ``` + +2. **Critical Warnings** + - In-progress subtasks that will lose work + - Completed subtasks with valuable history + - Complex dependency chains + - Integration test results + +## Double Confirmation + +``` +⚠️ DESTRUCTIVE OPERATION WARNING ⚠️ +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +This will remove ALL 47 subtasks from your project +Including 8 in-progress and 15 completed subtasks + +This action CANNOT be undone + +Type 'CLEAR ALL SUBTASKS' to confirm: +``` + +## Smart Safeguards + +- Require explicit confirmation phrase +- Create automatic backup +- Log all removed data +- Option to export first + +## Use Cases + +Valid reasons for global clear: +- Project restructuring +- Major pivot in approach +- Starting fresh breakdown +- Switching to different task organization + +## Process + +1. Full project analysis +2. Create backup file +3. Show detailed impact +4. Require confirmation +5. Execute removal +6. Generate summary report + +## Alternative Suggestions + +Before clearing all: +- Export subtasks to file +- Clear only pending subtasks +- Clear by task category +- Archive instead of delete + +## Post-Clear Report + +``` +Global Subtask Clear Complete +━━━━━━━━━━━━━━━━━━━━━━━━━━━ +Removed: 47 subtasks from 12 tasks +Backup saved: .taskmaster/backup/subtasks-20240115.json +Parent tasks updated: 12 +Time estimates adjusted: Yes + +Next steps: +- Review updated task list +- Re-expand complex tasks as needed +- Check project timeline +``` \ No newline at end of file diff --git a/.claude/commands/tm/clear-subtasks/index.md b/.claude/commands/tm/clear-subtasks/index.md new file mode 100644 index 00000000..877ceb8c --- /dev/null +++ b/.claude/commands/tm/clear-subtasks/index.md @@ -0,0 +1,86 @@ +Clear all subtasks from a specific task. + +Arguments: $ARGUMENTS (task ID) + +Remove all subtasks from a parent task at once. + +## Clearing Subtasks + +Bulk removal of all subtasks from a parent task. + +## Execution + +```bash +task-master clear-subtasks --id=<task-id> +``` + +## Pre-Clear Analysis + +1. **Subtask Summary** + - Number of subtasks + - Completion status of each + - Work already done + - Dependencies affected + +2. **Impact Assessment** + - Data that will be lost + - Dependencies to be removed + - Effect on project timeline + - Parent task implications + +## Confirmation Required + +``` +Clear Subtasks Confirmation +━━━━━━━━━━━━━━━━━━━━━━━━━ +Parent Task: #5 "Implement user authentication" +Subtasks to remove: 4 +- #5.1 "Setup auth framework" (done) +- #5.2 "Create login form" (in-progress) +- #5.3 "Add validation" (pending) +- #5.4 "Write tests" (pending) + +⚠️ This will permanently delete all subtask data +Continue? (y/n) +``` + +## Smart Features + +- Option to convert to standalone tasks +- Backup task data before clearing +- Preserve completed work history +- Update parent task appropriately + +## Process + +1. List all subtasks for confirmation +2. Check for in-progress work +3. Remove all subtasks +4. Update parent task +5. Clean up dependencies + +## Alternative Options + +Suggest alternatives: +- Convert important subtasks to tasks +- Keep completed subtasks +- Archive instead of delete +- Export subtask data first + +## Post-Clear + +- Show updated parent task +- Recalculate time estimates +- Update task complexity +- Suggest next steps + +## Example + +``` +/project:tm/clear-subtasks 5 +→ Found 4 subtasks to remove +→ Warning: Subtask #5.2 is in-progress +→ Cleared all subtasks from task #5 +→ Updated parent task estimates +→ Suggestion: Consider re-expanding with better breakdown +``` \ No newline at end of file diff --git a/.claude/commands/tm/complexity-report/index.md b/.claude/commands/tm/complexity-report/index.md new file mode 100644 index 00000000..16d2d11d --- /dev/null +++ b/.claude/commands/tm/complexity-report/index.md @@ -0,0 +1,117 @@ +Display the task complexity analysis report. + +Arguments: $ARGUMENTS + +View the detailed complexity analysis generated by analyze-complexity command. + +## Viewing Complexity Report + +Shows comprehensive task complexity analysis with actionable insights. + +## Execution + +```bash +task-master complexity-report [--file=<path>] +``` + +## Report Location + +Default: `.taskmaster/reports/complexity-analysis.md` +Custom: Specify with --file parameter + +## Report Contents + +### 1. **Executive Summary** +``` +Complexity Analysis Summary +━━━━━━━━━━━━━━━━━━━━━━━━ +Analysis Date: 2024-01-15 +Tasks Analyzed: 32 +High Complexity: 5 (16%) +Medium Complexity: 12 (37%) +Low Complexity: 15 (47%) + +Critical Findings: +- 5 tasks need immediate expansion +- 3 tasks have high technical risk +- 2 tasks block critical path +``` + +### 2. **Detailed Task Analysis** +For each complex task: +- Complexity score breakdown +- Contributing factors +- Specific risks identified +- Expansion recommendations +- Similar completed tasks + +### 3. **Risk Matrix** +Visual representation: +``` +Risk vs Complexity Matrix +━━━━━━━━━━━━━━━━━━━━━━━ +High Risk | #5(9) #12(8) | #23(6) +Med Risk | #34(7) | #45(5) #67(5) +Low Risk | #78(8) | [15 tasks] + | High Complex | Med Complex +``` + +### 4. **Recommendations** + +**Immediate Actions:** +1. Expand task #5 - Critical path + high complexity +2. Expand task #12 - High risk + dependencies +3. Review task #34 - Consider splitting + +**Sprint Planning:** +- Don't schedule multiple high-complexity tasks together +- Ensure expertise available for complex tasks +- Build in buffer time for unknowns + +## Interactive Features + +When viewing report: +1. **Quick Actions** + - Press 'e' to expand a task + - Press 'd' for task details + - Press 'r' to refresh analysis + +2. **Filtering** + - View by complexity level + - Filter by risk factors + - Show only actionable items + +3. **Export Options** + - Markdown format + - CSV for spreadsheets + - JSON for tools + +## Report Intelligence + +- Compares with historical data +- Shows complexity trends +- Identifies patterns +- Suggests process improvements + +## Integration + +Use report for: +- Sprint planning sessions +- Resource allocation +- Risk assessment +- Team discussions +- Client updates + +## Example Usage + +``` +/project:tm/complexity-report +→ Opens latest analysis + +/project:tm/complexity-report --file=archived/2024-01-01.md +→ View historical analysis + +After viewing: +/project:tm/expand 5 +→ Expand high-complexity task +``` \ No newline at end of file diff --git a/.claude/commands/tm/expand/all.md b/.claude/commands/tm/expand/all.md new file mode 100644 index 00000000..ec87789d --- /dev/null +++ b/.claude/commands/tm/expand/all.md @@ -0,0 +1,51 @@ +Expand all pending tasks that need subtasks. + +## Bulk Task Expansion + +Intelligently expands all tasks that would benefit from breakdown. + +## Execution + +```bash +task-master expand --all +``` + +## Smart Selection + +Only expands tasks that: +- Are marked as pending +- Have high complexity (>5) +- Lack existing subtasks +- Would benefit from breakdown + +## Expansion Process + +1. **Analysis Phase** + - Identify expansion candidates + - Group related tasks + - Plan expansion strategy + +2. **Batch Processing** + - Expand tasks in logical order + - Maintain consistency + - Preserve relationships + - Optimize for parallelism + +3. **Quality Control** + - Ensure subtask quality + - Avoid over-decomposition + - Maintain task coherence + - Update dependencies + +## Options + +- Add `force` to expand all regardless of complexity +- Add `research` for enhanced AI analysis + +## Results + +After bulk expansion: +- Summary of tasks expanded +- New subtask count +- Updated complexity metrics +- Suggested task order \ No newline at end of file diff --git a/.claude/commands/tm/expand/index.md b/.claude/commands/tm/expand/index.md new file mode 100644 index 00000000..78555b98 --- /dev/null +++ b/.claude/commands/tm/expand/index.md @@ -0,0 +1,49 @@ +Break down a complex task into subtasks. + +Arguments: $ARGUMENTS (task ID) + +## Intelligent Task Expansion + +Analyzes a task and creates detailed subtasks for better manageability. + +## Execution + +```bash +task-master expand --id=$ARGUMENTS +``` + +## Expansion Process + +1. **Task Analysis** + - Review task complexity + - Identify components + - Detect technical challenges + - Estimate time requirements + +2. **Subtask Generation** + - Create 3-7 subtasks typically + - Each subtask 1-4 hours + - Logical implementation order + - Clear acceptance criteria + +3. **Smart Breakdown** + - Setup/configuration tasks + - Core implementation + - Testing components + - Integration steps + - Documentation updates + +## Enhanced Features + +Based on task type: +- **Feature**: Setup → Implement → Test → Integrate +- **Bug Fix**: Reproduce → Diagnose → Fix → Verify +- **Refactor**: Analyze → Plan → Refactor → Validate + +## Post-Expansion + +After expansion: +1. Show subtask hierarchy +2. Update time estimates +3. Suggest implementation order +4. Highlight critical path \ No newline at end of file diff --git a/.claude/commands/tm/fix-dependencies/index.md b/.claude/commands/tm/fix-dependencies/index.md new file mode 100644 index 00000000..9fa857ca --- /dev/null +++ b/.claude/commands/tm/fix-dependencies/index.md @@ -0,0 +1,81 @@ +Automatically fix dependency issues found during validation. + +## Automatic Dependency Repair + +Intelligently fixes common dependency problems while preserving project logic. + +## Execution + +```bash +task-master fix-dependencies +``` + +## What Gets Fixed + +### 1. **Auto-Fixable Issues** +- Remove references to deleted tasks +- Break simple circular dependencies +- Remove self-dependencies +- Clean up duplicate dependencies + +### 2. **Smart Resolutions** +- Reorder dependencies to maintain logic +- Suggest task merging for over-dependent tasks +- Flatten unnecessary dependency chains +- Remove redundant transitive dependencies + +### 3. **Manual Review Required** +- Complex circular dependencies +- Critical path modifications +- Business logic dependencies +- High-impact changes + +## Fix Process + +1. **Analysis Phase** + - Run validation check + - Categorize issues by type + - Determine fix strategy + +2. **Execution Phase** + - Apply automatic fixes + - Log all changes made + - Preserve task relationships + +3. **Verification Phase** + - Re-validate after fixes + - Show before/after comparison + - Highlight manual fixes needed + +## Smart Features + +- Preserves intended task flow +- Minimal disruption approach +- Creates fix history/log +- Suggests manual interventions + +## Output Example + +``` +Dependency Auto-Fix Report +━━━━━━━━━━━━━━━━━━━━━━━━ +Fixed Automatically: +✅ Removed 2 references to deleted tasks +✅ Resolved 1 self-dependency +✅ Cleaned 3 redundant dependencies + +Manual Review Needed: +⚠️ Complex circular dependency: #12 → #15 → #18 → #12 + Suggestion: Make #15 not depend on #12 +⚠️ Task #45 has 8 dependencies + Suggestion: Break into subtasks + +Run '/project:tm/validate-dependencies' to verify fixes +``` + +## Safety + +- Preview mode available +- Rollback capability +- Change logging +- No data loss \ No newline at end of file diff --git a/.claude/commands/tm/generate/index.md b/.claude/commands/tm/generate/index.md new file mode 100644 index 00000000..01140d75 --- /dev/null +++ b/.claude/commands/tm/generate/index.md @@ -0,0 +1,121 @@ +Generate individual task files from tasks.json. + +## Task File Generation + +Creates separate markdown files for each task, perfect for AI agents or documentation. + +## Execution + +```bash +task-master generate +``` + +## What It Creates + +For each task, generates a file like `task_001.txt`: + +``` +Task ID: 1 +Title: Implement user authentication +Status: pending +Priority: high +Dependencies: [] +Created: 2024-01-15 +Complexity: 7 + +## Description +Create a secure user authentication system with login, logout, and session management. + +## Details +- Use JWT tokens for session management +- Implement secure password hashing +- Add remember me functionality +- Include password reset flow + +## Test Strategy +- Unit tests for auth functions +- Integration tests for login flow +- Security testing for vulnerabilities +- Performance tests for concurrent logins + +## Subtasks +1.1 Setup authentication framework (pending) +1.2 Create login endpoints (pending) +1.3 Implement session management (pending) +1.4 Add password reset (pending) +``` + +## File Organization + +Creates structure: +``` +.taskmaster/ +└── tasks/ + ├── task_001.txt + ├── task_002.txt + ├── task_003.txt + └── ... +``` + +## Smart Features + +1. **Consistent Formatting** + - Standardized structure + - Clear sections + - AI-readable format + - Markdown compatible + +2. **Contextual Information** + - Full task details + - Related task references + - Progress indicators + - Implementation notes + +3. **Incremental Updates** + - Only regenerate changed tasks + - Preserve custom additions + - Track generation timestamp + - Version control friendly + +## Use Cases + +- **AI Context**: Provide task context to AI assistants +- **Documentation**: Standalone task documentation +- **Archival**: Task history preservation +- **Sharing**: Send specific tasks to team members +- **Review**: Easier task review process + +## Generation Options + +Based on arguments: +- Filter by status +- Include/exclude completed +- Custom templates +- Different formats + +## Post-Generation + +``` +Task File Generation Complete +━━━━━━━━━━━━━━━━━━━━━━━━━━ +Generated: 45 task files +Location: .taskmaster/tasks/ +Total size: 156 KB + +New files: 5 +Updated files: 12 +Unchanged: 28 + +Ready for: +- AI agent consumption +- Version control +- Team distribution +``` + +## Integration Benefits + +- Git-trackable task history +- Easy task sharing +- AI tool compatibility +- Offline task access +- Backup redundancy \ No newline at end of file diff --git a/.claude/commands/tm/help.md b/.claude/commands/tm/help.md new file mode 100644 index 00000000..d68df206 --- /dev/null +++ b/.claude/commands/tm/help.md @@ -0,0 +1,81 @@ +Show help for Task Master commands. + +Arguments: $ARGUMENTS + +Display help for Task Master commands. If arguments provided, show specific command help. + +## Task Master Command Help + +### Quick Navigation + +Type `/project:tm/` and use tab completion to explore all commands. + +### Command Categories + +#### 🚀 Setup & Installation +- `/project:tm/setup/install` - Comprehensive installation guide +- `/project:tm/setup/quick-install` - One-line global install + +#### 📋 Project Setup +- `/project:tm/init` - Initialize new project +- `/project:tm/init/quick` - Quick setup with auto-confirm +- `/project:tm/models` - View AI configuration +- `/project:tm/models/setup` - Configure AI providers + +#### 🎯 Task Generation +- `/project:tm/parse-prd` - Generate tasks from PRD +- `/project:tm/parse-prd/with-research` - Enhanced parsing +- `/project:tm/generate` - Create task files + +#### 📝 Task Management +- `/project:tm/list` - List tasks (natural language filters) +- `/project:tm/show <id>` - Display task details +- `/project:tm/add-task` - Create new task +- `/project:tm/update` - Update tasks naturally +- `/project:tm/next` - Get next task recommendation + +#### 🔄 Status Management +- `/project:tm/set-status/to-pending <id>` +- `/project:tm/set-status/to-in-progress <id>` +- `/project:tm/set-status/to-done <id>` +- `/project:tm/set-status/to-review <id>` +- `/project:tm/set-status/to-deferred <id>` +- `/project:tm/set-status/to-cancelled <id>` + +#### 🔍 Analysis & Breakdown +- `/project:tm/analyze-complexity` - Analyze task complexity +- `/project:tm/expand <id>` - Break down complex task +- `/project:tm/expand/all` - Expand all eligible tasks + +#### 🔗 Dependencies +- `/project:tm/add-dependency` - Add task dependency +- `/project:tm/remove-dependency` - Remove dependency +- `/project:tm/validate-dependencies` - Check for issues + +#### 🤖 Workflows +- `/project:tm/workflows/smart-flow` - Intelligent workflows +- `/project:tm/workflows/pipeline` - Command chaining +- `/project:tm/workflows/auto-implement` - Auto-implementation + +#### 📊 Utilities +- `/project:tm/utils/analyze` - Project analysis +- `/project:tm/status` - Project dashboard +- `/project:tm/learn` - Interactive learning + +### Natural Language Examples + +``` +/project:tm/list pending high priority +/project:tm/update mark all API tasks as done +/project:tm/add-task create login system with OAuth +/project:tm/show current +``` + +### Getting Started + +1. Install: `/project:tm/setup/quick-install` +2. Initialize: `/project:tm/init/quick` +3. Learn: `/project:tm/learn start` +4. Work: `/project:tm/workflows/smart-flow` + +For detailed command info: `/project:tm/help <command-name>` \ No newline at end of file diff --git a/.claude/commands/tm/index.md b/.claude/commands/tm/index.md new file mode 100644 index 00000000..f513bb04 --- /dev/null +++ b/.claude/commands/tm/index.md @@ -0,0 +1,130 @@ +# Task Master Command Reference + +Comprehensive command structure for Task Master integration with Claude Code. + +## Command Organization + +Commands are organized hierarchically to match Task Master's CLI structure while providing enhanced Claude Code integration. + +## Project Setup & Configuration + +### `/project:tm/init` +- `index` - Initialize new project (handles PRD files intelligently) +- `quick` - Quick setup with auto-confirmation (-y flag) + +### `/project:tm/models` +- `index` - View current AI model configuration +- `setup` - Interactive model configuration +- `set-main` - Set primary generation model +- `set-research` - Set research model +- `set-fallback` - Set fallback model + +## Task Generation + +### `/project:tm/parse-prd` +- `index` - Generate tasks from PRD document +- `with-research` - Enhanced parsing with research mode + +### `/project:tm/generate` +- Create individual task files from tasks.json + +## Task Management + +### `/project:tm/list` +- `index` - Smart listing with natural language filters +- `with-subtasks` - Include subtasks in hierarchical view +- `by-status` - Filter by specific status + +### `/project:tm/set-status` +- `to-pending` - Reset task to pending +- `to-in-progress` - Start working on task +- `to-done` - Mark task complete +- `to-review` - Submit for review +- `to-deferred` - Defer task +- `to-cancelled` - Cancel task + +### `/project:tm/sync-readme` +- Export tasks to README.md with formatting + +### `/project:tm/update` +- `index` - Update tasks with natural language +- `from-id` - Update multiple tasks from a starting point +- `single` - Update specific task + +### `/project:tm/add-task` +- `index` - Add new task with AI assistance + +### `/project:tm/remove-task` +- `index` - Remove task with confirmation + +## Subtask Management + +### `/project:tm/add-subtask` +- `index` - Add new subtask to parent +- `from-task` - Convert existing task to subtask + +### `/project:tm/remove-subtask` +- Remove subtask (with optional conversion) + +### `/project:tm/clear-subtasks` +- `index` - Clear subtasks from specific task +- `all` - Clear all subtasks globally + +## Task Analysis & Breakdown + +### `/project:tm/analyze-complexity` +- Analyze and generate expansion recommendations + +### `/project:tm/complexity-report` +- Display complexity analysis report + +### `/project:tm/expand` +- `index` - Break down specific task +- `all` - Expand all eligible tasks +- `with-research` - Enhanced expansion + +## Task Navigation + +### `/project:tm/next` +- Intelligent next task recommendation + +### `/project:tm/show` +- Display detailed task information + +### `/project:tm/status` +- Comprehensive project dashboard + +## Dependency Management + +### `/project:tm/add-dependency` +- Add task dependency + +### `/project:tm/remove-dependency` +- Remove task dependency + +### `/project:tm/validate-dependencies` +- Check for dependency issues + +### `/project:tm/fix-dependencies` +- Automatically fix dependency problems + +## Usage Patterns + +### Natural Language +Most commands accept natural language arguments: +``` +/project:tm/add-task create user authentication system +/project:tm/update mark all API tasks as high priority +/project:tm/list show blocked tasks +``` + +### ID-Based Commands +Commands requiring IDs intelligently parse from $ARGUMENTS: +``` +/project:tm/show 45 +/project:tm/expand 23 +/project:tm/set-status/to-done 67 +``` + +### Smart Defaults +Commands provide intelligent defaults and suggestions based on context. \ No newline at end of file diff --git a/.claude/commands/tm/init/index.md b/.claude/commands/tm/init/index.md new file mode 100644 index 00000000..f2598dff --- /dev/null +++ b/.claude/commands/tm/init/index.md @@ -0,0 +1,50 @@ +Initialize a new Task Master project. + +Arguments: $ARGUMENTS + +Parse arguments to determine initialization preferences. + +## Initialization Process + +1. **Parse Arguments** + - PRD file path (if provided) + - Project name + - Auto-confirm flag (-y) + +2. **Project Setup** + ```bash + task-master init + ``` + +3. **Smart Initialization** + - Detect existing project files + - Suggest project name from directory + - Check for git repository + - Verify AI provider configuration + +## Configuration Options + +Based on arguments: +- `quick` / `-y` → Skip confirmations +- `<file.md>` → Use as PRD after init +- `--name=<name>` → Set project name +- `--description=<desc>` → Set description + +## Post-Initialization + +After successful init: +1. Show project structure created +2. Verify AI models configured +3. Suggest next steps: + - Parse PRD if available + - Configure AI providers + - Set up git hooks + - Create first tasks + +## Integration + +If PRD file provided: +``` +/project:tm/init my-prd.md +→ Automatically runs parse-prd after init +``` \ No newline at end of file diff --git a/.claude/commands/tm/init/quick.md b/.claude/commands/tm/init/quick.md new file mode 100644 index 00000000..1fb8eb67 --- /dev/null +++ b/.claude/commands/tm/init/quick.md @@ -0,0 +1,46 @@ +Quick initialization with auto-confirmation. + +Arguments: $ARGUMENTS + +Initialize a Task Master project without prompts, accepting all defaults. + +## Quick Setup + +```bash +task-master init -y +``` + +## What It Does + +1. Creates `.taskmaster/` directory structure +2. Initializes empty `tasks.json` +3. Sets up default configuration +4. Uses directory name as project name +5. Skips all confirmation prompts + +## Smart Defaults + +- Project name: Current directory name +- Description: "Task Master Project" +- Model config: Existing environment vars +- Task structure: Standard format + +## Next Steps + +After quick init: +1. Configure AI models if needed: + ``` + /project:tm/models/setup + ``` + +2. Parse PRD if available: + ``` + /project:tm/parse-prd <file> + ``` + +3. Or create first task: + ``` + /project:tm/add-task create initial setup + ``` + +Perfect for rapid project setup! \ No newline at end of file diff --git a/.claude/commands/tm/learn.md b/.claude/commands/tm/learn.md new file mode 100644 index 00000000..0ffe5455 --- /dev/null +++ b/.claude/commands/tm/learn.md @@ -0,0 +1,103 @@ +Learn about Task Master capabilities through interactive exploration. + +Arguments: $ARGUMENTS + +## Interactive Task Master Learning + +Based on your input, I'll help you discover capabilities: + +### 1. **What are you trying to do?** + +If $ARGUMENTS contains: +- "start" / "begin" → Show project initialization workflows +- "manage" / "organize" → Show task management commands +- "automate" / "auto" → Show automation workflows +- "analyze" / "report" → Show analysis tools +- "fix" / "problem" → Show troubleshooting commands +- "fast" / "quick" → Show efficiency shortcuts + +### 2. **Intelligent Suggestions** + +Based on your project state: + +**No tasks yet?** +``` +You'll want to start with: +1. /project:task-master:init <prd-file> + → Creates tasks from requirements + +2. /project:task-master:parse-prd <file> + → Alternative task generation + +Try: /project:task-master:init demo-prd.md +``` + +**Have tasks?** +Let me analyze what you might need... +- Many pending tasks? → Learn sprint planning +- Complex tasks? → Learn task expansion +- Daily work? → Learn workflow automation + +### 3. **Command Discovery** + +**By Category:** +- 📋 Task Management: list, show, add, update, complete +- 🔄 Workflows: auto-implement, sprint-plan, daily-standup +- 🛠️ Utilities: check-health, complexity-report, sync-memory +- 🔍 Analysis: validate-deps, show dependencies + +**By Scenario:** +- "I want to see what to work on" → `/project:task-master:next` +- "I need to break this down" → `/project:task-master:expand <id>` +- "Show me everything" → `/project:task-master:status` +- "Just do it for me" → `/project:workflows:auto-implement` + +### 4. **Power User Patterns** + +**Command Chaining:** +``` +/project:task-master:next +/project:task-master:start <id> +/project:workflows:auto-implement +``` + +**Smart Filters:** +``` +/project:task-master:list pending high +/project:task-master:list blocked +/project:task-master:list 1-5 tree +``` + +**Automation:** +``` +/project:workflows:pipeline init → expand-all → sprint-plan +``` + +### 5. **Learning Path** + +Based on your experience level: + +**Beginner Path:** +1. init → Create project +2. status → Understand state +3. next → Find work +4. complete → Finish task + +**Intermediate Path:** +1. expand → Break down complex tasks +2. sprint-plan → Organize work +3. complexity-report → Understand difficulty +4. validate-deps → Ensure consistency + +**Advanced Path:** +1. pipeline → Chain operations +2. smart-flow → Context-aware automation +3. Custom commands → Extend the system + +### 6. **Try This Now** + +Based on what you asked about, try: +[Specific command suggestion based on $ARGUMENTS] + +Want to learn more about a specific command? +Type: /project:help <command-name> \ No newline at end of file diff --git a/.claude/commands/tm/list/by-status.md b/.claude/commands/tm/list/by-status.md new file mode 100644 index 00000000..e9524ffd --- /dev/null +++ b/.claude/commands/tm/list/by-status.md @@ -0,0 +1,39 @@ +List tasks filtered by a specific status. + +Arguments: $ARGUMENTS + +Parse the status from arguments and list only tasks matching that status. + +## Status Options +- `pending` - Not yet started +- `in-progress` - Currently being worked on +- `done` - Completed +- `review` - Awaiting review +- `deferred` - Postponed +- `cancelled` - Cancelled + +## Execution + +Based on $ARGUMENTS, run: +```bash +task-master list --status=$ARGUMENTS +``` + +## Enhanced Display + +For the filtered results: +- Group by priority within the status +- Show time in current status +- Highlight tasks approaching deadlines +- Display blockers and dependencies +- Suggest next actions for each status group + +## Intelligent Insights + +Based on the status filter: +- **Pending**: Show recommended start order +- **In-Progress**: Display idle time warnings +- **Done**: Show newly unblocked tasks +- **Review**: Indicate review duration +- **Deferred**: Show reactivation criteria +- **Cancelled**: Display impact analysis \ No newline at end of file diff --git a/.claude/commands/tm/list/index.md b/.claude/commands/tm/list/index.md new file mode 100644 index 00000000..74374af5 --- /dev/null +++ b/.claude/commands/tm/list/index.md @@ -0,0 +1,43 @@ +List tasks with intelligent argument parsing. + +Parse arguments to determine filters and display options: +- Status: pending, in-progress, done, review, deferred, cancelled +- Priority: high, medium, low (or priority:high) +- Special: subtasks, tree, dependencies, blocked +- IDs: Direct numbers (e.g., "1,3,5" or "1-5") +- Complex: "pending high" = pending AND high priority + +Arguments: $ARGUMENTS + +Let me parse your request intelligently: + +1. **Detect Filter Intent** + - If arguments contain status keywords → filter by status + - If arguments contain priority → filter by priority + - If arguments contain "subtasks" → include subtasks + - If arguments contain "tree" → hierarchical view + - If arguments contain numbers → show specific tasks + - If arguments contain "blocked" → show blocked tasks only + +2. **Smart Combinations** + Examples of what I understand: + - "pending high" → pending tasks with high priority + - "done today" → tasks completed today + - "blocked" → tasks with unmet dependencies + - "1-5" → tasks 1 through 5 + - "subtasks tree" → hierarchical view with subtasks + +3. **Execute Appropriate Query** + Based on parsed intent, run the most specific task-master command + +4. **Enhanced Display** + - Group by relevant criteria + - Show most important information first + - Use visual indicators for quick scanning + - Include relevant metrics + +5. **Intelligent Suggestions** + Based on what you're viewing, suggest next actions: + - Many pending? → Suggest priority order + - Many blocked? → Show dependency resolution + - Looking at specific tasks? → Show related tasks \ No newline at end of file diff --git a/.claude/commands/tm/list/with-subtasks.md b/.claude/commands/tm/list/with-subtasks.md new file mode 100644 index 00000000..407e0ba4 --- /dev/null +++ b/.claude/commands/tm/list/with-subtasks.md @@ -0,0 +1,29 @@ +List all tasks including their subtasks in a hierarchical view. + +This command shows all tasks with their nested subtasks, providing a complete project overview. + +## Execution + +Run the Task Master list command with subtasks flag: +```bash +task-master list --with-subtasks +``` + +## Enhanced Display + +I'll organize the output to show: +- Parent tasks with clear indicators +- Nested subtasks with proper indentation +- Status badges for quick scanning +- Dependencies and blockers highlighted +- Progress indicators for tasks with subtasks + +## Smart Filtering + +Based on the task hierarchy: +- Show completion percentage for parent tasks +- Highlight blocked subtask chains +- Group by functional areas +- Indicate critical path items + +This gives you a complete tree view of your project structure. \ No newline at end of file diff --git a/.claude/commands/tm/models/index.md b/.claude/commands/tm/models/index.md new file mode 100644 index 00000000..61ac989a --- /dev/null +++ b/.claude/commands/tm/models/index.md @@ -0,0 +1,51 @@ +View current AI model configuration. + +## Model Configuration Display + +Shows the currently configured AI providers and models for Task Master. + +## Execution + +```bash +task-master models +``` + +## Information Displayed + +1. **Main Provider** + - Model ID and name + - API key status (configured/missing) + - Usage: Primary task generation + +2. **Research Provider** + - Model ID and name + - API key status + - Usage: Enhanced research mode + +3. **Fallback Provider** + - Model ID and name + - API key status + - Usage: Backup when main fails + +## Visual Status + +``` +Task Master AI Model Configuration +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +Main: ✅ claude-3-5-sonnet (configured) +Research: ✅ perplexity-sonar (configured) +Fallback: ⚠️ Not configured (optional) + +Available Models: +- claude-3-5-sonnet +- gpt-4-turbo +- gpt-3.5-turbo +- perplexity-sonar +``` + +## Next Actions + +Based on configuration: +- If missing API keys → Suggest setup +- If no research model → Explain benefits +- If all configured → Show usage tips \ No newline at end of file diff --git a/.claude/commands/tm/models/setup.md b/.claude/commands/tm/models/setup.md new file mode 100644 index 00000000..367a7c8d --- /dev/null +++ b/.claude/commands/tm/models/setup.md @@ -0,0 +1,51 @@ +Run interactive setup to configure AI models. + +## Interactive Model Configuration + +Guides you through setting up AI providers for Task Master. + +## Execution + +```bash +task-master models --setup +``` + +## Setup Process + +1. **Environment Check** + - Detect existing API keys + - Show current configuration + - Identify missing providers + +2. **Provider Selection** + - Choose main provider (required) + - Select research provider (recommended) + - Configure fallback (optional) + +3. **API Key Configuration** + - Prompt for missing keys + - Validate key format + - Test connectivity + - Save configuration + +## Smart Recommendations + +Based on your needs: +- **For best results**: Claude + Perplexity +- **Budget conscious**: GPT-3.5 + Perplexity +- **Maximum capability**: GPT-4 + Perplexity + Claude fallback + +## Configuration Storage + +Keys can be stored in: +1. Environment variables (recommended) +2. `.env` file in project +3. Global `.taskmaster/config` + +## Post-Setup + +After configuration: +- Test each provider +- Show usage examples +- Suggest next steps +- Verify parse-prd works \ No newline at end of file diff --git a/.claude/commands/tm/next/index.md b/.claude/commands/tm/next/index.md new file mode 100644 index 00000000..1af74d94 --- /dev/null +++ b/.claude/commands/tm/next/index.md @@ -0,0 +1,66 @@ +Intelligently determine and prepare the next action based on comprehensive context. + +This enhanced version of 'next' considers: +- Current task states +- Recent activity +- Time constraints +- Dependencies +- Your working patterns + +Arguments: $ARGUMENTS + +## Intelligent Next Action + +### 1. **Context Gathering** +Let me analyze the current situation: +- Active tasks (in-progress) +- Recently completed tasks +- Blocked tasks +- Time since last activity +- Arguments provided: $ARGUMENTS + +### 2. **Smart Decision Tree** + +**If you have an in-progress task:** +- Has it been idle > 2 hours? → Suggest resuming or switching +- Near completion? → Show remaining steps +- Blocked? → Find alternative task + +**If no in-progress tasks:** +- Unblocked high-priority tasks? → Start highest +- Complex tasks need breakdown? → Suggest expansion +- All tasks blocked? → Show dependency resolution + +**Special arguments handling:** +- "quick" → Find task < 2 hours +- "easy" → Find low complexity task +- "important" → Find high priority regardless of complexity +- "continue" → Resume last worked task + +### 3. **Preparation Workflow** + +Based on selected task: +1. Show full context and history +2. Set up development environment +3. Run relevant tests +4. Open related files +5. Show similar completed tasks +6. Estimate completion time + +### 4. **Alternative Suggestions** + +Always provide options: +- Primary recommendation +- Quick alternative (< 1 hour) +- Strategic option (unblocks most tasks) +- Learning option (new technology/skill) + +### 5. **Workflow Integration** + +Seamlessly connect to: +- `/project:task-master:start [selected]` +- `/project:workflows:auto-implement` +- `/project:task-master:expand` (if complex) +- `/project:utils:complexity-report` (if unsure) + +The goal: Zero friction from decision to implementation. \ No newline at end of file diff --git a/.claude/commands/tm/parse-prd/index.md b/.claude/commands/tm/parse-prd/index.md new file mode 100644 index 00000000..f299c714 --- /dev/null +++ b/.claude/commands/tm/parse-prd/index.md @@ -0,0 +1,49 @@ +Parse a PRD document to generate tasks. + +Arguments: $ARGUMENTS (PRD file path) + +## Intelligent PRD Parsing + +Analyzes your requirements document and generates a complete task breakdown. + +## Execution + +```bash +task-master parse-prd --input=$ARGUMENTS +``` + +## Parsing Process + +1. **Document Analysis** + - Extract key requirements + - Identify technical components + - Detect dependencies + - Estimate complexity + +2. **Task Generation** + - Create 10-15 tasks by default + - Include implementation tasks + - Add testing tasks + - Include documentation tasks + - Set logical dependencies + +3. **Smart Enhancements** + - Group related functionality + - Set appropriate priorities + - Add acceptance criteria + - Include test strategies + +## Options + +Parse arguments for modifiers: +- Number after filename → `--num-tasks` +- `research` → Use research mode +- `comprehensive` → Generate more tasks + +## Post-Generation + +After parsing: +1. Display task summary +2. Show dependency graph +3. Suggest task expansion for complex items +4. Recommend sprint planning \ No newline at end of file diff --git a/.claude/commands/tm/parse-prd/with-research.md b/.claude/commands/tm/parse-prd/with-research.md new file mode 100644 index 00000000..8be39e83 --- /dev/null +++ b/.claude/commands/tm/parse-prd/with-research.md @@ -0,0 +1,48 @@ +Parse PRD with enhanced research mode for better task generation. + +Arguments: $ARGUMENTS (PRD file path) + +## Research-Enhanced Parsing + +Uses the research AI provider (typically Perplexity) for more comprehensive task generation with current best practices. + +## Execution + +```bash +task-master parse-prd --input=$ARGUMENTS --research +``` + +## Research Benefits + +1. **Current Best Practices** + - Latest framework patterns + - Security considerations + - Performance optimizations + - Accessibility requirements + +2. **Technical Deep Dive** + - Implementation approaches + - Library recommendations + - Architecture patterns + - Testing strategies + +3. **Comprehensive Coverage** + - Edge cases consideration + - Error handling tasks + - Monitoring setup + - Deployment tasks + +## Enhanced Output + +Research mode typically: +- Generates more detailed tasks +- Includes industry standards +- Adds compliance considerations +- Suggests modern tooling + +## When to Use + +- New technology domains +- Complex requirements +- Regulatory compliance needed +- Best practices crucial \ No newline at end of file diff --git a/.claude/commands/tm/remove-dependency/index.md b/.claude/commands/tm/remove-dependency/index.md new file mode 100644 index 00000000..9f5936e6 --- /dev/null +++ b/.claude/commands/tm/remove-dependency/index.md @@ -0,0 +1,62 @@ +Remove a dependency between tasks. + +Arguments: $ARGUMENTS + +Parse the task IDs to remove dependency relationship. + +## Removing Dependencies + +Removes a dependency relationship, potentially unblocking tasks. + +## Argument Parsing + +Parse natural language or IDs: +- "remove dependency between 5 and 3" +- "5 no longer needs 3" +- "unblock 5 from 3" +- "5 3" → remove dependency of 5 on 3 + +## Execution + +```bash +task-master remove-dependency --id=<task-id> --depends-on=<dependency-id> +``` + +## Pre-Removal Checks + +1. **Verify dependency exists** +2. **Check impact on task flow** +3. **Warn if it breaks logical sequence** +4. **Show what will be unblocked** + +## Smart Analysis + +Before removing: +- Show why dependency might have existed +- Check if removal makes tasks executable +- Verify no critical path disruption +- Suggest alternative dependencies + +## Post-Removal + +After removing: +1. Show updated task status +2. List newly unblocked tasks +3. Update project timeline +4. Suggest next actions + +## Safety Features + +- Confirm if removing critical dependency +- Show tasks that become immediately actionable +- Warn about potential issues +- Keep removal history + +## Example + +``` +/project:tm/remove-dependency 5 from 3 +→ Removed: Task #5 no longer depends on #3 +→ Task #5 is now UNBLOCKED and ready to start +→ Warning: Consider if #5 still needs #2 completed first +``` \ No newline at end of file diff --git a/.claude/commands/tm/remove-subtask/index.md b/.claude/commands/tm/remove-subtask/index.md new file mode 100644 index 00000000..e5a814f8 --- /dev/null +++ b/.claude/commands/tm/remove-subtask/index.md @@ -0,0 +1,84 @@ +Remove a subtask from its parent task. + +Arguments: $ARGUMENTS + +Parse subtask ID to remove, with option to convert to standalone task. + +## Removing Subtasks + +Remove a subtask and optionally convert it back to a standalone task. + +## Argument Parsing + +- "remove subtask 5.1" +- "delete 5.1" +- "convert 5.1 to task" → remove and convert +- "5.1 standalone" → convert to standalone + +## Execution Options + +### 1. Delete Subtask +```bash +task-master remove-subtask --id=<parentId.subtaskId> +``` + +### 2. Convert to Standalone +```bash +task-master remove-subtask --id=<parentId.subtaskId> --convert +``` + +## Pre-Removal Checks + +1. **Validate Subtask** + - Verify subtask exists + - Check completion status + - Review dependencies + +2. **Impact Analysis** + - Other subtasks that depend on it + - Parent task implications + - Data that will be lost + +## Removal Process + +### For Deletion: +1. Confirm if subtask has work done +2. Update parent task estimates +3. Remove subtask and its data +4. Clean up dependencies + +### For Conversion: +1. Assign new standalone task ID +2. Preserve all task data +3. Update dependency references +4. Maintain task history + +## Smart Features + +- Warn if subtask is in-progress +- Show impact on parent task +- Preserve important data +- Update related estimates + +## Example Flows + +``` +/project:tm/remove-subtask 5.1 +→ Warning: Subtask #5.1 is in-progress +→ This will delete all subtask data +→ Parent task #5 will be updated +Confirm deletion? (y/n) + +/project:tm/remove-subtask 5.1 convert +→ Converting subtask #5.1 to standalone task #89 +→ Preserved: All task data and history +→ Updated: 2 dependency references +→ New task #89 is now independent +``` + +## Post-Removal + +- Update parent task status +- Recalculate estimates +- Show updated hierarchy +- Suggest next actions \ No newline at end of file diff --git a/.claude/commands/tm/remove-task/index.md b/.claude/commands/tm/remove-task/index.md new file mode 100644 index 00000000..477d4a3b --- /dev/null +++ b/.claude/commands/tm/remove-task/index.md @@ -0,0 +1,107 @@ +Remove a task permanently from the project. + +Arguments: $ARGUMENTS (task ID) + +Delete a task and handle all its relationships properly. + +## Task Removal + +Permanently removes a task while maintaining project integrity. + +## Argument Parsing + +- "remove task 5" +- "delete 5" +- "5" → remove task 5 +- Can include "-y" for auto-confirm + +## Execution + +```bash +task-master remove-task --id=<id> [-y] +``` + +## Pre-Removal Analysis + +1. **Task Details** + - Current status + - Work completed + - Time invested + - Associated data + +2. **Relationship Check** + - Tasks that depend on this + - Dependencies this task has + - Subtasks that will be removed + - Blocking implications + +3. **Impact Assessment** + ``` + Task Removal Impact + ━━━━━━━━━━━━━━━━━━ + Task: #5 "Implement authentication" (in-progress) + Status: 60% complete (~8 hours work) + + Will affect: + - 3 tasks depend on this (will be blocked) + - Has 4 subtasks (will be deleted) + - Part of critical path + + ⚠️ This action cannot be undone + ``` + +## Smart Warnings + +- Warn if task is in-progress +- Show dependent tasks that will be blocked +- Highlight if part of critical path +- Note any completed work being lost + +## Removal Process + +1. Show comprehensive impact +2. Require confirmation (unless -y) +3. Update dependent task references +4. Remove task and subtasks +5. Clean up orphaned dependencies +6. Log removal with timestamp + +## Alternative Actions + +Suggest before deletion: +- Mark as cancelled instead +- Convert to documentation +- Archive task data +- Transfer work to another task + +## Post-Removal + +- List affected tasks +- Show broken dependencies +- Update project statistics +- Suggest dependency fixes +- Recalculate timeline + +## Example Flows + +``` +/project:tm/remove-task 5 +→ Task #5 is in-progress with 8 hours logged +→ 3 other tasks depend on this +→ Suggestion: Mark as cancelled instead? +Remove anyway? (y/n) + +/project:tm/remove-task 5 -y +→ Removed: Task #5 and 4 subtasks +→ Updated: 3 task dependencies +→ Warning: Tasks #7, #8, #9 now have missing dependency +→ Run /project:tm/fix-dependencies to resolve +``` + +## Safety Features + +- Confirmation required +- Impact preview +- Removal logging +- Suggest alternatives +- No cascade delete of dependents \ No newline at end of file diff --git a/.claude/commands/tm/set-status/to-cancelled.md b/.claude/commands/tm/set-status/to-cancelled.md new file mode 100644 index 00000000..72c73b37 --- /dev/null +++ b/.claude/commands/tm/set-status/to-cancelled.md @@ -0,0 +1,55 @@ +Cancel a task permanently. + +Arguments: $ARGUMENTS (task ID) + +## Cancelling a Task + +This status indicates a task is no longer needed and won't be completed. + +## Valid Reasons for Cancellation + +- Requirements changed +- Feature deprecated +- Duplicate of another task +- Strategic pivot +- Technical approach invalidated + +## Pre-Cancellation Checks + +1. Confirm no critical dependencies +2. Check for partial implementation +3. Verify cancellation rationale +4. Document lessons learned + +## Execution + +```bash +task-master set-status --id=$ARGUMENTS --status=cancelled +``` + +## Cancellation Impact + +When cancelling: +1. **Dependency Updates** + - Notify dependent tasks + - Update project scope + - Recalculate timelines + +2. **Clean-up Actions** + - Remove related branches + - Archive any work done + - Update documentation + - Close related issues + +3. **Learning Capture** + - Document why cancelled + - Note what was learned + - Update estimation models + - Prevent future duplicates + +## Historical Preservation + +- Keep for reference +- Tag with cancellation reason +- Link to replacement if any +- Maintain audit trail \ No newline at end of file diff --git a/.claude/commands/tm/set-status/to-deferred.md b/.claude/commands/tm/set-status/to-deferred.md new file mode 100644 index 00000000..e679a8d3 --- /dev/null +++ b/.claude/commands/tm/set-status/to-deferred.md @@ -0,0 +1,47 @@ +Defer a task for later consideration. + +Arguments: $ARGUMENTS (task ID) + +## Deferring a Task + +This status indicates a task is valid but not currently actionable or prioritized. + +## Valid Reasons for Deferral + +- Waiting for external dependencies +- Reprioritized for future sprint +- Blocked by technical limitations +- Resource constraints +- Strategic timing considerations + +## Execution + +```bash +task-master set-status --id=$ARGUMENTS --status=deferred +``` + +## Deferral Management + +When deferring: +1. **Document Reason** + - Capture why it's being deferred + - Set reactivation criteria + - Note any partial work completed + +2. **Impact Analysis** + - Check dependent tasks + - Update project timeline + - Notify affected stakeholders + +3. **Future Planning** + - Set review reminders + - Tag for specific milestone + - Preserve context for reactivation + - Link to blocking issues + +## Smart Tracking + +- Monitor deferral duration +- Alert when criteria met +- Prevent scope creep +- Regular review cycles \ No newline at end of file diff --git a/.claude/commands/tm/set-status/to-done.md b/.claude/commands/tm/set-status/to-done.md new file mode 100644 index 00000000..9a3fd98f --- /dev/null +++ b/.claude/commands/tm/set-status/to-done.md @@ -0,0 +1,44 @@ +Mark a task as completed. + +Arguments: $ARGUMENTS (task ID) + +## Completing a Task + +This command validates task completion and updates project state intelligently. + +## Pre-Completion Checks + +1. Verify test strategy was followed +2. Check if all subtasks are complete +3. Validate acceptance criteria met +4. Ensure code is committed + +## Execution + +```bash +task-master set-status --id=$ARGUMENTS --status=done +``` + +## Post-Completion Actions + +1. **Update Dependencies** + - Identify newly unblocked tasks + - Update sprint progress + - Recalculate project timeline + +2. **Documentation** + - Generate completion summary + - Update CLAUDE.md with learnings + - Log implementation approach + +3. **Next Steps** + - Show newly available tasks + - Suggest logical next task + - Update velocity metrics + +## Celebration & Learning + +- Show impact of completion +- Display unblocked work +- Recognize achievement +- Capture lessons learned \ No newline at end of file diff --git a/.claude/commands/tm/set-status/to-in-progress.md b/.claude/commands/tm/set-status/to-in-progress.md new file mode 100644 index 00000000..830a67d0 --- /dev/null +++ b/.claude/commands/tm/set-status/to-in-progress.md @@ -0,0 +1,36 @@ +Start working on a task by setting its status to in-progress. + +Arguments: $ARGUMENTS (task ID) + +## Starting Work on Task + +This command does more than just change status - it prepares your environment for productive work. + +## Pre-Start Checks + +1. Verify dependencies are met +2. Check if another task is already in-progress +3. Ensure task details are complete +4. Validate test strategy exists + +## Execution + +```bash +task-master set-status --id=$ARGUMENTS --status=in-progress +``` + +## Environment Setup + +After setting to in-progress: +1. Create/checkout appropriate git branch +2. Open relevant documentation +3. Set up test watchers if applicable +4. Display task details and acceptance criteria +5. Show similar completed tasks for reference + +## Smart Suggestions + +- Estimated completion time based on complexity +- Related files from similar tasks +- Potential blockers to watch for +- Recommended first steps \ No newline at end of file diff --git a/.claude/commands/tm/set-status/to-pending.md b/.claude/commands/tm/set-status/to-pending.md new file mode 100644 index 00000000..fb6a6560 --- /dev/null +++ b/.claude/commands/tm/set-status/to-pending.md @@ -0,0 +1,32 @@ +Set a task's status to pending. + +Arguments: $ARGUMENTS (task ID) + +## Setting Task to Pending + +This moves a task back to the pending state, useful for: +- Resetting erroneously started tasks +- Deferring work that was prematurely begun +- Reorganizing sprint priorities + +## Execution + +```bash +task-master set-status --id=$ARGUMENTS --status=pending +``` + +## Validation + +Before setting to pending: +- Warn if task is currently in-progress +- Check if this will block other tasks +- Suggest documenting why it's being reset +- Preserve any work already done + +## Smart Actions + +After setting to pending: +- Update sprint planning if needed +- Notify about freed resources +- Suggest priority reassessment +- Log the status change with context \ No newline at end of file diff --git a/.claude/commands/tm/set-status/to-review.md b/.claude/commands/tm/set-status/to-review.md new file mode 100644 index 00000000..2fb77b13 --- /dev/null +++ b/.claude/commands/tm/set-status/to-review.md @@ -0,0 +1,40 @@ +Set a task's status to review. + +Arguments: $ARGUMENTS (task ID) + +## Marking Task for Review + +This status indicates work is complete but needs verification before final approval. + +## When to Use Review Status + +- Code complete but needs peer review +- Implementation done but needs testing +- Documentation written but needs proofreading +- Design complete but needs stakeholder approval + +## Execution + +```bash +task-master set-status --id=$ARGUMENTS --status=review +``` + +## Review Preparation + +When setting to review: +1. **Generate Review Checklist** + - Link to PR/MR if applicable + - Highlight key changes + - Note areas needing attention + - Include test results + +2. **Documentation** + - Update task with review notes + - Link relevant artifacts + - Specify reviewers if known + +3. **Smart Actions** + - Create review reminders + - Track review duration + - Suggest reviewers based on expertise + - Prepare rollback plan if needed \ No newline at end of file diff --git a/.claude/commands/tm/setup/install.md b/.claude/commands/tm/setup/install.md new file mode 100644 index 00000000..73116074 --- /dev/null +++ b/.claude/commands/tm/setup/install.md @@ -0,0 +1,117 @@ +Check if Task Master is installed and install it if needed. + +This command helps you get Task Master set up globally on your system. + +## Detection and Installation Process + +1. **Check Current Installation** + ```bash + # Check if task-master command exists + which task-master || echo "Task Master not found" + + # Check npm global packages + npm list -g task-master-ai + ``` + +2. **System Requirements Check** + ```bash + # Verify Node.js is installed + node --version + + # Verify npm is installed + npm --version + + # Check Node version (need 16+) + ``` + +3. **Install Task Master Globally** + If not installed, run: + ```bash + npm install -g task-master-ai + ``` + +4. **Verify Installation** + ```bash + # Check version + task-master --version + + # Verify command is available + which task-master + ``` + +5. **Initial Setup** + ```bash + # Initialize in current directory + task-master init + ``` + +6. **Configure AI Provider** + Ensure you have at least one AI provider API key set: + ```bash + # Check current configuration + task-master models --status + + # If no API keys found, guide setup + echo "You'll need at least one API key:" + echo "- ANTHROPIC_API_KEY for Claude" + echo "- OPENAI_API_KEY for GPT models" + echo "- PERPLEXITY_API_KEY for research" + echo "" + echo "Set them in your shell profile or .env file" + ``` + +7. **Quick Test** + ```bash + # Create a test PRD + echo "Build a simple hello world API" > test-prd.txt + + # Try parsing it + task-master parse-prd test-prd.txt -n 3 + ``` + +## Troubleshooting + +If installation fails: + +**Permission Errors:** +```bash +# Try with sudo (macOS/Linux) +sudo npm install -g task-master-ai + +# Or fix npm permissions +npm config set prefix ~/.npm-global +export PATH=~/.npm-global/bin:$PATH +``` + +**Network Issues:** +```bash +# Use different registry +npm install -g task-master-ai --registry https://registry.npmjs.org/ +``` + +**Node Version Issues:** +```bash +# Install Node 18+ via nvm +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash +nvm install 18 +nvm use 18 +``` + +## Success Confirmation + +Once installed, you should see: +``` +✅ Task Master v0.16.2 (or higher) installed +✅ Command 'task-master' available globally +✅ AI provider configured +✅ Ready to use slash commands! + +Try: /project:task-master:init your-prd.md +``` + +## Next Steps + +After installation: +1. Run `/project:utils:check-health` to verify setup +2. Configure AI providers with `/project:task-master:models` +3. Start using Task Master commands! \ No newline at end of file diff --git a/.claude/commands/tm/setup/quick-install.md b/.claude/commands/tm/setup/quick-install.md new file mode 100644 index 00000000..efd63a94 --- /dev/null +++ b/.claude/commands/tm/setup/quick-install.md @@ -0,0 +1,22 @@ +Quick install Task Master globally if not already installed. + +Execute this streamlined installation: + +```bash +# Check and install in one command +task-master --version 2>/dev/null || npm install -g task-master-ai + +# Verify installation +task-master --version + +# Quick setup check +task-master models --status || echo "Note: You'll need to set up an AI provider API key" +``` + +If you see "command not found" after installation, you may need to: +1. Restart your terminal +2. Or add npm global bin to PATH: `export PATH=$(npm bin -g):$PATH` + +Once installed, you can use all the Task Master commands! + +Quick test: Run `/project:help` to see all available commands. \ No newline at end of file diff --git a/.claude/commands/tm/show/index.md b/.claude/commands/tm/show/index.md new file mode 100644 index 00000000..789c804f --- /dev/null +++ b/.claude/commands/tm/show/index.md @@ -0,0 +1,82 @@ +Show detailed task information with rich context and insights. + +Arguments: $ARGUMENTS + +## Enhanced Task Display + +Parse arguments to determine what to show and how. + +### 1. **Smart Task Selection** + +Based on $ARGUMENTS: +- Number → Show specific task with full context +- "current" → Show active in-progress task(s) +- "next" → Show recommended next task +- "blocked" → Show all blocked tasks with reasons +- "critical" → Show critical path tasks +- Multiple IDs → Comparative view + +### 2. **Contextual Information** + +For each task, intelligently include: + +**Core Details** +- Full task information (id, title, description, details) +- Current status with history +- Test strategy and acceptance criteria +- Priority and complexity analysis + +**Relationships** +- Dependencies (what it needs) +- Dependents (what needs it) +- Parent/subtask hierarchy +- Related tasks (similar work) + +**Time Intelligence** +- Created/updated timestamps +- Time in current status +- Estimated vs actual time +- Historical completion patterns + +### 3. **Visual Enhancements** + +``` +📋 Task #45: Implement User Authentication +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +Status: 🟡 in-progress (2 hours) +Priority: 🔴 High | Complexity: 73/100 + +Dependencies: ✅ #41, ✅ #42, ⏳ #43 (blocked) +Blocks: #46, #47, #52 + +Progress: ████████░░ 80% complete + +Recent Activity: +- 2h ago: Status changed to in-progress +- 4h ago: Dependency #42 completed +- Yesterday: Task expanded with 3 subtasks +``` + +### 4. **Intelligent Insights** + +Based on task analysis: +- **Risk Assessment**: Complexity vs time remaining +- **Bottleneck Analysis**: Is this blocking critical work? +- **Recommendation**: Suggested approach or concerns +- **Similar Tasks**: How others completed similar work + +### 5. **Action Suggestions** + +Context-aware next steps: +- If blocked → Show how to unblock +- If complex → Suggest expansion +- If in-progress → Show completion checklist +- If done → Show dependent tasks ready to start + +### 6. **Multi-Task View** + +When showing multiple tasks: +- Common dependencies +- Optimal completion order +- Parallel work opportunities +- Combined complexity analysis \ No newline at end of file diff --git a/.claude/commands/tm/status/index.md b/.claude/commands/tm/status/index.md new file mode 100644 index 00000000..c62bcc24 --- /dev/null +++ b/.claude/commands/tm/status/index.md @@ -0,0 +1,64 @@ +Enhanced status command with comprehensive project insights. + +Arguments: $ARGUMENTS + +## Intelligent Status Overview + +### 1. **Executive Summary** +Quick dashboard view: +- 🏃 Active work (in-progress tasks) +- 📊 Progress metrics (% complete, velocity) +- 🚧 Blockers and risks +- ⏱️ Time analysis (estimated vs actual) +- 🎯 Sprint/milestone progress + +### 2. **Contextual Analysis** + +Based on $ARGUMENTS, focus on: +- "sprint" → Current sprint progress and burndown +- "blocked" → Dependency chains and resolution paths +- "team" → Task distribution and workload +- "timeline" → Schedule adherence and projections +- "risk" → High complexity or overdue items + +### 3. **Smart Insights** + +**Workflow Health:** +- Idle tasks (in-progress > 24h without updates) +- Bottlenecks (multiple tasks waiting on same dependency) +- Quick wins (low complexity, high impact) + +**Predictive Analytics:** +- Completion projections based on velocity +- Risk of missing deadlines +- Recommended task order for optimal flow + +### 4. **Visual Intelligence** + +Dynamic visualization based on data: +``` +Sprint Progress: ████████░░ 80% (16/20 tasks) +Velocity Trend: ↗️ +15% this week +Blocked Tasks: 🔴 3 critical path items + +Priority Distribution: +High: ████████ 8 tasks (2 blocked) +Medium: ████░░░░ 4 tasks +Low: ██░░░░░░ 2 tasks +``` + +### 5. **Actionable Recommendations** + +Based on analysis: +1. **Immediate actions** (unblock critical path) +2. **Today's focus** (optimal task sequence) +3. **Process improvements** (recurring patterns) +4. **Resource needs** (skills, time, dependencies) + +### 6. **Historical Context** + +Compare to previous periods: +- Velocity changes +- Pattern recognition +- Improvement areas +- Success patterns to repeat \ No newline at end of file diff --git a/.claude/commands/tm/sync-readme/index.md b/.claude/commands/tm/sync-readme/index.md new file mode 100644 index 00000000..7f319e25 --- /dev/null +++ b/.claude/commands/tm/sync-readme/index.md @@ -0,0 +1,117 @@ +Export tasks to README.md with professional formatting. + +Arguments: $ARGUMENTS + +Generate a well-formatted README with current task information. + +## README Synchronization + +Creates or updates README.md with beautifully formatted task information. + +## Argument Parsing + +Optional filters: +- "pending" → Only pending tasks +- "with-subtasks" → Include subtask details +- "by-priority" → Group by priority +- "sprint" → Current sprint only + +## Execution + +```bash +task-master sync-readme [--with-subtasks] [--status=<status>] +``` + +## README Generation + +### 1. **Project Header** +```markdown +# Project Name + +## 📋 Task Progress + +Last Updated: 2024-01-15 10:30 AM + +### Summary +- Total Tasks: 45 +- Completed: 15 (33%) +- In Progress: 5 (11%) +- Pending: 25 (56%) +``` + +### 2. **Task Sections** +Organized by status or priority: +- Progress indicators +- Task descriptions +- Dependencies noted +- Time estimates + +### 3. **Visual Elements** +- Progress bars +- Status badges +- Priority indicators +- Completion checkmarks + +## Smart Features + +1. **Intelligent Grouping** + - By feature area + - By sprint/milestone + - By assigned developer + - By priority + +2. **Progress Tracking** + - Overall completion + - Sprint velocity + - Burndown indication + - Time tracking + +3. **Formatting Options** + - GitHub-flavored markdown + - Task checkboxes + - Collapsible sections + - Table format available + +## Example Output + +```markdown +## 🚀 Current Sprint + +### In Progress +- [ ] 🔄 #5 **Implement user authentication** (60% complete) + - Dependencies: API design (#3 ✅) + - Subtasks: 4 (2 completed) + - Est: 8h / Spent: 5h + +### Pending (High Priority) +- [ ] ⚡ #8 **Create dashboard UI** + - Blocked by: #5 + - Complexity: High + - Est: 12h +``` + +## Customization + +Based on arguments: +- Include/exclude sections +- Detail level control +- Custom grouping +- Filter by criteria + +## Post-Sync + +After generation: +1. Show diff preview +2. Backup existing README +3. Write new content +4. Commit reminder +5. Update timestamp + +## Integration + +Works well with: +- Git workflows +- CI/CD pipelines +- Project documentation +- Team updates +- Client reports \ No newline at end of file diff --git a/.claude/commands/tm/update/from-id.md b/.claude/commands/tm/update/from-id.md new file mode 100644 index 00000000..1085352d --- /dev/null +++ b/.claude/commands/tm/update/from-id.md @@ -0,0 +1,108 @@ +Update multiple tasks starting from a specific ID. + +Arguments: $ARGUMENTS + +Parse starting task ID and update context. + +## Bulk Task Updates + +Update multiple related tasks based on new requirements or context changes. + +## Argument Parsing + +- "from 5: add security requirements" +- "5 onwards: update API endpoints" +- "starting at 5: change to use new framework" + +## Execution + +```bash +task-master update --from=<id> --prompt="<context>" +``` + +## Update Process + +### 1. **Task Selection** +Starting from specified ID: +- Include the task itself +- Include all dependent tasks +- Include related subtasks +- Smart boundary detection + +### 2. **Context Application** +AI analyzes the update context and: +- Identifies what needs changing +- Maintains consistency +- Preserves completed work +- Updates related information + +### 3. **Intelligent Updates** +- Modify descriptions appropriately +- Update test strategies +- Adjust time estimates +- Revise dependencies if needed + +## Smart Features + +1. **Scope Detection** + - Find natural task groupings + - Identify related features + - Stop at logical boundaries + - Avoid over-updating + +2. **Consistency Maintenance** + - Keep naming conventions + - Preserve relationships + - Update cross-references + - Maintain task flow + +3. **Change Preview** + ``` + Bulk Update Preview + ━━━━━━━━━━━━━━━━━━ + Starting from: Task #5 + Tasks to update: 8 tasks + 12 subtasks + + Context: "add security requirements" + + Changes will include: + - Add security sections to descriptions + - Update test strategies for security + - Add security-related subtasks where needed + - Adjust time estimates (+20% average) + + Continue? (y/n) + ``` + +## Example Updates + +``` +/project:tm/update/from-id 5: change database to PostgreSQL +→ Analyzing impact starting from task #5 +→ Found 6 related tasks to update +→ Updates will maintain consistency +→ Preview changes? (y/n) + +Applied updates: +✓ Task #5: Updated connection logic references +✓ Task #6: Changed migration approach +✓ Task #7: Updated query syntax notes +✓ Task #8: Revised testing strategy +✓ Task #9: Updated deployment steps +✓ Task #12: Changed backup procedures +``` + +## Safety Features + +- Preview all changes +- Selective confirmation +- Rollback capability +- Change logging +- Validation checks + +## Post-Update + +- Summary of changes +- Consistency verification +- Suggest review tasks +- Update timeline if needed \ No newline at end of file diff --git a/.claude/commands/tm/update/index.md b/.claude/commands/tm/update/index.md new file mode 100644 index 00000000..a654d5eb --- /dev/null +++ b/.claude/commands/tm/update/index.md @@ -0,0 +1,72 @@ +Update tasks with intelligent field detection and bulk operations. + +Arguments: $ARGUMENTS + +## Intelligent Task Updates + +Parse arguments to determine update intent and execute smartly. + +### 1. **Natural Language Processing** + +Understand update requests like: +- "mark 23 as done" → Update status to done +- "increase priority of 45" → Set priority to high +- "add dependency on 12 to task 34" → Add dependency +- "tasks 20-25 need review" → Bulk status update +- "all API tasks high priority" → Pattern-based update + +### 2. **Smart Field Detection** + +Automatically detect what to update: +- Status keywords: done, complete, start, pause, review +- Priority changes: urgent, high, low, deprioritize +- Dependency updates: depends on, blocks, after +- Assignment: assign to, owner, responsible +- Time: estimate, spent, deadline + +### 3. **Bulk Operations** + +Support for multiple task updates: +``` +Examples: +- "complete tasks 12, 15, 18" +- "all pending auth tasks to in-progress" +- "increase priority for tasks blocking 45" +- "defer all documentation tasks" +``` + +### 4. **Contextual Validation** + +Before updating, check: +- Status transitions are valid +- Dependencies don't create cycles +- Priority changes make sense +- Bulk updates won't break project flow + +Show preview: +``` +Update Preview: +───────────────── +Tasks to update: #23, #24, #25 +Change: status → in-progress +Impact: Will unblock tasks #30, #31 +Warning: Task #24 has unmet dependencies +``` + +### 5. **Smart Suggestions** + +Based on update: +- Completing task? → Show newly unblocked tasks +- Changing priority? → Show impact on sprint +- Adding dependency? → Check for conflicts +- Bulk update? → Show summary of changes + +### 6. **Workflow Integration** + +After updates: +- Auto-update dependent task states +- Trigger status recalculation +- Update sprint/milestone progress +- Log changes with context + +Result: Flexible, intelligent task updates with safety checks. \ No newline at end of file diff --git a/.claude/commands/tm/update/single.md b/.claude/commands/tm/update/single.md new file mode 100644 index 00000000..9bab5fac --- /dev/null +++ b/.claude/commands/tm/update/single.md @@ -0,0 +1,119 @@ +Update a single specific task with new information. + +Arguments: $ARGUMENTS + +Parse task ID and update details. + +## Single Task Update + +Precisely update one task with AI assistance to maintain consistency. + +## Argument Parsing + +Natural language updates: +- "5: add caching requirement" +- "update 5 to include error handling" +- "task 5 needs rate limiting" +- "5 change priority to high" + +## Execution + +```bash +task-master update-task --id=<id> --prompt="<context>" +``` + +## Update Types + +### 1. **Content Updates** +- Enhance description +- Add requirements +- Clarify details +- Update acceptance criteria + +### 2. **Metadata Updates** +- Change priority +- Adjust time estimates +- Update complexity +- Modify dependencies + +### 3. **Strategic Updates** +- Revise approach +- Change test strategy +- Update implementation notes +- Adjust subtask needs + +## AI-Powered Updates + +The AI: +1. **Understands Context** + - Reads current task state + - Identifies update intent + - Maintains consistency + - Preserves important info + +2. **Applies Changes** + - Updates relevant fields + - Keeps style consistent + - Adds without removing + - Enhances clarity + +3. **Validates Results** + - Checks coherence + - Verifies completeness + - Maintains relationships + - Suggests related updates + +## Example Updates + +``` +/project:tm/update/single 5: add rate limiting +→ Updating Task #5: "Implement API endpoints" + +Current: Basic CRUD endpoints +Adding: Rate limiting requirements + +Updated sections: +✓ Description: Added rate limiting mention +✓ Details: Added specific limits (100/min) +✓ Test Strategy: Added rate limit tests +✓ Complexity: Increased from 5 to 6 +✓ Time Estimate: Increased by 2 hours + +Suggestion: Also update task #6 (API Gateway) for consistency? +``` + +## Smart Features + +1. **Incremental Updates** + - Adds without overwriting + - Preserves work history + - Tracks what changed + - Shows diff view + +2. **Consistency Checks** + - Related task alignment + - Subtask compatibility + - Dependency validity + - Timeline impact + +3. **Update History** + - Timestamp changes + - Track who/what updated + - Reason for update + - Previous versions + +## Field-Specific Updates + +Quick syntax for specific fields: +- "5 priority:high" → Update priority only +- "5 add-time:4h" → Add to time estimate +- "5 status:review" → Change status +- "5 depends:3,4" → Add dependencies + +## Post-Update + +- Show updated task +- Highlight changes +- Check related tasks +- Update suggestions +- Timeline adjustments \ No newline at end of file diff --git a/.claude/commands/tm/utils/analyze.md b/.claude/commands/tm/utils/analyze.md new file mode 100644 index 00000000..92622044 --- /dev/null +++ b/.claude/commands/tm/utils/analyze.md @@ -0,0 +1,97 @@ +Advanced project analysis with actionable insights and recommendations. + +Arguments: $ARGUMENTS + +## Comprehensive Project Analysis + +Multi-dimensional analysis based on requested focus area. + +### 1. **Analysis Modes** + +Based on $ARGUMENTS: +- "velocity" → Sprint velocity and trends +- "quality" → Code quality metrics +- "risk" → Risk assessment and mitigation +- "dependencies" → Dependency graph analysis +- "team" → Workload and skill distribution +- "architecture" → System design coherence +- Default → Full spectrum analysis + +### 2. **Velocity Analytics** + +``` +📊 Velocity Analysis +━━━━━━━━━━━━━━━━━━━ +Current Sprint: 24 points/week ↗️ +20% +Rolling Average: 20 points/week +Efficiency: 85% (17/20 tasks on time) + +Bottlenecks Detected: +- Code review delays (avg 4h wait) +- Test environment availability +- Dependency on external team + +Recommendations: +1. Implement parallel review process +2. Add staging environment +3. Mock external dependencies +``` + +### 3. **Risk Assessment** + +**Technical Risks** +- High complexity tasks without backup assignee +- Single points of failure in architecture +- Insufficient test coverage in critical paths +- Technical debt accumulation rate + +**Project Risks** +- Critical path dependencies +- Resource availability gaps +- Deadline feasibility analysis +- Scope creep indicators + +### 4. **Dependency Intelligence** + +Visual dependency analysis: +``` +Critical Path: +#12 → #15 → #23 → #45 → #50 (20 days) + ↘ #24 → #46 ↗ + +Optimization: Parallelize #15 and #24 +Time Saved: 3 days +``` + +### 5. **Quality Metrics** + +**Code Quality** +- Test coverage trends +- Complexity scores +- Technical debt ratio +- Review feedback patterns + +**Process Quality** +- Rework frequency +- Bug introduction rate +- Time to resolution +- Knowledge distribution + +### 6. **Predictive Insights** + +Based on patterns: +- Completion probability by deadline +- Resource needs projection +- Risk materialization likelihood +- Suggested interventions + +### 7. **Executive Dashboard** + +High-level summary with: +- Health score (0-100) +- Top 3 risks +- Top 3 opportunities +- Recommended actions +- Success probability + +Result: Data-driven decisions with clear action paths. \ No newline at end of file diff --git a/.claude/commands/tm/validate-dependencies/index.md b/.claude/commands/tm/validate-dependencies/index.md new file mode 100644 index 00000000..aaf4eb46 --- /dev/null +++ b/.claude/commands/tm/validate-dependencies/index.md @@ -0,0 +1,71 @@ +Validate all task dependencies for issues. + +## Dependency Validation + +Comprehensive check for dependency problems across the entire project. + +## Execution + +```bash +task-master validate-dependencies +``` + +## Validation Checks + +1. **Circular Dependencies** + - A depends on B, B depends on A + - Complex circular chains + - Self-dependencies + +2. **Missing Dependencies** + - References to non-existent tasks + - Deleted task references + - Invalid task IDs + +3. **Logical Issues** + - Completed tasks depending on pending + - Cancelled tasks in dependency chains + - Impossible sequences + +4. **Complexity Warnings** + - Over-complex dependency chains + - Too many dependencies per task + - Bottleneck tasks + +## Smart Analysis + +The validation provides: +- Visual dependency graph +- Critical path analysis +- Bottleneck identification +- Suggested optimizations + +## Report Format + +``` +Dependency Validation Report +━━━━━━━━━━━━━━━━━━━━━━━━━━ +✅ No circular dependencies found +⚠️ 2 warnings found: + - Task #23 has 7 dependencies (consider breaking down) + - Task #45 blocks 5 other tasks (potential bottleneck) +❌ 1 error found: + - Task #67 depends on deleted task #66 + +Critical Path: #1 → #5 → #23 → #45 → #50 (15 days) +``` + +## Actionable Output + +For each issue found: +- Clear description +- Impact assessment +- Suggested fix +- Command to resolve + +## Next Steps + +After validation: +- Run `/project:tm/fix-dependencies` to auto-fix +- Manually adjust problematic dependencies +- Rerun to verify fixes \ No newline at end of file diff --git a/.claude/commands/tm/workflows/auto-implement.md b/.claude/commands/tm/workflows/auto-implement.md new file mode 100644 index 00000000..20abc950 --- /dev/null +++ b/.claude/commands/tm/workflows/auto-implement.md @@ -0,0 +1,97 @@ +Enhanced auto-implementation with intelligent code generation and testing. + +Arguments: $ARGUMENTS + +## Intelligent Auto-Implementation + +Advanced implementation with context awareness and quality checks. + +### 1. **Pre-Implementation Analysis** + +Before starting: +- Analyze task complexity and requirements +- Check codebase patterns and conventions +- Identify similar completed tasks +- Assess test coverage needs +- Detect potential risks + +### 2. **Smart Implementation Strategy** + +Based on task type and context: + +**Feature Tasks** +1. Research existing patterns +2. Design component architecture +3. Implement with tests +4. Integrate with system +5. Update documentation + +**Bug Fix Tasks** +1. Reproduce issue +2. Identify root cause +3. Implement minimal fix +4. Add regression tests +5. Verify side effects + +**Refactoring Tasks** +1. Analyze current structure +2. Plan incremental changes +3. Maintain test coverage +4. Refactor step-by-step +5. Verify behavior unchanged + +### 3. **Code Intelligence** + +**Pattern Recognition** +- Learn from existing code +- Follow team conventions +- Use preferred libraries +- Match style guidelines + +**Test-Driven Approach** +- Write tests first when possible +- Ensure comprehensive coverage +- Include edge cases +- Performance considerations + +### 4. **Progressive Implementation** + +Step-by-step with validation: +``` +Step 1/5: Setting up component structure ✓ +Step 2/5: Implementing core logic ✓ +Step 3/5: Adding error handling ⚡ (in progress) +Step 4/5: Writing tests ⏳ +Step 5/5: Integration testing ⏳ + +Current: Adding try-catch blocks and validation... +``` + +### 5. **Quality Assurance** + +Automated checks: +- Linting and formatting +- Test execution +- Type checking +- Dependency validation +- Performance analysis + +### 6. **Smart Recovery** + +If issues arise: +- Diagnostic analysis +- Suggestion generation +- Fallback strategies +- Manual intervention points +- Learning from failures + +### 7. **Post-Implementation** + +After completion: +- Generate PR description +- Update documentation +- Log lessons learned +- Suggest follow-up tasks +- Update task relationships + +Result: High-quality, production-ready implementations. \ No newline at end of file diff --git a/.claude/commands/tm/workflows/pipeline.md b/.claude/commands/tm/workflows/pipeline.md new file mode 100644 index 00000000..83080018 --- /dev/null +++ b/.claude/commands/tm/workflows/pipeline.md @@ -0,0 +1,77 @@ +Execute a pipeline of commands based on a specification. + +Arguments: $ARGUMENTS + +## Command Pipeline Execution + +Parse pipeline specification from arguments. Supported formats: + +### Simple Pipeline +`init → expand-all → sprint-plan` + +### Conditional Pipeline +`status → if:pending>10 → sprint-plan → else → next` + +### Iterative Pipeline +`for:pending-tasks → expand → complexity-check` + +### Smart Pipeline Patterns + +**1. Project Setup Pipeline** +``` +init [prd] → +expand-all → +complexity-report → +sprint-plan → +show first-sprint +``` + +**2. Daily Work Pipeline** +``` +standup → +if:in-progress → continue → +else → next → start +``` + +**3. Task Completion Pipeline** +``` +complete [id] → +git-commit → +if:blocked-tasks-freed → show-freed → +next +``` + +**4. Quality Check Pipeline** +``` +list in-progress → +for:each → check-idle-time → +if:idle>1day → prompt-update +``` + +### Pipeline Features + +**Variables** +- Store results: `status → $count=pending-count` +- Use in conditions: `if:$count>10` +- Pass between commands: `expand $high-priority-tasks` + +**Error Handling** +- On failure: `try:complete → catch:show-blockers` +- Skip on error: `optional:test-run` +- Retry logic: `retry:3:commit` + +**Parallel Execution** +- Parallel branches: `[analyze | test | lint]` +- Join results: `parallel → join:report` + +### Execution Flow + +1. Parse pipeline specification +2. Validate command sequence +3. Execute with state passing +4. Handle conditions and loops +5. Aggregate results +6. Show summary + +This enables complex workflows like: +`parse-prd → expand-all → filter:complex>70 → assign:senior → sprint-plan:weighted` \ No newline at end of file diff --git a/.claude/commands/tm/workflows/smart-flow.md b/.claude/commands/tm/workflows/smart-flow.md new file mode 100644 index 00000000..56eb28d4 --- /dev/null +++ b/.claude/commands/tm/workflows/smart-flow.md @@ -0,0 +1,55 @@ +Execute an intelligent workflow based on current project state and recent commands. + +This command analyzes: +1. Recent commands you've run +2. Current project state +3. Time of day / day of week +4. Your working patterns + +Arguments: $ARGUMENTS + +## Intelligent Workflow Selection + +Based on context, I'll determine the best workflow: + +### Context Analysis +- Previous command executed +- Current task states +- Unfinished work from last session +- Your typical patterns + +### Smart Execution + +If last command was: +- `status` → Likely starting work → Run daily standup +- `complete` → Task finished → Find next task +- `list pending` → Planning → Suggest sprint planning +- `expand` → Breaking down work → Show complexity analysis +- `init` → New project → Show onboarding workflow + +If no recent commands: +- Morning? → Daily standup workflow +- Many pending tasks? → Sprint planning +- Tasks blocked? → Dependency resolution +- Friday? → Weekly review + +### Workflow Composition + +I'll chain appropriate commands: +1. Analyze current state +2. Execute primary workflow +3. Suggest follow-up actions +4. Prepare environment for coding + +### Learning Mode + +This command learns from your patterns: +- Track command sequences +- Note time preferences +- Remember common workflows +- Adapt to your style + +Example flows detected: +- Morning: standup → next → start +- After lunch: status → continue task +- End of day: complete → commit → status \ No newline at end of file