data_porter 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (159) hide show
  1. checksums.yaml +7 -0
  2. data/.claude/commands/blog-status.md +10 -0
  3. data/.claude/commands/blog.md +109 -0
  4. data/.claude/commands/task-done.md +27 -0
  5. data/.claude/commands/tm/add-dependency.md +58 -0
  6. data/.claude/commands/tm/add-subtask.md +79 -0
  7. data/.claude/commands/tm/add-task.md +81 -0
  8. data/.claude/commands/tm/analyze-complexity.md +124 -0
  9. data/.claude/commands/tm/analyze-project.md +100 -0
  10. data/.claude/commands/tm/auto-implement-tasks.md +100 -0
  11. data/.claude/commands/tm/command-pipeline.md +80 -0
  12. data/.claude/commands/tm/complexity-report.md +120 -0
  13. data/.claude/commands/tm/convert-task-to-subtask.md +74 -0
  14. data/.claude/commands/tm/expand-all-tasks.md +52 -0
  15. data/.claude/commands/tm/expand-task.md +52 -0
  16. data/.claude/commands/tm/fix-dependencies.md +82 -0
  17. data/.claude/commands/tm/help.md +101 -0
  18. data/.claude/commands/tm/init-project-quick.md +49 -0
  19. data/.claude/commands/tm/init-project.md +53 -0
  20. data/.claude/commands/tm/install-taskmaster.md +118 -0
  21. data/.claude/commands/tm/learn.md +106 -0
  22. data/.claude/commands/tm/list-tasks-by-status.md +42 -0
  23. data/.claude/commands/tm/list-tasks-with-subtasks.md +30 -0
  24. data/.claude/commands/tm/list-tasks.md +46 -0
  25. data/.claude/commands/tm/next-task.md +69 -0
  26. data/.claude/commands/tm/parse-prd-with-research.md +51 -0
  27. data/.claude/commands/tm/parse-prd.md +52 -0
  28. data/.claude/commands/tm/project-status.md +67 -0
  29. data/.claude/commands/tm/quick-install-taskmaster.md +23 -0
  30. data/.claude/commands/tm/remove-all-subtasks.md +94 -0
  31. data/.claude/commands/tm/remove-dependency.md +65 -0
  32. data/.claude/commands/tm/remove-subtask.md +87 -0
  33. data/.claude/commands/tm/remove-subtasks.md +89 -0
  34. data/.claude/commands/tm/remove-task.md +110 -0
  35. data/.claude/commands/tm/setup-models.md +52 -0
  36. data/.claude/commands/tm/show-task.md +85 -0
  37. data/.claude/commands/tm/smart-workflow.md +58 -0
  38. data/.claude/commands/tm/sync-readme.md +120 -0
  39. data/.claude/commands/tm/tm-main.md +147 -0
  40. data/.claude/commands/tm/to-cancelled.md +58 -0
  41. data/.claude/commands/tm/to-deferred.md +50 -0
  42. data/.claude/commands/tm/to-done.md +47 -0
  43. data/.claude/commands/tm/to-in-progress.md +39 -0
  44. data/.claude/commands/tm/to-pending.md +35 -0
  45. data/.claude/commands/tm/to-review.md +43 -0
  46. data/.claude/commands/tm/update-single-task.md +122 -0
  47. data/.claude/commands/tm/update-task.md +75 -0
  48. data/.claude/commands/tm/update-tasks-from-id.md +111 -0
  49. data/.claude/commands/tm/validate-dependencies.md +72 -0
  50. data/.claude/commands/tm/view-models.md +52 -0
  51. data/.env.example +12 -0
  52. data/.mcp.json +24 -0
  53. data/.taskmaster/CLAUDE.md +435 -0
  54. data/.taskmaster/config.json +44 -0
  55. data/.taskmaster/docs/prd.txt +2044 -0
  56. data/.taskmaster/state.json +6 -0
  57. data/.taskmaster/tasks/task_001.md +19 -0
  58. data/.taskmaster/tasks/task_002.md +19 -0
  59. data/.taskmaster/tasks/task_003.md +19 -0
  60. data/.taskmaster/tasks/task_004.md +19 -0
  61. data/.taskmaster/tasks/task_005.md +19 -0
  62. data/.taskmaster/tasks/task_006.md +19 -0
  63. data/.taskmaster/tasks/task_007.md +19 -0
  64. data/.taskmaster/tasks/task_008.md +19 -0
  65. data/.taskmaster/tasks/task_009.md +19 -0
  66. data/.taskmaster/tasks/task_010.md +19 -0
  67. data/.taskmaster/tasks/task_011.md +19 -0
  68. data/.taskmaster/tasks/task_012.md +19 -0
  69. data/.taskmaster/tasks/task_013.md +19 -0
  70. data/.taskmaster/tasks/task_014.md +19 -0
  71. data/.taskmaster/tasks/task_015.md +19 -0
  72. data/.taskmaster/tasks/task_016.md +19 -0
  73. data/.taskmaster/tasks/task_017.md +19 -0
  74. data/.taskmaster/tasks/task_018.md +19 -0
  75. data/.taskmaster/tasks/task_019.md +19 -0
  76. data/.taskmaster/tasks/task_020.md +19 -0
  77. data/.taskmaster/tasks/tasks.json +299 -0
  78. data/.taskmaster/templates/example_prd.txt +47 -0
  79. data/.taskmaster/templates/example_prd_rpg.txt +511 -0
  80. data/CHANGELOG.md +29 -0
  81. data/CLAUDE.md +65 -0
  82. data/CODE_OF_CONDUCT.md +10 -0
  83. data/CONTRIBUTING.md +49 -0
  84. data/LICENSE +21 -0
  85. data/README.md +463 -0
  86. data/Rakefile +12 -0
  87. data/app/assets/stylesheets/data_porter/application.css +646 -0
  88. data/app/channels/data_porter/import_channel.rb +10 -0
  89. data/app/controllers/data_porter/imports_controller.rb +68 -0
  90. data/app/javascript/data_porter/progress_controller.js +33 -0
  91. data/app/jobs/data_porter/dry_run_job.rb +12 -0
  92. data/app/jobs/data_porter/import_job.rb +12 -0
  93. data/app/jobs/data_porter/parse_job.rb +12 -0
  94. data/app/models/data_porter/data_import.rb +49 -0
  95. data/app/views/data_porter/imports/index.html.erb +142 -0
  96. data/app/views/data_porter/imports/new.html.erb +88 -0
  97. data/app/views/data_porter/imports/show.html.erb +49 -0
  98. data/config/database.yml +3 -0
  99. data/config/routes.rb +12 -0
  100. data/docs/SPEC.md +2012 -0
  101. data/docs/UI.md +32 -0
  102. data/docs/blog/001-why-build-a-data-import-engine.md +166 -0
  103. data/docs/blog/002-scaffolding-a-rails-engine.md +188 -0
  104. data/docs/blog/003-configuration-dsl.md +222 -0
  105. data/docs/blog/004-store-model-jsonb.md +237 -0
  106. data/docs/blog/005-target-dsl.md +284 -0
  107. data/docs/blog/006-parsing-csv-sources.md +300 -0
  108. data/docs/blog/007-orchestrator.md +247 -0
  109. data/docs/blog/008-actioncable-stimulus.md +376 -0
  110. data/docs/blog/009-phlex-ui-components.md +446 -0
  111. data/docs/blog/010-controllers-routing.md +374 -0
  112. data/docs/blog/011-generators.md +364 -0
  113. data/docs/blog/012-json-api-sources.md +323 -0
  114. data/docs/blog/013-testing-rails-engine.md +618 -0
  115. data/docs/blog/014-dry-run.md +307 -0
  116. data/docs/blog/015-publishing-retro.md +264 -0
  117. data/docs/blog/016-erb-view-templates.md +431 -0
  118. data/docs/blog/017-showcase-final-retro.md +220 -0
  119. data/docs/blog/BACKLOG.md +8 -0
  120. data/docs/blog/SERIES.md +154 -0
  121. data/docs/screenshots/index-with-previewing.jpg +0 -0
  122. data/docs/screenshots/index.jpg +0 -0
  123. data/docs/screenshots/modal-new-import.jpg +0 -0
  124. data/docs/screenshots/preview.jpg +0 -0
  125. data/lib/data_porter/broadcaster.rb +29 -0
  126. data/lib/data_porter/components/base.rb +10 -0
  127. data/lib/data_porter/components/failure_alert.rb +20 -0
  128. data/lib/data_porter/components/preview_table.rb +54 -0
  129. data/lib/data_porter/components/progress_bar.rb +33 -0
  130. data/lib/data_porter/components/results_summary.rb +19 -0
  131. data/lib/data_porter/components/status_badge.rb +16 -0
  132. data/lib/data_porter/components/summary_cards.rb +30 -0
  133. data/lib/data_porter/components.rb +14 -0
  134. data/lib/data_porter/configuration.rb +25 -0
  135. data/lib/data_porter/dsl/api_config.rb +25 -0
  136. data/lib/data_porter/dsl/column.rb +17 -0
  137. data/lib/data_porter/engine.rb +15 -0
  138. data/lib/data_porter/orchestrator.rb +141 -0
  139. data/lib/data_porter/record_validator.rb +32 -0
  140. data/lib/data_porter/registry.rb +33 -0
  141. data/lib/data_porter/sources/api.rb +49 -0
  142. data/lib/data_porter/sources/base.rb +35 -0
  143. data/lib/data_porter/sources/csv.rb +43 -0
  144. data/lib/data_porter/sources/json.rb +45 -0
  145. data/lib/data_porter/sources.rb +20 -0
  146. data/lib/data_porter/store_models/error.rb +13 -0
  147. data/lib/data_porter/store_models/import_record.rb +52 -0
  148. data/lib/data_porter/store_models/report.rb +21 -0
  149. data/lib/data_porter/target.rb +89 -0
  150. data/lib/data_porter/type_validator.rb +46 -0
  151. data/lib/data_porter/version.rb +5 -0
  152. data/lib/data_porter.rb +32 -0
  153. data/lib/generators/data_porter/install/install_generator.rb +33 -0
  154. data/lib/generators/data_porter/install/templates/create_data_porter_imports.rb.erb +21 -0
  155. data/lib/generators/data_porter/install/templates/initializer.rb +30 -0
  156. data/lib/generators/data_porter/target/target_generator.rb +44 -0
  157. data/lib/generators/data_porter/target/templates/target.rb.tt +20 -0
  158. data/sig/data_porter.rbs +4 -0
  159. metadata +274 -0
