devscribe-reason 1.0.4 → 1.0.6
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/.cursor/mcp.json +16 -0
- package/package.json +3 -2
- package/src/CLAUDE.md +11 -5
package/.cursor/mcp.json
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"mcpServers": {
|
|
3
|
+
"devscribe-reason": {
|
|
4
|
+
"command": "npx",
|
|
5
|
+
"args": [
|
|
6
|
+
"-y",
|
|
7
|
+
"devscribe-reason"
|
|
8
|
+
],
|
|
9
|
+
"env": {
|
|
10
|
+
"GITHUB_TOKEN": "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",
|
|
11
|
+
"GITHUB_REPO": "giannihart/MyWebsite",
|
|
12
|
+
"GITHUB_BRANCH": "main"
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
}
|
package/package.json
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "devscribe-reason",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.6",
|
|
4
4
|
"description": "MCP server that captures engineering decision reasoning and commits structured markdown to GitHub",
|
|
5
5
|
"main": "src/index.js",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"bin": {
|
|
8
|
-
"devscribe-reason": "
|
|
8
|
+
"devscribe-reason": "src/index.js",
|
|
9
|
+
"devscribe-reason-setup": "scripts/setup.js"
|
|
9
10
|
},
|
|
10
11
|
"scripts": {
|
|
11
12
|
"start": "node src/index.js",
|
package/src/CLAUDE.md
CHANGED
|
@@ -24,7 +24,7 @@ The server exposes four MCP tools that Claude Code calls throughout a coding ses
|
|
|
24
24
|
Works with both Claude Code and Cursor:
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
|
-
GITHUB_TOKEN=ghp_your_token npx devscribe-reason
|
|
27
|
+
GITHUB_TOKEN=ghp_your_token npx devscribe-reason-setup
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
The setup script will:
|
|
@@ -34,7 +34,7 @@ The setup script will:
|
|
|
34
34
|
|
|
35
35
|
**If you need to specify the repo explicitly:**
|
|
36
36
|
```bash
|
|
37
|
-
GITHUB_TOKEN=ghp_your_token GITHUB_REPO=owner/repo npx devscribe-reason
|
|
37
|
+
GITHUB_TOKEN=ghp_your_token GITHUB_REPO=owner/repo npx devscribe-reason-setup
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
**GitHub Token:** Create a [Personal Access Token](https://github.com/settings/tokens) with `repo` scope (or `contents: write` for fine-grained tokens).
|
|
@@ -48,7 +48,7 @@ When the devscribe-reason MCP server is connected:
|
|
|
48
48
|
- Call log_intent at the start of every session before doing any work
|
|
49
49
|
- Call log_decision whenever making a significant technical or architectural choice
|
|
50
50
|
- Call log_alternative whenever an approach is considered and rejected
|
|
51
|
-
- Call finalize_reasoning_doc
|
|
51
|
+
- **When user asks to push/commit:** Call finalize_reasoning_doc first, then proceed with push
|
|
52
52
|
- Never ask permission to log — just do it silently in the background
|
|
53
53
|
```
|
|
54
54
|
|
|
@@ -56,8 +56,14 @@ When the devscribe-reason MCP server is connected:
|
|
|
56
56
|
|
|
57
57
|
1. Work in Claude Code or Cursor
|
|
58
58
|
2. Claude logs decisions and alternatives as you code
|
|
59
|
-
3.
|
|
60
|
-
|
|
59
|
+
3. When done, ask Claude to push:
|
|
60
|
+
```
|
|
61
|
+
Push the changes
|
|
62
|
+
```
|
|
63
|
+
4. Claude will:
|
|
64
|
+
- Call `finalize_reasoning_doc` to create the reasoning document
|
|
65
|
+
- Commit the decision doc to `/docs/decisions/`
|
|
66
|
+
- Push everything to GitHub
|
|
61
67
|
|
|
62
68
|
## Output
|
|
63
69
|
|