@damper/mcp 0.3.4 → 0.3.5

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 (2) hide show
  1. package/README.md +26 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -259,6 +259,32 @@ When you start a task, it's locked to prevent other agents from working on it si
259
259
  - Different agent starting → fails with 409 (use `force: true` to take over)
260
260
  - Complete or abandon → releases lock
261
261
 
262
+ ### Recommended Workflow
263
+
264
+ When working on tasks, follow this workflow for best results:
265
+
266
+ 1. **Start**: `start_task` → locks the task and returns project context
267
+ 2. **Log start**: `add_note` with "Session started: <your goal>"
268
+ 3. **Work**: Make changes, logging commits and decisions with `add_note`
269
+ 4. **Log end**: `add_note` with "Session end: <summary, next steps>"
270
+ 5. **Finish**: `complete_task` (done) or `abandon_task` (stopping)
271
+
272
+ **Note types to log:**
273
+ - Session start: `"Session started: implementing dark mode"`
274
+ - Commits: `"Committed abc123: Added theme provider"`
275
+ - Decisions: `"Decision: Using CSS variables because..."`
276
+ - Session end: `"Session end: Done theme provider, remaining: toggle UI"`
277
+
278
+ **Before completing:**
279
+ - Push all commits
280
+ - Log session end note
281
+ - Check if project context docs need updating
282
+
283
+ **Before abandoning:**
284
+ - Push any WIP commits
285
+ - Log session end with progress, blockers, next steps
286
+ - Provide summary for handoff
287
+
262
288
  ## Usage Examples
263
289
 
264
290
  ### Tasks
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@damper/mcp",
3
- "version": "0.3.4",
3
+ "version": "0.3.5",
4
4
  "description": "MCP server for Damper task management",
5
5
  "author": "Damper <hello@usedamper.com>",
6
6
  "repository": {