@damper/mcp 0.3.9 → 0.3.10

package/README.md

@@ -94,6 +94,7 @@ The AI will see tools from both servers and can distinguish between them:
 | `get_module` | Get module details |
 | `update_module` | Register/update a module |
 | `sync_modules` | Bulk upload module registry |
+| `get_agent_instructions` | Get canonical workflow for CLAUDE.md setup |
 
 ### Project Context
 
@@ -332,6 +333,20 @@ When working on tasks, follow this workflow for best results:
 > Sync all my documentation to Damper
 ```
 
+## Setting Up a Project
+
+To add Damper workflow instructions to a new project:
+
+```
+> Get the agent instructions and add them to my CLAUDE.md
+```
+
+The agent will call `get_agent_instructions` and write to your CLAUDE.md file. This ensures you always have the latest workflow instructions.
+
+**Formats:**
+- `section` (default): Just the Damper workflow section - append to existing CLAUDE.md
+- `markdown`: Full file with header - use when creating a new CLAUDE.md
+
 ## Agent Instructions (CLAUDE.md)
 
 Add this to your project's `CLAUDE.md` (or `.cursorrules` for Cursor) to ensure AI agents use Damper consistently:

package/dist/index.js

@@ -631,6 +631,65 @@ server.registerTool('abandon_task', {
         structuredContent: result,
     };
 });
+// ==================== Agent Instructions ====================
+// Tool: Get agent instructions
+server.registerTool('get_agent_instructions', {
+    title: 'Get Agent Instructions',
+    description: 'Get the canonical Damper workflow instructions. ' +
+        'Use this to set up or update CLAUDE.md in a project.',
+    inputSchema: z.object({
+        format: z.enum(['markdown', 'section']).optional()
+            .describe('markdown = full file, section = just the Damper section (default: section)'),
+    }),
+    outputSchema: z.object({
+        format: z.enum(['markdown', 'section']),
+        content: z.string(),
+    }),
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async ({ format = 'section' }) => {
+    const section = `## Task Management with Damper MCP
+
+This project uses Damper MCP for task tracking. **You MUST follow this workflow.**
+
+### At Session Start (MANDATORY)
+1. \`get_project_context\` - **READ THIS FIRST.** Contains architecture, conventions, and critical project info.
+2. \`get_context_section\` - Fetch full content for sections relevant to your task
+3. \`list_tasks\` - Check for existing tasks to work on
+4. If working on a task: \`start_task\` to lock it
+
+### While Working
+- \`add_commit\` after each commit with hash and message
+- \`add_note\` for decisions: "Decision: chose X because Y"
+- \`update_subtask\` to mark subtask progress
+- **Follow patterns from project context** - Don't reinvent; use existing conventions
+
+### At Session End (MANDATORY)
+- ALWAYS call \`add_note\` with session summary before stopping
+- ALWAYS call \`complete_task\` (if done) or \`abandon_task\` (if stopping early)
+- NEVER leave a started task without completing or abandoning it
+- If you learned something about the codebase, consider updating project context
+
+### Why This Matters
+- **Project context prevents mistakes** - Contains architecture decisions, gotchas, and patterns
+- Locked tasks block other agents from working on them
+- Commits and notes help the next agent continue the work
+- Updating context saves future agents from re-analyzing the codebase`;
+    if (format === 'markdown') {
+        return {
+            content: [{ type: 'text', text: `# CLAUDE.md\n\n${section}` }],
+            structuredContent: { format: 'markdown', content: `# CLAUDE.md\n\n${section}` },
+        };
+    }
+    return {
+        content: [{ type: 'text', text: section }],
+        structuredContent: { format: 'section', content: section },
+    };
+});
 // ==================== Context Tools ====================
 // Tool: List context sections
 server.registerTool('list_context_sections', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damper/mcp",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "description": "MCP server for Damper task management",
   "author": "Damper <hello@usedamper.com>",
   "repository": {