data_porter 0.1.0 → 0.2.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 (113) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +13 -1
  3. data/README.md +15 -5
  4. data/ROADMAP.md +71 -0
  5. data/app/models/data_porter/data_import.rb +1 -1
  6. data/app/views/data_porter/imports/index.html.erb +1 -1
  7. data/app/views/data_porter/imports/new.html.erb +1 -1
  8. data/lib/data_porter/configuration.rb +1 -1
  9. data/lib/data_porter/sources/xlsx.rb +68 -0
  10. data/lib/data_porter/sources.rb +3 -1
  11. data/lib/data_porter/version.rb +1 -1
  12. metadata +19 -104
  13. data/.claude/commands/blog-status.md +0 -10
  14. data/.claude/commands/blog.md +0 -109
  15. data/.claude/commands/task-done.md +0 -27
  16. data/.claude/commands/tm/add-dependency.md +0 -58
  17. data/.claude/commands/tm/add-subtask.md +0 -79
  18. data/.claude/commands/tm/add-task.md +0 -81
  19. data/.claude/commands/tm/analyze-complexity.md +0 -124
  20. data/.claude/commands/tm/analyze-project.md +0 -100
  21. data/.claude/commands/tm/auto-implement-tasks.md +0 -100
  22. data/.claude/commands/tm/command-pipeline.md +0 -80
  23. data/.claude/commands/tm/complexity-report.md +0 -120
  24. data/.claude/commands/tm/convert-task-to-subtask.md +0 -74
  25. data/.claude/commands/tm/expand-all-tasks.md +0 -52
  26. data/.claude/commands/tm/expand-task.md +0 -52
  27. data/.claude/commands/tm/fix-dependencies.md +0 -82
  28. data/.claude/commands/tm/help.md +0 -101
  29. data/.claude/commands/tm/init-project-quick.md +0 -49
  30. data/.claude/commands/tm/init-project.md +0 -53
  31. data/.claude/commands/tm/install-taskmaster.md +0 -118
  32. data/.claude/commands/tm/learn.md +0 -106
  33. data/.claude/commands/tm/list-tasks-by-status.md +0 -42
  34. data/.claude/commands/tm/list-tasks-with-subtasks.md +0 -30
  35. data/.claude/commands/tm/list-tasks.md +0 -46
  36. data/.claude/commands/tm/next-task.md +0 -69
  37. data/.claude/commands/tm/parse-prd-with-research.md +0 -51
  38. data/.claude/commands/tm/parse-prd.md +0 -52
  39. data/.claude/commands/tm/project-status.md +0 -67
  40. data/.claude/commands/tm/quick-install-taskmaster.md +0 -23
  41. data/.claude/commands/tm/remove-all-subtasks.md +0 -94
  42. data/.claude/commands/tm/remove-dependency.md +0 -65
  43. data/.claude/commands/tm/remove-subtask.md +0 -87
  44. data/.claude/commands/tm/remove-subtasks.md +0 -89
  45. data/.claude/commands/tm/remove-task.md +0 -110
  46. data/.claude/commands/tm/setup-models.md +0 -52
  47. data/.claude/commands/tm/show-task.md +0 -85
  48. data/.claude/commands/tm/smart-workflow.md +0 -58
  49. data/.claude/commands/tm/sync-readme.md +0 -120
  50. data/.claude/commands/tm/tm-main.md +0 -147
  51. data/.claude/commands/tm/to-cancelled.md +0 -58
  52. data/.claude/commands/tm/to-deferred.md +0 -50
  53. data/.claude/commands/tm/to-done.md +0 -47
  54. data/.claude/commands/tm/to-in-progress.md +0 -39
  55. data/.claude/commands/tm/to-pending.md +0 -35
  56. data/.claude/commands/tm/to-review.md +0 -43
  57. data/.claude/commands/tm/update-single-task.md +0 -122
  58. data/.claude/commands/tm/update-task.md +0 -75
  59. data/.claude/commands/tm/update-tasks-from-id.md +0 -111
  60. data/.claude/commands/tm/validate-dependencies.md +0 -72
  61. data/.claude/commands/tm/view-models.md +0 -52
  62. data/.env.example +0 -12
  63. data/.mcp.json +0 -24
  64. data/.taskmaster/CLAUDE.md +0 -435
  65. data/.taskmaster/config.json +0 -44
  66. data/.taskmaster/docs/prd.txt +0 -2044
  67. data/.taskmaster/state.json +0 -6
  68. data/.taskmaster/tasks/task_001.md +0 -19
  69. data/.taskmaster/tasks/task_002.md +0 -19
  70. data/.taskmaster/tasks/task_003.md +0 -19
  71. data/.taskmaster/tasks/task_004.md +0 -19
  72. data/.taskmaster/tasks/task_005.md +0 -19
  73. data/.taskmaster/tasks/task_006.md +0 -19
  74. data/.taskmaster/tasks/task_007.md +0 -19
  75. data/.taskmaster/tasks/task_008.md +0 -19
  76. data/.taskmaster/tasks/task_009.md +0 -19
  77. data/.taskmaster/tasks/task_010.md +0 -19
  78. data/.taskmaster/tasks/task_011.md +0 -19
  79. data/.taskmaster/tasks/task_012.md +0 -19
  80. data/.taskmaster/tasks/task_013.md +0 -19
  81. data/.taskmaster/tasks/task_014.md +0 -19
  82. data/.taskmaster/tasks/task_015.md +0 -19
  83. data/.taskmaster/tasks/task_016.md +0 -19
  84. data/.taskmaster/tasks/task_017.md +0 -19
  85. data/.taskmaster/tasks/task_018.md +0 -19
  86. data/.taskmaster/tasks/task_019.md +0 -19
  87. data/.taskmaster/tasks/task_020.md +0 -19
  88. data/.taskmaster/tasks/tasks.json +0 -299
  89. data/.taskmaster/templates/example_prd.txt +0 -47
  90. data/.taskmaster/templates/example_prd_rpg.txt +0 -511
  91. data/CLAUDE.md +0 -65
  92. data/config/database.yml +0 -3
  93. data/docs/SPEC.md +0 -2012
  94. data/docs/UI.md +0 -32
  95. data/docs/blog/001-why-build-a-data-import-engine.md +0 -166
  96. data/docs/blog/002-scaffolding-a-rails-engine.md +0 -188
  97. data/docs/blog/003-configuration-dsl.md +0 -222
  98. data/docs/blog/004-store-model-jsonb.md +0 -237
  99. data/docs/blog/005-target-dsl.md +0 -284
  100. data/docs/blog/006-parsing-csv-sources.md +0 -300
  101. data/docs/blog/007-orchestrator.md +0 -247
  102. data/docs/blog/008-actioncable-stimulus.md +0 -376
  103. data/docs/blog/009-phlex-ui-components.md +0 -446
  104. data/docs/blog/010-controllers-routing.md +0 -374
  105. data/docs/blog/011-generators.md +0 -364
  106. data/docs/blog/012-json-api-sources.md +0 -323
  107. data/docs/blog/013-testing-rails-engine.md +0 -618
  108. data/docs/blog/014-dry-run.md +0 -307
  109. data/docs/blog/015-publishing-retro.md +0 -264
  110. data/docs/blog/016-erb-view-templates.md +0 -431
  111. data/docs/blog/017-showcase-final-retro.md +0 -220
  112. data/docs/blog/BACKLOG.md +0 -8
  113. data/docs/blog/SERIES.md +0 -154
