mirror of
https://github.com/getsentry/sentry-for-ai.git
synced 2026-09-14 14:28:22 +08:00
Sergiy Dybskiy
dceee65d6c
A skill ships only what its references.yml declares, so a reference doc that links a sibling the manifest omits reads fine in this repo and dangles in every published plugin. 46 pointers were broken in the built output — the agent is told "see data-scrubbing.md" and finds nothing there. Two distinct causes: - `search-query-language.md` lives at references/ root, but six concepts/ docs linked it as a sibling. Fixed to `../search-query-language.md`. - The concepts/ docs cross-link each other, while the manifests hand-picked a subset. Each of the three manifests now takes `concepts/*.md` whole. The docs are small and hydration only puts files on disk — nothing is read until a pointer is followed — so presence costs nothing and SKILL.md still decides what gets read. The lean per-SDK scoping in sentry-get-started is unchanged. - sdks/index.md linked STRUCTURE.md, which is marked internal and deliberately never shipped. Dropped the pointer; the format contract is for maintainers, who read it in the repo. To keep it fixed, `check_skill_links` now runs at the end of all four plugin builds and fails on any Markdown link that doesn't resolve in the built tree. It runs last, against the plugin root, so breadcrumbs to ../../SKILL_TREE.md are checked where they actually land. Verified: all four builds pass, and the check fails as intended when a broken link is introduced. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>