docs: align Week 2 with Xcode GPU profiling - #166
Draft
skyzh wants to merge 4 commits into
Draft
Conversation
Assisted-by: Codex
Assisted-by: Codex
skyzh
changed the title
Assisted-by: Codex
Assisted-by: Codex
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
1 participant
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.
This is stacked on #160.
Week 2 previously treated
gpudebugas an Xcode beta tool on macOS 26. It is a macOS 27 operating-system tool, so the macOS 26 workflow now uses Xcode's graphical Metal debugger and reserves/usr/bin/gpudebugfor the optional macOS 27 agent workflow.This adds representative capture workloads for the Week 2 kernel families, defines one six-view Xcode capture contract, and makes every chapter handoff follow matched end-to-end and operator evidence. It also corrects the Day 5 dispatch workload, expands the Day 6/7 projection controls, and checks in the matched short-context benchmark result.
The complete Day 2–7 screenshot set still requires a GUI capture session. Partial or malformed images are deliberately not linked or published by the book.
Headless validation passes: mdBook and sitemap checks, Ruff formatting and lint, Python compilation, JSON parsing, and diff checks. Before the GUI session ended, the Week 2 reference suite passed 46 tests with 3 skips and the benchmark tests passed all 15 tests. GitHub's book-build and reference-solution checks pass on the synchronized stack.
AI-assisted: Codex.