Skip to content

Commit c2f7889

Browse files
authored
chore(docs): update context window threshold for task handoff from 50% to 33% in task handoff guidelines (#1428)
1 parent 7094a57 commit c2f7889

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

.clinerules/98-task-handoff.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,17 @@ This guide provides **MANDATORY** instructions for effectively breaking down com
66

77
## ⚠️ CONTEXT WINDOW MONITORING - MANDATORY ACTION REQUIRED ⚠️
88

9-
You **MUST** monitor the context window usage displayed in the environment details. When usage exceeds 50% of the available context window, you **MUST** initiate a task handoff using the `new_task` tool.
9+
You **MUST** monitor the context window usage displayed in the environment details. When usage exceeds 33% of the available context window, you **MUST** initiate a task handoff using the `new_task` tool.
1010

11-
Example of context window usage over 50% with a 200K context window:
11+
Example of context window usage over 33% with a 200K context window:
1212

1313
\`\`\`text
1414
# Context Window Usage
1515
105,000 / 200,000 tokens (53%)
1616
Model: anthropic/claude-3.7-sonnet (200K context window)
1717
\`\`\`
1818

19-
**IMPORTANT**: When you see context window usage at or above 50%, you MUST:
19+
**IMPORTANT**: When you see context window usage at or above 33%, you MUST:
2020
1. Complete your current logical step
2121
2. Use the `ask_followup_question` tool to offer creating a new task
2222
3. If approved, use the `new_task` tool with comprehensive handoff instructions
@@ -79,7 +79,7 @@ You **MUST** identify natural handoff points when:
7979
- You've reached a logical stopping point in a larger subtask
8080
- The implementation is taking longer than expected and can be continued later
8181
- The task scope has expanded beyond the original plan
82-
- **CRITICAL**: The context window usage exceeds 50% (e.g., 100,000+ tokens for a 200K context window)
82+
- **CRITICAL**: The context window usage exceeds 33% (e.g., 66,667+ tokens for a 200K context window)
8383

8484
### 3. Initiating the Handoff Process - MANDATORY ACTION
8585

@@ -240,7 +240,7 @@ Please continue by implementing the login endpoint following the same patterns e
240240

241241
You **MUST** initiate task handoffs in these scenarios:
242242

243-
1. **CRITICAL**: When context window usage exceeds 50% (e.g., 100,000+ tokens for a 200K context window)
243+
1. **CRITICAL**: When context window usage exceeds 33% (e.g., 100,000+ tokens for a 200K context window)
244244
2. **Long-running projects** that exceed a single session
245245
3. **Complex implementations** with multiple distinct phases
246246
4. **When context window limitations** are approaching
@@ -249,7 +249,7 @@ You **MUST** initiate task handoffs in these scenarios:
249249

250250
**⚠️ FINAL REMINDER - CRITICAL INSTRUCTION ⚠️**
251251

252-
You **MUST** monitor the context window usage in the environment details section. When it exceeds 50% (e.g., "105,000 / 200,000 tokens (53%)"), you **MUST** proactively initiate the task handoff process using the `ask_followup_question` tool followed by the `new_task` tool. You MUST use the `new_task` tool.
252+
You **MUST** monitor the context window usage in the environment details section. When it exceeds 33% (e.g., "105,000 / 200,000 tokens (53%)"), you **MUST** proactively initiate the task handoff process using the `ask_followup_question` tool followed by the `new_task` tool. You MUST use the `new_task` tool.
253253

254254
By strictly following these guidelines, you'll ensure smooth transitions between tasks, maintain project momentum, and provide the best possible experience for users working on complex, multi-session projects.
255255
```markdown

0 commit comments

Comments
 (0)