Expand CUDA/PTX docs, improve retrieval aliases, and add search regression suite#175
Open
qhy991 wants to merge 3 commits intoandrewyng:mainfrom
Open
Expand CUDA/PTX docs, improve retrieval aliases, and add search regression suite#175qhy991 wants to merge 3 commits intoandrewyng:mainfrom
qhy991 wants to merge 3 commits intoandrewyng:mainfrom
Conversation
Improve Context Hub retrieval for PTX/CUDA instruction references by providing translated content and searchable tags. Made-with: Cursor
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add comprehensive CUDA/PTX documentation and retrieval-quality infrastructure for Context Hub, with English-only content, richer PTX reference guidance, search alias tags, and a runnable search regression suite.
Changes
Documentation Expansion
content/cuda/docs/*(shared memory, synchronization, warp primitives, WMMA/Tensor Core, CUDA Core, performance and production playbooks).content/cuda/docs/ptx-integer-bit-manipulation-patterns/DOC.mdcontent/cuda/docs/ptx-atomic-and-reduction-patterns/DOC.mdcontent/cuda/docs/ptx-mbarrier-protocol-patterns/DOC.mdcontent/cuda/docs/ptx-warp-synchronization-patterns/DOC.mdUsage Notes,Common Failure Modes, and protocol checklists.Retrieval Improvements
--lang cppretrieval paths while preserving PTX semantics.warp-matrix-multiply-accumulate,tensorcore,smem,coalesced-access,cas-loop,syncthreads.Search Regression Suite
scripts/search_regression.pyscripts/search_regression_cases.jsonscripts/search_regression_baseline.jsondocs/features/search-regression.mdWhat
This PR upgrades Context Hub from “basic CUDA/PTX coverage” to a retrieval-oriented, regression-tested documentation set designed for agent use.
Why
Problems addressed:
Testing
Content/Build Validation
./cli/bin/chub build content --validate-only-> PASSED (1622 docs, 6 skills, 0 warnings)./cli/bin/chub build content-> PASSEDSearch Regression
python3 scripts/search_regression.py --mode check-> PASSED (18/18)python3 scripts/search_regression.py --mode snapshot --snapshot-out scripts/search_regression_baseline.json-> PASSEDLanguage Consistency
rg -n "[\p{Han}]" content/cuda/docs | wc -l->0Notes