wolfpack-mcp 1.0.14 → 1.0.15

package/dist/index.js

@@ -311,7 +311,8 @@ class WolfpackMCPServer {
                     description: 'Get a specific work item/task by ID or reference number. Returns full details including description (markdown notes). ' +
                         'Call this before updating to see current content. ' +
                         'WORKFLOW: When asked to work on an item, check its status and follow the required state transitions ' +
-                        '(pending→pull first, new→doing, blocked/ready/completed/closed→new→doing, then review when done).',
+                        '(pending→pull first, new→doing, blocked/ready/completed/closed→new→doing, then review when done). ' +
+                        'PLANNING: Check if the description contains a plan (markdown checklist). If not, APPEND one using update_work_progress - preserve all original description text and add your plan below a "---" separator.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -329,7 +330,9 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'update_work_progress',
-                    description: 'Update work item description/notes with your progress. WORKFLOW: 1) get_work_item to read current notes 2) Modify the markdown description with new findings/progress 3) Call this with the complete updated description. The full description replaces the existing one.',
+                    description: 'Update work item description/notes with your progress. WORKFLOW: 1) get_work_item to read current notes 2) Modify the markdown description with new findings/progress 3) Call this with the complete updated description. The full description replaces the existing one. ' +
+                        'CRITICAL: NEVER overwrite or remove the original description text. Preserve all existing content exactly as-is. Append your plan below a "---" separator. You may only modify content you previously added (your plan section). ' +
+                        'BEST PRACTICE: Append a plan with markdown checkboxes (- [ ] task). Check off completed tasks (- [x] task) as you progress. Include sections for: Plan (checklist), Approach (strategy), and Notes (discoveries/decisions).',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -349,8 +352,8 @@ class WolfpackMCPServer {
                         '1) For "new" items: move to "doing" when starting work. ' +
                         '2) For "pending" (backlog) items: use pull_work_item first (claims and sets to "new"), then move to "doing". ' +
                         '3) For items in "blocked", "ready", "completed", or "closed": move to "new" first, then to "doing". ' +
-                        '4) When work is complete: move to "review" (NOT "completed" - that is only for deployed work). ' +
-                        '5) If work cannot be done: move to "blocked" and add a comment explaining why. ' +
+                        '4) When work is complete: move to "review" (NOT "completed" - that is only for deployed work) and add a completion comment summarizing what was done. ' +
+                        '5) If work cannot be done: move to "blocked" and add a detailed comment explaining the blocker, what was attempted, and what is needed to unblock. ' +
                         'Statuses: "pending" (backlog), "new" (to do), "doing" (in progress), "review" (work done, pending review), ' +
                         '"ready" (reviewed, awaiting deployment), "blocked", "completed" (deployed).',
                     inputSchema: {
@@ -700,7 +703,10 @@ class WolfpackMCPServer {
                 {
                     name: 'create_work_item_comment',
                     description: 'Add a comment to a work item. Requires mcp:comments:create permission. ' +
-                        'REQUIRED: When moving an item to "blocked" status, add a comment explaining why the work cannot be done.',
+                        'USE COMMENTS FOR: 1) Blocking reasons when moving to "blocked" (what failed, what was tried, what is needed). ' +
+                        '2) Completion summaries when moving to "review" (what was done, files changed, testing notes). ' +
+                        '3) Important observations or decisions that should be visible in the activity history. ' +
+                        'USE DESCRIPTION (update_work_progress) FOR: Plans, checklists, and progress tracking that need to be updated over time.',
                     inputSchema: {
                         type: 'object',
                         properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "MCP server for Wolfpack AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",