Skip to content

Commit 3c2e901

Browse files
SimplicityGuyclaude
andcommitted
fix: reduce flush queue log spam with rate limiting and exponential backoff
- Add rate limiting for flush queue warnings (once per minute) - Implement exponential backoff for retry attempts (30s initial, 5m max) - Reduce system backpressure by delaying retries appropriately - Only retry when there are still pending messages to flush This prevents the logs from being flooded with "Flush queue is full" warnings and gives the system time to recover during high load periods. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent ab338b2 commit 3c2e901

49 files changed

Lines changed: 3934 additions & 8 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.claude/TM_COMMANDS_GUIDE.md

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
1+
# Task Master Commands for Claude Code
2+
3+
Complete guide to using Task Master through Claude Code's slash commands.
4+
5+
## Overview
6+
7+
All Task Master functionality is available through the `/project:tm/` namespace with natural language support and intelligent features.
8+
9+
## Quick Start
10+
11+
```bash
12+
# Install Task Master
13+
/project:tm/setup/quick-install
14+
15+
# Initialize project
16+
/project:tm/init/quick
17+
18+
# Parse requirements
19+
/project:tm/parse-prd requirements.md
20+
21+
# Start working
22+
/project:tm/next
23+
```
24+
25+
## Command Structure
26+
27+
Commands are organized hierarchically to match Task Master's CLI:
28+
29+
- Main commands at `/project:tm/[command]`
30+
- Subcommands for specific operations `/project:tm/[command]/[subcommand]`
31+
- Natural language arguments accepted throughout
32+
33+
## Complete Command Reference
34+
35+
### Setup & Configuration
36+
37+
- `/project:tm/setup/install` - Full installation guide
38+
- `/project:tm/setup/quick-install` - One-line install
39+
- `/project:tm/init` - Initialize project
40+
- `/project:tm/init/quick` - Quick init with -y
41+
- `/project:tm/models` - View AI config
42+
- `/project:tm/models/setup` - Configure AI
43+
44+
### Task Generation
45+
46+
- `/project:tm/parse-prd` - Generate from PRD
47+
- `/project:tm/parse-prd/with-research` - Enhanced parsing
48+
- `/project:tm/generate` - Create task files
49+
50+
### Task Management
51+
52+
- `/project:tm/list` - List with natural language filters
53+
- `/project:tm/list/with-subtasks` - Hierarchical view
54+
- `/project:tm/list/by-status <status>` - Filter by status
55+
- `/project:tm/show <id>` - Task details
56+
- `/project:tm/add-task` - Create task
57+
- `/project:tm/update` - Update tasks
58+
- `/project:tm/remove-task` - Delete task
59+
60+
### Status Management
61+
62+
- `/project:tm/set-status/to-pending <id>`
63+
- `/project:tm/set-status/to-in-progress <id>`
64+
- `/project:tm/set-status/to-done <id>`
65+
- `/project:tm/set-status/to-review <id>`
66+
- `/project:tm/set-status/to-deferred <id>`
67+
- `/project:tm/set-status/to-cancelled <id>`
68+
69+
### Task Analysis
70+
71+
- `/project:tm/analyze-complexity` - AI analysis
72+
- `/project:tm/complexity-report` - View report
73+
- `/project:tm/expand <id>` - Break down task
74+
- `/project:tm/expand/all` - Expand all complex
75+
76+
### Dependencies
77+
78+
- `/project:tm/add-dependency` - Add dependency
79+
- `/project:tm/remove-dependency` - Remove dependency
80+
- `/project:tm/validate-dependencies` - Check issues
81+
- `/project:tm/fix-dependencies` - Auto-fix
82+
83+
### Workflows
84+
85+
- `/project:tm/workflows/smart-flow` - Adaptive workflows
86+
- `/project:tm/workflows/pipeline` - Chain commands
87+
- `/project:tm/workflows/auto-implement` - AI implementation
88+
89+
### Utilities
90+
91+
- `/project:tm/status` - Project dashboard
92+
- `/project:tm/next` - Next task recommendation
93+
- `/project:tm/utils/analyze` - Project analysis
94+
- `/project:tm/learn` - Interactive help
95+
96+
## Key Features
97+
98+
### Natural Language Support
99+
100+
All commands understand natural language:
101+
102+
```
103+
/project:tm/list pending high priority
104+
/project:tm/update mark 23 as done
105+
/project:tm/add-task implement OAuth login
106+
```
107+
108+
### Smart Context
109+
110+
Commands analyze project state and provide intelligent suggestions based on:
111+
112+
- Current task status
113+
- Dependencies
114+
- Team patterns
115+
- Project phase
116+
117+
### Visual Enhancements
118+
119+
- Progress bars and indicators
120+
- Status badges
121+
- Organized displays
122+
- Clear hierarchies
123+
124+
## Common Workflows
125+
126+
### Daily Development
127+
128+
```
129+
/project:tm/workflows/smart-flow morning
130+
/project:tm/next
131+
/project:tm/set-status/to-in-progress <id>
132+
/project:tm/set-status/to-done <id>
133+
```
134+
135+
### Task Breakdown
136+
137+
```
138+
/project:tm/show <id>
139+
/project:tm/expand <id>
140+
/project:tm/list/with-subtasks
141+
```
142+
143+
### Sprint Planning
144+
145+
```
146+
/project:tm/analyze-complexity
147+
/project:tm/workflows/pipeline init → expand/all → status
148+
```
149+
150+
## Migration from Old Commands
151+
152+
| Old | New |
153+
|-----|-----|
154+
| `/project:task-master:list` | `/project:tm/list` |
155+
| `/project:task-master:complete` | `/project:tm/set-status/to-done` |
156+
| `/project:workflows:auto-implement` | `/project:tm/workflows/auto-implement` |
157+
158+
## Tips
159+
160+
1. Use `/project:tm/` + Tab for command discovery
161+
1. Natural language is supported everywhere
162+
1. Commands provide smart defaults
163+
1. Chain commands for automation
164+
1. Check `/project:tm/learn` for interactive help
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
Add a dependency between tasks.
2+
3+
Arguments: $ARGUMENTS
4+
5+
Parse the task IDs to establish dependency relationship.
6+
7+
## Adding Dependencies
8+
9+
Creates a dependency where one task must be completed before another can start.
10+
11+
## Argument Parsing
12+
13+
Parse natural language or IDs:
14+
15+
- "make 5 depend on 3" → task 5 depends on task 3
16+
- "5 needs 3" → task 5 depends on task 3
17+
- "5 3" → task 5 depends on task 3
18+
- "5 after 3" → task 5 depends on task 3
19+
20+
## Execution
21+
22+
```bash
23+
task-master add-dependency --id=<task-id> --depends-on=<dependency-id>
24+
```
25+
26+
## Validation
27+
28+
Before adding:
29+
30+
1. **Verify both tasks exist**
31+
1. **Check for circular dependencies**
32+
1. **Ensure dependency makes logical sense**
33+
1. **Warn if creating complex chains**
34+
35+
## Smart Features
36+
37+
- Detect if dependency already exists
38+
- Suggest related dependencies
39+
- Show impact on task flow
40+
- Update task priorities if needed
41+
42+
## Post-Addition
43+
44+
After adding dependency:
45+
46+
1. Show updated dependency graph
47+
1. Identify any newly blocked tasks
48+
1. Suggest task order changes
49+
1. Update project timeline
50+
51+
## Example Flows
52+
53+
```
54+
/project:tm/add-dependency 5 needs 3
55+
→ Task #5 now depends on Task #3
56+
→ Task #5 is now blocked until #3 completes
57+
→ Suggested: Also consider if #5 needs #4
58+
```
Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
Add a subtask to a parent task.
2+
3+
Arguments: $ARGUMENTS
4+
5+
Parse arguments to create a new subtask or convert existing task.
6+
7+
## Adding Subtasks
8+
9+
Creates subtasks to break down complex parent tasks into manageable pieces.
10+
11+
## Argument Parsing
12+
13+
Flexible natural language:
14+
15+
- "add subtask to 5: implement login form"
16+
- "break down 5 with: setup, implement, test"
17+
- "subtask for 5: handle edge cases"
18+
- "5: validate user input" → adds subtask to task 5
19+
20+
## Execution Modes
21+
22+
### 1. Create New Subtask
23+
24+
```bash
25+
task-master add-subtask --parent=<id> --title="<title>" --description="<desc>"
26+
```
27+
28+
### 2. Convert Existing Task
29+
30+
```bash
31+
task-master add-subtask --parent=<id> --task-id=<existing-id>
32+
```
33+
34+
## Smart Features
35+
36+
1. **Automatic Subtask Generation**
37+
38+
- If title contains "and" or commas, create multiple
39+
- Suggest common subtask patterns
40+
- Inherit parent's context
41+
42+
1. **Intelligent Defaults**
43+
44+
- Priority based on parent
45+
- Appropriate time estimates
46+
- Logical dependencies between subtasks
47+
48+
1. **Validation**
49+
50+
- Check parent task complexity
51+
- Warn if too many subtasks
52+
- Ensure subtask makes sense
53+
54+
## Creation Process
55+
56+
1. Parse parent task context
57+
1. Generate subtask with ID like "5.1"
58+
1. Set appropriate defaults
59+
1. Link to parent task
60+
1. Update parent's time estimate
61+
62+
## Example Flows
63+
64+
```
65+
/project:tm/add-subtask to 5: implement user authentication
66+
→ Created subtask #5.1: "implement user authentication"
67+
→ Parent task #5 now has 1 subtask
68+
→ Suggested next subtasks: tests, documentation
69+
70+
/project:tm/add-subtask 5: setup, implement, test
71+
→ Created 3 subtasks:
72+
#5.1: setup
73+
#5.2: implement
74+
#5.3: test
75+
```
76+
77+
## Post-Creation
78+
79+
- Show updated task hierarchy
80+
- Suggest logical next subtasks
81+
- Update complexity estimates
82+
- Recommend subtask order
Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
Convert an existing task into a subtask.
2+
3+
Arguments: $ARGUMENTS
4+
5+
Parse parent ID and task ID to convert.
6+
7+
## Task Conversion
8+
9+
Converts an existing standalone task into a subtask of another task.
10+
11+
## Argument Parsing
12+
13+
- "move task 8 under 5"
14+
- "make 8 a subtask of 5"
15+
- "nest 8 in 5"
16+
- "5 8" → make task 8 a subtask of task 5
17+
18+
## Execution
19+
20+
```bash
21+
task-master add-subtask --parent=<parent-id> --task-id=<task-to-convert>
22+
```
23+
24+
## Pre-Conversion Checks
25+
26+
1. **Validation**
27+
28+
- Both tasks exist and are valid
29+
- No circular parent relationships
30+
- Task isn't already a subtask
31+
- Logical hierarchy makes sense
32+
33+
1. **Impact Analysis**
34+
35+
- Dependencies that will be affected
36+
- Tasks that depend on converting task
37+
- Priority alignment needed
38+
- Status compatibility
39+
40+
## Conversion Process
41+
42+
1. Change task ID from "8" to "5.1" (next available)
43+
1. Update all dependency references
44+
1. Inherit parent's context where appropriate
45+
1. Adjust priorities if needed
46+
1. Update time estimates
47+
48+
## Smart Features
49+
50+
- Preserve task history
51+
- Maintain dependencies
52+
- Update all references
53+
- Create conversion log
54+
55+
## Example
56+
57+
```
58+
/project:tm/add-subtask/from-task 5 8
59+
→ Converting: Task #8 becomes subtask #5.1
60+
→ Updated: 3 dependency references
61+
→ Parent task #5 now has 1 subtask
62+
→ Note: Subtask inherits parent's priority
63+
64+
Before: #8 "Implement validation" (standalone)
65+
After: #5.1 "Implement validation" (subtask of #5)
66+
```
67+
68+
## Post-Conversion
69+
70+
- Show new task hierarchy
71+
- List updated dependencies
72+
- Verify project integrity
73+
- Suggest related conversions

0 commit comments

Comments
 (0)