Skip to content

Commit 2f31a19

Browse files
richlanderclaude
andcommitted
Document non-existent relations to prevent common LLM mistakes
Add guidance about `next` and `latest_sts` relations that don't exist in the schema. LLMs were guessing these relations during testing. The graph is designed for backward navigation from the present using `latest*` entry points and `prev`/`prev-security` traversal. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
1 parent 59bb38f commit 2f31a19

File tree

2 files changed

+27
-0
lines changed

2 files changed

+27
-0
lines changed

release-notes/skills/SKILL.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,3 +52,21 @@ Each `_embedded.latest_patches[]` entry has `_links` for 2-fetch navigation:
5252
- `release-major` → version index (breaking changes, TFMs, OS support)
5353
- `latest-sdk` → SDK index (feature bands, downloads)
5454
- `latest-security` → last security patch for that version
55+
56+
## Key Relations
57+
58+
From `llms.json._links`:
59+
60+
| Relation | Purpose |
61+
|----------|---------|
62+
| `latest` | Newest supported release (LTS or STS) |
63+
| `latest-lts` | Newest LTS release |
64+
| `latest-security-month` | Current security month index |
65+
| `releases-index` | Full version list including EOL |
66+
67+
**Relations that do NOT exist** (common mistakes):
68+
69+
| Relation | Why It Doesn't Exist |
70+
|----------|---------------------|
71+
| `next` | Navigate backwards from present — start at `latest*`, walk back with `prev` |
72+
| `latest_sts` | Not useful — use `latest` if STS is acceptable |

release-notes/skills/navigation.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,15 @@ From version index:
111111
target-frameworks-json ──► TFMs
112112
```
113113

114+
## Non-Existent Relations (Common LLM Mistakes)
115+
116+
These relations do **not exist** — do not attempt to use them:
117+
118+
| Relation | Why It Doesn't Exist |
119+
|----------|---------------------|
120+
| `next` | The graph is designed for backward navigation from the present. Use `latest`, `latest-lts`, or `latest-security-month` to start at the most recent asset, then walk backwards with `prev` or `prev-security`. This is more efficient since most queries care about recent data. |
121+
| `latest_sts` | Not useful — we always have an LTS release in support, but not always an STS. If STS is acceptable, use `latest` which returns the newest release regardless of type. |
122+
114123
## Fetch Count Summary
115124

116125
| Pattern | Fetches | Notes |

0 commit comments

Comments
 (0)