@@ -1,74 +0,0 @@
1
- Convert Task To Subtask
2
-
3
- Arguments: $ARGUMENTS
4
- Convert an existing task into a subtask.
5
-
6
- Arguments: $ARGUMENTS
7
-
8
- Parse parent ID and task ID to convert.
9
-
10
- ## Task Conversion
11
-
12
- Converts an existing standalone task into a subtask of another task.
13
-
14
- ## Argument Parsing
15
-
16
- - "move task 8 under 5"
17
- - "make 8 a subtask of 5"
18
- - "nest 8 in 5"
19
- - "5 8" → make task 8 a subtask of task 5
20
-
21
- ## Execution
22
-
23
- ```bash
24
- task-master add-subtask --parent=<parent-id> --task-id=<task-to-convert>
25
- ```
26
-
27
- ## Pre-Conversion Checks
28
-
29
- 1. **Validation**
30
- - Both tasks exist and are valid
31
- - No circular parent relationships
32
- - Task isn't already a subtask
33
- - Logical hierarchy makes sense
34
-
35
- 2. **Impact Analysis**
36
- - Dependencies that will be affected
37
- - Tasks that depend on converting task
38
- - Priority alignment needed
39
- - Status compatibility
40
-
41
- ## Conversion Process
42
-
43
- 1. Change task ID from "8" to "5.1" (next available)
44
- 2. Update all dependency references
45
- 3. Inherit parent's context where appropriate
46
- 4. Adjust priorities if needed
47
- 5. Update time estimates
48
-
49
- ## Smart Features
50
-
51
- - Preserve task history
52
- - Maintain dependencies
53
- - Update all references
54
- - Create conversion log
55
-
56
- ## Example
57
-
58
- ```
59
- /taskmaster:add-subtask/from-task 5 8
60
- → Converting: Task #8 becomes subtask #5.1
61
- → Updated: 3 dependency references
62
- → Parent task #5 now has 1 subtask
63
- → Note: Subtask inherits parent's priority
64
-
65
- Before: #8 "Implement validation" (standalone)
66
- After: #5.1 "Implement validation" (subtask of #5)
67
- ```
68
-
69
- ## Post-Conversion
70
-
71
- - Show new task hierarchy
72
- - List updated dependencies
73
- - Verify project integrity
74
- - Suggest related conversions
@@ -1,52 +0,0 @@
1
- Expand All Tasks
2
- Expand all pending tasks that need subtasks.
3
-
4
- ## Bulk Task Expansion
5
-
6
- Intelligently expands all tasks that would benefit from breakdown.
7
-
8
- ## Execution
9
-
10
- ```bash
11
- task-master expand --all
12
- ```
13
-
14
- ## Smart Selection
15
-
16
- Only expands tasks that:
17
- - Are marked as pending
18
- - Have high complexity (>5)
19
- - Lack existing subtasks
20
- - Would benefit from breakdown
21
-
22
- ## Expansion Process
23
-
24
- 1. **Analysis Phase**
25
- - Identify expansion candidates
26
- - Group related tasks
27
- - Plan expansion strategy
28
-
29
- 2. **Batch Processing**
30
- - Expand tasks in logical order
31
- - Maintain consistency
32
- - Preserve relationships
33
- - Optimize for parallelism
34
-
35
- 3. **Quality Control**
36
- - Ensure subtask quality
37
- - Avoid over-decomposition
38
- - Maintain task coherence
39
- - Update dependencies
40
-
41
- ## Options
42
-
43
- - Add `force` to expand all regardless of complexity
44
- - Add `research` for enhanced AI analysis
45
-
46
- ## Results
47
-
48
- After bulk expansion:
49
- - Summary of tasks expanded
50
- - New subtask count
51
- - Updated complexity metrics
52
- - Suggested task order
@@ -1,52 +0,0 @@
1
- Expand Task
2
-
3
- Arguments: $ARGUMENTS
4
- Break down a complex task into subtasks.
5
-
6
- Arguments: $ARGUMENTS (task ID)
7
-
8
- ## Intelligent Task Expansion
9
-
10
- Analyzes a task and creates detailed subtasks for better manageability.
11
-
12
- ## Execution
13
-
14
- ```bash
15
- task-master expand --id=$ARGUMENTS
16
- ```
17
-
18
- ## Expansion Process
19
-
20
- 1. **Task Analysis**
21
- - Review task complexity
22
- - Identify components
23
- - Detect technical challenges
24
- - Estimate time requirements
25
-
26
- 2. **Subtask Generation**
27
- - Create 3-7 subtasks typically
28
- - Each subtask 1-4 hours
29
- - Logical implementation order
30
- - Clear acceptance criteria
31
-
32
- 3. **Smart Breakdown**
33
- - Setup/configuration tasks
34
- - Core implementation
35
- - Testing components
36
- - Integration steps
37
- - Documentation updates
38
-
39
- ## Enhanced Features
40
-
41
- Based on task type:
42
- - **Feature**: Setup → Implement → Test → Integrate
43
- - **Bug Fix**: Reproduce → Diagnose → Fix → Verify
44
- - **Refactor**: Analyze → Plan → Refactor → Validate
45
-
46
- ## Post-Expansion
47
-
48
- After expansion:
49
- 1. Show subtask hierarchy
50
- 2. Update time estimates
51
- 3. Suggest implementation order
52
- 4. Highlight critical path
@@ -1,82 +0,0 @@
1
- Fix Dependencies
2
- Automatically fix dependency issues found during validation.
3
-
4
- ## Automatic Dependency Repair
5
-
6
- Intelligently fixes common dependency problems while preserving project logic.
7
-
8
- ## Execution
9
-
10
- ```bash
11
- task-master fix-dependencies
12
- ```
13
-
14
- ## What Gets Fixed
15
-
16
- ### 1. **Auto-Fixable Issues**
17
- - Remove references to deleted tasks
18
- - Break simple circular dependencies
19
- - Remove self-dependencies
20
- - Clean up duplicate dependencies
21
-
22
- ### 2. **Smart Resolutions**
23
- - Reorder dependencies to maintain logic
24
- - Suggest task merging for over-dependent tasks
25
- - Flatten unnecessary dependency chains
26
- - Remove redundant transitive dependencies
27
-
28
- ### 3. **Manual Review Required**
29
- - Complex circular dependencies
30
- - Critical path modifications
31
- - Business logic dependencies
32
- - High-impact changes
33
-
34
- ## Fix Process
35
-
36
- 1. **Analysis Phase**
37
- - Run validation check
38
- - Categorize issues by type
39
- - Determine fix strategy
40
-
41
- 2. **Execution Phase**
42
- - Apply automatic fixes
43
- - Log all changes made
44
- - Preserve task relationships
45
-
46
- 3. **Verification Phase**
47
- - Re-validate after fixes
48
- - Show before/after comparison
49
- - Highlight manual fixes needed
50
-
51
- ## Smart Features
52
-
53
- - Preserves intended task flow
54
- - Minimal disruption approach
55
- - Creates fix history/log
56
- - Suggests manual interventions
57
-
58
- ## Output Example
59
-
60
- ```
61
- Dependency Auto-Fix Report
62
- ━━━━━━━━━━━━━━━━━━━━━━━━
63
- Fixed Automatically:
64
- ✅ Removed 2 references to deleted tasks
65
- ✅ Resolved 1 self-dependency
66
- ✅ Cleaned 3 redundant dependencies
67
-
68
- Manual Review Needed:
69
- ⚠️ Complex circular dependency: #12 → #15 → #18 → #12
70
- Suggestion: Make #15 not depend on #12
71
- ⚠️ Task #45 has 8 dependencies
72
- Suggestion: Break into subtasks
73
-
74
- Run '/taskmaster:validate-dependencies' to verify fixes
75
- ```
76
-
77
- ## Safety
78
-
79
- - Preview mode available
80
- - Rollback capability
81
- - Change logging
82
- - No data loss
@@ -1,101 +0,0 @@
1
- Help
2
-
3
- Arguments: $ARGUMENTS
4
- Show help for Task Master AI commands.
5
-
6
- Arguments: $ARGUMENTS
7
-
8
- Display help for Task Master commands and available options.
9
-
10
- ## Task Master AI Command Help
11
-
12
- ### Quick Navigation
13
-
14
- Type `/taskmaster:` and use tab completion to explore all commands.
15
-
16
- ### Command Categories
17
-
18
- #### 🚀 Setup & Installation
19
- - `/taskmaster:install-taskmaster` - Comprehensive installation guide
20
- - `/taskmaster:quick-install-taskmaster` - One-line global install
21
-
22
- #### 📋 Project Setup
23
- - `/taskmaster:init-project` - Initialize new project
24
- - `/taskmaster:init-project-quick` - Quick setup with auto-confirm
25
- - `/taskmaster:view-models` - View AI configuration
26
- - `/taskmaster:setup-models` - Configure AI providers
27
-
28
- #### 🎯 Task Generation
29
- - `/taskmaster:parse-prd` - Generate tasks from PRD
30
- - `/taskmaster:parse-prd-with-research` - Enhanced parsing
31
- - `/taskmaster:generate-tasks` - Create task files
32
-
33
- #### 📝 Task Management
34
- - `/taskmaster:list-tasks` - List all tasks
35
- - `/taskmaster:list-tasks-by-status` - List tasks filtered by status
36
- - `/taskmaster:list-tasks-with-subtasks` - List tasks with subtasks
37
- - `/taskmaster:show-task` - Display task details
38
- - `/taskmaster:add-task` - Create new task
39
- - `/taskmaster:update-task` - Update single task
40
- - `/taskmaster:update-tasks-from-id` - Update multiple tasks
41
- - `/taskmaster:next-task` - Get next task recommendation
42
-
43
- #### 🔄 Status Management
44
- - `/taskmaster:to-pending` - Set task to pending
45
- - `/taskmaster:to-in-progress` - Set task to in-progress
46
- - `/taskmaster:to-done` - Set task to done
47
- - `/taskmaster:to-review` - Set task to review
48
- - `/taskmaster:to-deferred` - Set task to deferred
49
- - `/taskmaster:to-cancelled` - Set task to cancelled
50
-
51
- #### 🔍 Analysis & Breakdown
52
- - `/taskmaster:analyze-complexity` - Analyze task complexity
53
- - `/taskmaster:complexity-report` - View complexity report
54
- - `/taskmaster:expand-task` - Break down complex task
55
- - `/taskmaster:expand-all-tasks` - Expand all eligible tasks
56
-
57
- #### 🔗 Dependencies
58
- - `/taskmaster:add-dependency` - Add task dependency
59
- - `/taskmaster:remove-dependency` - Remove dependency
60
- - `/taskmaster:validate-dependencies` - Check for issues
61
- - `/taskmaster:fix-dependencies` - Auto-fix dependency issues
62
-
63
- #### 📦 Subtasks
64
- - `/taskmaster:add-subtask` - Add subtask to task
65
- - `/taskmaster:convert-task-to-subtask` - Convert task to subtask
66
- - `/taskmaster:remove-subtask` - Remove subtask
67
- - `/taskmaster:remove-subtasks` - Clear specific task subtasks
68
- - `/taskmaster:remove-all-subtasks` - Clear all subtasks
69
-
70
- #### 🗑️ Task Removal
71
- - `/taskmaster:remove-task` - Remove task permanently
72
-
73
- #### 🤖 Workflows
74
- - `/taskmaster:smart-workflow` - Intelligent workflows
75
- - `/taskmaster:command-pipeline` - Command chaining
76
- - `/taskmaster:auto-implement-tasks` - Auto-implementation
77
-
78
- #### 📊 Utilities
79
- - `/taskmaster:analyze-project` - Project analysis
80
- - `/taskmaster:project-status` - Project dashboard
81
- - `/taskmaster:sync-readme` - Sync README with tasks
82
- - `/taskmaster:learn` - Interactive learning
83
- - `/taskmaster:tm-main` - Main Task Master interface
84
-
85
- ### Quick Start Examples
86
-
87
- ```
88
- /taskmaster:list-tasks
89
- /taskmaster:show-task 1.2
90
- /taskmaster:add-task
91
- /taskmaster:next-task
92
- ```
93
-
94
- ### Getting Started
95
-
96
- 1. Install: `/taskmaster:quick-install-taskmaster`
97
- 2. Initialize: `/taskmaster:init-project-quick`
98
- 3. Learn: `/taskmaster:learn`
99
- 4. Work: `/taskmaster:smart-workflow`
100
-
101
- For detailed command info, run the specific command with `--help` or check command documentation.
@@ -1,49 +0,0 @@
1
- Init Project Quick
2
-
3
- Arguments: $ARGUMENTS
4
- Quick initialization with auto-confirmation.
5
-
6
- Arguments: $ARGUMENTS
7
-
8
- Initialize a Task Master project without prompts, accepting all defaults.
9
-
10
- ## Quick Setup
11
-
12
- ```bash
13
- task-master init -y
14
- ```
15
-
16
- ## What It Does
17
-
18
- 1. Creates `.taskmaster/` directory structure
19
- 2. Initializes empty `tasks.json`
20
- 3. Sets up default configuration
21
- 4. Uses directory name as project name
22
- 5. Skips all confirmation prompts
23
-
24
- ## Smart Defaults
25
-
26
- - Project name: Current directory name
27
- - Description: "Task Master Project"
28
- - Model config: Existing environment vars
29
- - Task structure: Standard format
30
-
31
- ## Next Steps
32
-
33
- After quick init:
34
- 1. Configure AI models if needed:
35
- ```
36
- /taskmaster:models/setup
37
- ```
38
-
39
- 2. Parse PRD if available:
40
- ```
41
- /taskmaster:parse-prd <file>
42
- ```
43
-
44
- 3. Or create first task:
45
- ```
46
- /taskmaster:add-task create initial setup
47
- ```
48
-
49
- Perfect for rapid project setup!
@@ -1,53 +0,0 @@
1
- Init Project
2
-
3
- Arguments: $ARGUMENTS
4
- Initialize a new Task Master project.
5
-
6
- Arguments: $ARGUMENTS
7
-
8
- Parse arguments to determine initialization preferences.
9
-
10
- ## Initialization Process
11
-
12
- 1. **Parse Arguments**
13
- - PRD file path (if provided)
14
- - Project name
15
- - Auto-confirm flag (-y)
16
-
17
- 2. **Project Setup**
18
- ```bash
19
- task-master init
20
- ```
21
-
22
- 3. **Smart Initialization**
23
- - Detect existing project files
24
- - Suggest project name from directory
25
- - Check for git repository
26
- - Verify AI provider configuration
27
-
28
- ## Configuration Options
29
-
30
- Based on arguments:
31
- - `quick` / `-y` → Skip confirmations
32
- - `<file.md>` → Use as PRD after init
33
- - `--name=<name>` → Set project name
34
- - `--description=<desc>` → Set description
35
-
36
- ## Post-Initialization
37
-
38
- After successful init:
39
- 1. Show project structure created
40
- 2. Verify AI models configured
41
- 3. Suggest next steps:
42
- - Parse PRD if available
43
- - Configure AI providers
44
- - Set up git hooks
45
- - Create first tasks
46
-
47
- ## Integration
48
-
49
- If PRD file provided:
50
- ```
51
- /taskmaster:init my-prd.md
52
- → Automatically runs parse-prd after init
53
- ```
@@ -1,118 +0,0 @@
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!
@@ -1,106 +0,0 @@
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>