@@ -0,0 +1,118 @@
1
+ Install TaskMaster
2
+ Check if Task Master is installed and install it if needed.
3
+
4
+ This command helps you get Task Master set up globally on your system.
5
+
6
+ ## Detection and Installation Process
7
+
8
+ 1. **Check Current Installation**
9
+ ```bash
10
+ # Check if task-master command exists
11
+ which task-master || echo "Task Master not found"
12
+
13
+ # Check npm global packages
14
+ npm list -g task-master-ai
15
+ ```
16
+
17
+ 2. **System Requirements Check**
18
+ ```bash
19
+ # Verify Node.js is installed
20
+ node --version
21
+
22
+ # Verify npm is installed
23
+ npm --version
24
+
25
+ # Check Node version (need 16+)
26
+ ```
27
+
28
+ 3. **Install Task Master Globally**
29
+ If not installed, run:
30
+ ```bash
31
+ npm install -g task-master-ai
32
+ ```
33
+
34
+ 4. **Verify Installation**
35
+ ```bash
36
+ # Check version
37
+ task-master --version
38
+
39
+ # Verify command is available
40
+ which task-master
41
+ ```
42
+
43
+ 5. **Initial Setup**
44
+ ```bash
45
+ # Initialize in current directory
46
+ task-master init
47
+ ```
48
+
49
+ 6. **Configure AI Provider**
50
+ Ensure you have at least one AI provider API key set:
51
+ ```bash
52
+ # Check current configuration
53
+ task-master models --status
54
+
55
+ # If no API keys found, guide setup
56
+ echo "You'll need at least one API key:"
57
+ echo "- ANTHROPIC_API_KEY for Claude"
58
+ echo "- OPENAI_API_KEY for GPT models"
59
+ echo "- PERPLEXITY_API_KEY for research"
60
+ echo ""
61
+ echo "Set them in your shell profile or .env file"
62
+ ```
63
+
64
+ 7. **Quick Test**
65
+ ```bash
66
+ # Create a test PRD
67
+ echo "Build a simple hello world API" > test-prd.txt
68
+
69
+ # Try parsing it
70
+ task-master parse-prd test-prd.txt -n 3
71
+ ```
72
+
73
+ ## Troubleshooting
74
+
75
+ If installation fails:
76
+
77
+ **Permission Errors:**
78
+ ```bash
79
+ # Try with sudo (macOS/Linux)
80
+ sudo npm install -g task-master-ai
81
+
82
+ # Or fix npm permissions
83
+ npm config set prefix ~/.npm-global
84
+ export PATH=~/.npm-global/bin:$PATH
85
+ ```
86
+
87
+ **Network Issues:**
88
+ ```bash
89
+ # Use different registry
90
+ npm install -g task-master-ai --registry https://registry.npmjs.org/
91
+ ```
92
+
93
+ **Node Version Issues:**
94
+ ```bash
95
+ # Install Node 20+ via nvm
96
+ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
97
+ nvm install 20
98
+ nvm use 20
99
+ ```
100
+
101
+ ## Success Confirmation
102
+
103
+ Once installed, you should see:
104
+ ```
105
+ ✅ Task Master installed
106
+ ✅ Command 'task-master' available globally
107
+ ✅ AI provider configured
108
+ ✅ Ready to use slash commands!
109
+
110
+ Try: /taskmaster:init your-prd.md
111
+ ```
112
+
113
+ ## Next Steps
114
+
115
+ After installation:
116
+ 1. Run `/taskmaster:status` to verify setup
117
+ 2. Configure AI providers with `/taskmaster:setup-models`
118
+ 3. Start using Task Master commands!
@@ -0,0 +1,106 @@
1
+ Learn
2
+
3
+ Arguments: $ARGUMENTS
4
+ Learn about Task Master capabilities through interactive exploration.
5
+
6
+ Arguments: $ARGUMENTS
7
+
8
+ ## Interactive Task Master Learning
9
+
10
+ Based on your input, I'll help you discover capabilities:
11
+
12
+ ### 1. **What are you trying to do?**
13
+
14
+ If $ARGUMENTS contains:
15
+ - "start" / "begin" → Show project initialization workflows
16
+ - "manage" / "organize" → Show task management commands
17
+ - "automate" / "auto" → Show automation workflows
18
+ - "analyze" / "report" → Show analysis tools
19
+ - "fix" / "problem" → Show troubleshooting commands
20
+ - "fast" / "quick" → Show efficiency shortcuts
21
+
22
+ ### 2. **Intelligent Suggestions**
23
+
24
+ Based on your project state:
25
+
26
+ **No tasks yet?**
27
+ ```
28
+ You'll want to start with:
29
+ 1. /project:task-master:init <prd-file>
30
+ → Creates tasks from requirements
31
+
32
+ 2. /project:task-master:parse-prd <file>
33
+ → Alternative task generation
34
+
35
+ Try: /project:task-master:init demo-prd.md
36
+ ```
37
+
38
+ **Have tasks?**
39
+ Let me analyze what you might need...
40
+ - Many pending tasks? → Learn sprint planning
41
+ - Complex tasks? → Learn task expansion
42
+ - Daily work? → Learn workflow automation
43
+
44
+ ### 3. **Command Discovery**
45
+
46
+ **By Category:**
47
+ - 📋 Task Management: list, show, add, update, complete
48
+ - 🔄 Workflows: auto-implement, sprint-plan, daily-standup
49
+ - 🛠️ Utilities: check-health, complexity-report, sync-memory
50
+ - 🔍 Analysis: validate-deps, show dependencies
51
+
52
+ **By Scenario:**
53
+ - "I want to see what to work on" → `/project:task-master:next`
54
+ - "I need to break this down" → `/project:task-master:expand <id>`
55
+ - "Show me everything" → `/project:task-master:status`
56
+ - "Just do it for me" → `/project:workflows:auto-implement`
57
+
58
+ ### 4. **Power User Patterns**
59
+
60
+ **Command Chaining:**
61
+ ```
62
+ /project:task-master:next
63
+ /project:task-master:start <id>
64
+ /project:workflows:auto-implement
65
+ ```
66
+
67
+ **Smart Filters:**
68
+ ```
69
+ /project:task-master:list pending high
70
+ /project:task-master:list blocked
71
+ /project:task-master:list 1-5 tree
72
+ ```
73
+
74
+ **Automation:**
75
+ ```
76
+ /project:workflows:pipeline init → expand-all → sprint-plan
77
+ ```
78
+
79
+ ### 5. **Learning Path**
80
+
81
+ Based on your experience level:
82
+
83
+ **Beginner Path:**
84
+ 1. init → Create project
85
+ 2. status → Understand state
86
+ 3. next → Find work
87
+ 4. complete → Finish task
88
+
89
+ **Intermediate Path:**
90
+ 1. expand → Break down complex tasks
91
+ 2. sprint-plan → Organize work
92
+ 3. complexity-report → Understand difficulty
93
+ 4. validate-deps → Ensure consistency
94
+
95
+ **Advanced Path:**
96
+ 1. pipeline → Chain operations
97
+ 2. smart-flow → Context-aware automation
98
+ 3. Custom commands → Extend the system
99
+
100
+ ### 6. **Try This Now**
101
+
102
+ Based on what you asked about, try:
103
+ [Specific command suggestion based on $ARGUMENTS]
104
+
105
+ Want to learn more about a specific command?
106
+ Type: /project:help <command-name>
@@ -0,0 +1,42 @@
1
+ List Tasks By Status
2
+
3
+ Arguments: $ARGUMENTS
4
+ List tasks filtered by a specific status.
5
+
6
+ Arguments: $ARGUMENTS
7
+
8
+ Parse the status from arguments and list only tasks matching that status.
9
+
10
+ ## Status Options
11
+ - `pending` - Not yet started
12
+ - `in-progress` - Currently being worked on
13
+ - `done` - Completed
14
+ - `review` - Awaiting review
15
+ - `deferred` - Postponed
16
+ - `cancelled` - Cancelled
17
+
18
+ ## Execution
19
+
20
+ Based on $ARGUMENTS, run:
21
+ ```bash
22
+ task-master list --status=$ARGUMENTS
23
+ ```
24
+
25
+ ## Enhanced Display
26
+
27
+ For the filtered results:
28
+ - Group by priority within the status
29
+ - Show time in current status
30
+ - Highlight tasks approaching deadlines
31
+ - Display blockers and dependencies
32
+ - Suggest next actions for each status group
33
+
34
+ ## Intelligent Insights
35
+
36
+ Based on the status filter:
37
+ - **Pending**: Show recommended start order
38
+ - **In-Progress**: Display idle time warnings
39
+ - **Done**: Show newly unblocked tasks
40
+ - **Review**: Indicate review duration
41
+ - **Deferred**: Show reactivation criteria
42
+ - **Cancelled**: Display impact analysis
@@ -0,0 +1,30 @@
1
+ List Tasks With Subtasks
2
+ List all tasks including their subtasks in a hierarchical view.
3
+
4
+ This command shows all tasks with their nested subtasks, providing a complete project overview.
5
+
6
+ ## Execution
7
+
8
+ Run the Task Master list command with subtasks flag:
9
+ ```bash
10
+ task-master list --with-subtasks
11
+ ```
12
+
13
+ ## Enhanced Display
14
+
15
+ I'll organize the output to show:
16
+ - Parent tasks with clear indicators
17
+ - Nested subtasks with proper indentation
18
+ - Status badges for quick scanning
19
+ - Dependencies and blockers highlighted
20
+ - Progress indicators for tasks with subtasks
21
+
22
+ ## Smart Filtering
23
+
24
+ Based on the task hierarchy:
25
+ - Show completion percentage for parent tasks
26
+ - Highlight blocked subtask chains
27
+ - Group by functional areas
28
+ - Indicate critical path items
29
+
30
+ This gives you a complete tree view of your project structure.
@@ -0,0 +1,46 @@
1
+ List Tasks
2
+
3
+ Arguments: $ARGUMENTS
4
+ List tasks with intelligent argument parsing.
5
+
6
+ Parse arguments to determine filters and display options:
7
+ - Status: pending, in-progress, done, review, deferred, cancelled
8
+ - Priority: high, medium, low (or priority:high)
9
+ - Special: subtasks, tree, dependencies, blocked
10
+ - IDs: Direct numbers (e.g., "1,3,5" or "1-5")
11
+ - Complex: "pending high" = pending AND high priority
12
+
13
+ Arguments: $ARGUMENTS
14
+
15
+ Let me parse your request intelligently:
16
+
17
+ 1. **Detect Filter Intent**
18
+ - If arguments contain status keywords → filter by status
19
+ - If arguments contain priority → filter by priority
20
+ - If arguments contain "subtasks" → include subtasks
21
+ - If arguments contain "tree" → hierarchical view
22
+ - If arguments contain numbers → show specific tasks
23
+ - If arguments contain "blocked" → show blocked tasks only
24
+
25
+ 2. **Smart Combinations**
26
+ Examples of what I understand:
27
+ - "pending high" → pending tasks with high priority
28
+ - "done today" → tasks completed today
29
+ - "blocked" → tasks with unmet dependencies
30
+ - "1-5" → tasks 1 through 5
31
+ - "subtasks tree" → hierarchical view with subtasks
32
+
33
+ 3. **Execute Appropriate Query**
34
+ Based on parsed intent, run the most specific task-master command
35
+
36
+ 4. **Enhanced Display**
37
+ - Group by relevant criteria
38
+ - Show most important information first
39
+ - Use visual indicators for quick scanning
40
+ - Include relevant metrics
41
+
42
+ 5. **Intelligent Suggestions**
43
+ Based on what you're viewing, suggest next actions:
44
+ - Many pending? → Suggest priority order
45
+ - Many blocked? → Show dependency resolution
46
+ - Looking at specific tasks? → Show related tasks
@@ -0,0 +1,69 @@
1
+ Next Task
2
+
3
+ Arguments: $ARGUMENTS
4
+ Intelligently determine and prepare the next action based on comprehensive context.
5
+
6
+ This enhanced version of 'next' considers:
7
+ - Current task states
8
+ - Recent activity
9
+ - Time constraints
10
+ - Dependencies
11
+ - Your working patterns
12
+
13
+ Arguments: $ARGUMENTS
14
+
15
+ ## Intelligent Next Action
16
+
17
+ ### 1. **Context Gathering**
18
+ Let me analyze the current situation:
19
+ - Active tasks (in-progress)
20
+ - Recently completed tasks
21
+ - Blocked tasks
22
+ - Time since last activity
23
+ - Arguments provided: $ARGUMENTS
24
+
25
+ ### 2. **Smart Decision Tree**
26
+
27
+ **If you have an in-progress task:**
28
+ - Has it been idle > 2 hours? → Suggest resuming or switching
29
+ - Near completion? → Show remaining steps
30
+ - Blocked? → Find alternative task
31
+
32
+ **If no in-progress tasks:**
33
+ - Unblocked high-priority tasks? → Start highest
34
+ - Complex tasks need breakdown? → Suggest expansion
35
+ - All tasks blocked? → Show dependency resolution
36
+
37
+ **Special arguments handling:**
38
+ - "quick" → Find task < 2 hours
39
+ - "easy" → Find low complexity task
40
+ - "important" → Find high priority regardless of complexity
41
+ - "continue" → Resume last worked task
42
+
43
+ ### 3. **Preparation Workflow**
44
+
45
+ Based on selected task:
46
+ 1. Show full context and history
47
+ 2. Set up development environment
48
+ 3. Run relevant tests
49
+ 4. Open related files
50
+ 5. Show similar completed tasks
51
+ 6. Estimate completion time
52
+
53
+ ### 4. **Alternative Suggestions**
54
+
55
+ Always provide options:
56
+ - Primary recommendation
57
+ - Quick alternative (< 1 hour)
58
+ - Strategic option (unblocks most tasks)
59
+ - Learning option (new technology/skill)
60
+
61
+ ### 5. **Workflow Integration**
62
+
63
+ Seamlessly connect to:
64
+ - `/project:task-master:start [selected]`
65
+ - `/project:workflows:auto-implement`
66
+ - `/project:task-master:expand` (if complex)
67
+ - `/project:utils:complexity-report` (if unsure)
68
+
69
+ The goal: Zero friction from decision to implementation.
@@ -0,0 +1,51 @@
1
+ Parse PRD With Research
2
+
3
+ Arguments: $ARGUMENTS
4
+ Parse PRD with enhanced research mode for better task generation.
5
+
6
+ Arguments: $ARGUMENTS (PRD file path)
7
+
8
+ ## Research-Enhanced Parsing
9
+
10
+ Uses the research AI provider (typically Perplexity) for more comprehensive task generation with current best practices.
11
+
12
+ ## Execution
13
+
14
+ ```bash
15
+ task-master parse-prd --input=$ARGUMENTS --research
16
+ ```
17
+
18
+ ## Research Benefits
19
+
20
+ 1. **Current Best Practices**
21
+ - Latest framework patterns
22
+ - Security considerations
23
+ - Performance optimizations
24
+ - Accessibility requirements
25
+
26
+ 2. **Technical Deep Dive**
27
+ - Implementation approaches
28
+ - Library recommendations
29
+ - Architecture patterns
30
+ - Testing strategies
31
+
32
+ 3. **Comprehensive Coverage**
33
+ - Edge cases consideration
34
+ - Error handling tasks
35
+ - Monitoring setup
36
+ - Deployment tasks
37
+
38
+ ## Enhanced Output
39
+
40
+ Research mode typically:
41
+ - Generates more detailed tasks
42
+ - Includes industry standards
43
+ - Adds compliance considerations
44
+ - Suggests modern tooling
45
+
46
+ ## When to Use
47
+
48
+ - New technology domains
49
+ - Complex requirements
50
+ - Regulatory compliance needed
51
+ - Best practices crucial
@@ -0,0 +1,52 @@
1
+ Parse PRD
2
+
3
+ Arguments: $ARGUMENTS
4
+ Parse a PRD document to generate tasks.
5
+
6
+ Arguments: $ARGUMENTS (PRD file path)
7
+
8
+ ## Intelligent PRD Parsing
9
+
10
+ Analyzes your requirements document and generates a complete task breakdown.
11
+
12
+ ## Execution
13
+
14
+ ```bash
15
+ task-master parse-prd --input=$ARGUMENTS
16
+ ```
17
+
18
+ ## Parsing Process
19
+
20
+ 1. **Document Analysis**
21
+ - Extract key requirements
22
+ - Identify technical components
23
+ - Detect dependencies
24
+ - Estimate complexity
25
+
26
+ 2. **Task Generation**
27
+ - Create 10-15 tasks by default
28
+ - Include implementation tasks
29
+ - Add testing tasks
30
+ - Include documentation tasks
31
+ - Set logical dependencies
32
+
33
+ 3. **Smart Enhancements**
34
+ - Group related functionality
35
+ - Set appropriate priorities
36
+ - Add acceptance criteria
37
+ - Include test strategies
38
+
39
+ ## Options
40
+
41
+ Parse arguments for modifiers:
42
+ - Number after filename → `--num-tasks`
43
+ - `research` → Use research mode
44
+ - `comprehensive` → Generate more tasks
45
+
46
+ ## Post-Generation
47
+
48
+ After parsing:
49
+ 1. Display task summary
50
+ 2. Show dependency graph
51
+ 3. Suggest task expansion for complex items
52
+ 4. Recommend sprint planning
@@ -0,0 +1,67 @@
1
+ Project Status
2
+
3
+ Arguments: $ARGUMENTS
4
+ Enhanced status command with comprehensive project insights.
5
+
6
+ Arguments: $ARGUMENTS
7
+
8
+ ## Intelligent Status Overview
9
+
10
+ ### 1. **Executive Summary**
11
+ Quick dashboard view:
12
+ - 🏃 Active work (in-progress tasks)
13
+ - 📊 Progress metrics (% complete, velocity)
14
+ - 🚧 Blockers and risks
15
+ - ⏱️ Time analysis (estimated vs actual)
16
+ - 🎯 Sprint/milestone progress
17
+
18
+ ### 2. **Contextual Analysis**
19
+
20
+ Based on $ARGUMENTS, focus on:
21
+ - "sprint" → Current sprint progress and burndown
22
+ - "blocked" → Dependency chains and resolution paths
23
+ - "team" → Task distribution and workload
24
+ - "timeline" → Schedule adherence and projections
25
+ - "risk" → High complexity or overdue items
26
+
27
+ ### 3. **Smart Insights**
28
+
29
+ **Workflow Health:**
30
+ - Idle tasks (in-progress > 24h without updates)
31
+ - Bottlenecks (multiple tasks waiting on same dependency)
32
+ - Quick wins (low complexity, high impact)
33
+
34
+ **Predictive Analytics:**
35
+ - Completion projections based on velocity
36
+ - Risk of missing deadlines
37
+ - Recommended task order for optimal flow
38
+
39
+ ### 4. **Visual Intelligence**
40
+
41
+ Dynamic visualization based on data:
42
+ ```
43
+ Sprint Progress: ████████░░ 80% (16/20 tasks)
44
+ Velocity Trend: ↗️ +15% this week
45
+ Blocked Tasks: 🔴 3 critical path items
46
+
47
+ Priority Distribution:
48
+ High: ████████ 8 tasks (2 blocked)
49
+ Medium: ████░░░░ 4 tasks
50
+ Low: ██░░░░░░ 2 tasks
51
+ ```
52
+
53
+ ### 5. **Actionable Recommendations**
54
+
55
+ Based on analysis:
56
+ 1. **Immediate actions** (unblock critical path)
57
+ 2. **Today's focus** (optimal task sequence)
58
+ 3. **Process improvements** (recurring patterns)
59
+ 4. **Resource needs** (skills, time, dependencies)
60
+
61
+ ### 6. **Historical Context**
62
+
63
+ Compare to previous periods:
64
+ - Velocity changes
65
+ - Pattern recognition
66
+ - Improvement areas
67
+ - Success patterns to repeat
@@ -0,0 +1,23 @@
1
+ Quick Install TaskMaster
2
+ Quick install Task Master globally if not already installed.
3
+
4
+ Execute this streamlined installation:
5
+
6
+ ```bash
7
+ # Check and install in one command
8
+ task-master --version 2>/dev/null || npm install -g task-master-ai
9
+
10
+ # Verify installation
11
+ task-master --version
12
+
13
+ # Quick setup check
14
+ task-master models --status || echo "Note: You'll need to set up an AI provider API key"
15
+ ```
16
+
17
+ If you see "command not found" after installation, you may need to:
18
+ 1. Restart your terminal
19
+ 2. Or add npm global bin to PATH: `export PATH=$(npm bin -g):$PATH`
20
+
21
+ Once installed, you can use all the Task Master commands!
22
+
23
+ Quick test: Run `/taskmaster:help` to see all available commands.
@@ -0,0 +1,94 @@
1
+ Remove All Subtasks
2
+ Clear all subtasks from all tasks globally.
3
+
4
+ ## Global Subtask Clearing
5
+
6
+ Remove all subtasks across the entire project. Use with extreme caution.
7
+
8
+ ## Execution
9
+
10
+ ```bash
11
+ task-master clear-subtasks --all
12
+ ```
13
+
14
+ ## Pre-Clear Analysis
15
+
16
+ 1. **Project-Wide Summary**
17
+ ```
18
+ Global Subtask Summary
19
+ ━━━━━━━━━━━━━━━━━━━━
20
+ Total parent tasks: 12
21
+ Total subtasks: 47
22
+ - Completed: 15
23
+ - In-progress: 8
24
+ - Pending: 24
25
+
26
+ Work at risk: ~120 hours
27
+ ```
28
+
29
+ 2. **Critical Warnings**
30
+ - In-progress subtasks that will lose work
31
+ - Completed subtasks with valuable history
32
+ - Complex dependency chains
33
+ - Integration test results
34
+
35
+ ## Double Confirmation
36
+
37
+ ```
38
+ ⚠️ DESTRUCTIVE OPERATION WARNING ⚠️
39
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
40
+ This will remove ALL 47 subtasks from your project
41
+ Including 8 in-progress and 15 completed subtasks
42
+
43
+ This action CANNOT be undone
44
+
45
+ Type 'CLEAR ALL SUBTASKS' to confirm:
46
+ ```
47
+
48
+ ## Smart Safeguards
49
+
50
+ - Require explicit confirmation phrase
51
+ - Create automatic backup
52
+ - Log all removed data
53
+ - Option to export first
54
+
55
+ ## Use Cases
56
+
57
+ Valid reasons for global clear:
58
+ - Project restructuring
59
+ - Major pivot in approach
60
+ - Starting fresh breakdown
61
+ - Switching to different task organization
62
+
63
+ ## Process
64
+
65
+ 1. Full project analysis
66
+ 2. Create backup file
67
+ 3. Show detailed impact
68
+ 4. Require confirmation
69
+ 5. Execute removal
70
+ 6. Generate summary report
71
+
72
+ ## Alternative Suggestions
73
+
74
+ Before clearing all:
75
+ - Export subtasks to file
76
+ - Clear only pending subtasks
77
+ - Clear by task category
78
+ - Archive instead of delete
79
+
80
+ ## Post-Clear Report
81
+
82
+ ```
83
+ Global Subtask Clear Complete
84
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━
85
+ Removed: 47 subtasks from 12 tasks
86
+ Backup saved: .taskmaster/backup/subtasks-20240115.json
87
+ Parent tasks updated: 12
88
+ Time estimates adjusted: Yes
89
+
90
+ Next steps:
91
+ - Review updated task list
92
+ - Re-expand complex tasks as needed
93
+ - Check project timeline
94
+ ```