Skip to content

Commit 77f6b32

Browse files
committed
docs(skill): add note on opting out of version pinning
1 parent 542ac13 commit 77f6b32

2 files changed

Lines changed: 13 additions & 3 deletions

File tree

.claude/skills/release/SKILL.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -136,6 +136,12 @@ That grep should return no output.
136136
Note: `.mcp.json` and `.gemini/settings.json` use `uv run openroad-mcp` (local dev
137137
mode) and have no version to pin — skip them.
138138

139+
> **Side note for users:** If you always want the latest version and prefer not
140+
> to pin, omit the `@vX.Y.Z` suffix and use the bare URL:
141+
> `git+https://github.com/luarss/openroad-mcp`. This trades supply chain
142+
> safety for convenience — acceptable for local/dev setups, not recommended
143+
> for shared or production environments.
144+
139145
**uv.lock** — Regenerate by running `uv lock`. Do NOT hand-edit this file.
140146

141147
**CHANGELOG.md** — Add new section before the previous version's section.
@@ -188,10 +194,10 @@ Do NOT push unless the user explicitly asks. The commit stays local for review.
188194
```
189195
(replace `OLD_VERSION` with the actual previous version, e.g. `0\.5\.2`)
190196
before committing, to catch any missed references
191-
- Also verify the git URL manifests were updated:
197+
- Also verify the git URL manifests and README were updated:
192198
```
193-
grep -r "openroad-mcp@" .cursor/ .vscode/ .roo/ .kilocode/ opencode.json
199+
grep -r "openroad-mcp@" README.md .cursor/ .vscode/ .roo/ .kilocode/ opencode.json
194200
```
195-
All five should show the new `@vX.Y.Z` tag
201+
All six should show the new `@vX.Y.Z` tag
196202
- If `server.json` doesn't exist, skip it (some repos may not have it)
197203
- If `ROADMAP.md` doesn't exist or has no version table, skip it

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,10 @@ The basic configuration for all MCP clients:
7878
}
7979
```
8080

81+
> **Note:** The URL above is pinned to a specific release for supply chain safety.
82+
> To always track the latest version instead, drop the `@v0.5.2` suffix:
83+
> `"git+https://github.com/luarss/openroad-mcp"`.
84+
8185
For local development, use:
8286

8387
```json

0 commit comments

Comments
 (0)