@cwim/kanban 1.1.6 → 1.1.7
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.
- package/README.md +54 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -54,6 +54,60 @@ kanban
|
|
|
54
54
|
}
|
|
55
55
|
```
|
|
56
56
|
|
|
57
|
+
## Making Claude Use It
|
|
58
|
+
|
|
59
|
+
Just installing the MCP isn't enough — Claude needs instructions to use it.
|
|
60
|
+
|
|
61
|
+
Add a `CLAUDE.md` file to your project root:
|
|
62
|
+
|
|
63
|
+
```markdown
|
|
64
|
+
## Task Tracking
|
|
65
|
+
Use the cwim-kanban MCP to track all work in this project.
|
|
66
|
+
|
|
67
|
+
### Workflow
|
|
68
|
+
1. **Before starting**: Call `task_recall` with what you're about to work on
|
|
69
|
+
2. **Starting a task**: Create or move to `in-progress`
|
|
70
|
+
3. **Making progress**: Append notes with discoveries, decisions, or blockers
|
|
71
|
+
4. **Finishing**: Move to `done` and append a summary note
|
|
72
|
+
5. **Blocked**: Move to `blocked` with a note explaining why
|
|
73
|
+
|
|
74
|
+
### Example
|
|
75
|
+
```
|
|
76
|
+
// Check if we have existing context
|
|
77
|
+
task_recall({ context: "refactoring auth middleware" })
|
|
78
|
+
|
|
79
|
+
// Create or update task
|
|
80
|
+
task_create({
|
|
81
|
+
title: "Refactor auth middleware",
|
|
82
|
+
description: "Extract JWT validation into separate module",
|
|
83
|
+
status: "in-progress",
|
|
84
|
+
tags: ["refactor", "auth"]
|
|
85
|
+
})
|
|
86
|
+
|
|
87
|
+
// Append progress notes
|
|
88
|
+
task_append_note({
|
|
89
|
+
id: "tf-abc123",
|
|
90
|
+
note: "Discovered edge case with refresh tokens"
|
|
91
|
+
})
|
|
92
|
+
|
|
93
|
+
// Mark complete
|
|
94
|
+
task_move({ id: "tf-abc123", status: "done" })
|
|
95
|
+
task_append_note({
|
|
96
|
+
id: "tf-abc123",
|
|
97
|
+
note: "Completed: Extracted JWT validation, all tests passing"
|
|
98
|
+
})
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Rules
|
|
102
|
+
- Always check for existing tasks before creating new ones
|
|
103
|
+
- Use tags consistently (e.g., "bug", "feature", "refactor", "docs")
|
|
104
|
+
- Append notes liberally - they build context for future sessions
|
|
105
|
+
- Move tasks to "blocked" immediately when stuck, with explanation
|
|
106
|
+
- Keep task titles concise but descriptive
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
This makes the behavior automatic — no need to ask Claude every session.
|
|
110
|
+
|
|
57
111
|
## Memory Features
|
|
58
112
|
|
|
59
113
|
### Smart Context Recall
|