Update Builder Journal documentation references after changes to ragbits-example repository. Use when commits in ragbits-example changed and documentation SHA references need updating.
Update the Builder Journal documentation after changes to the ragbits-example repository.
curl -s "https://api.github.com/repos/deepsense-ai/ragbits-example/commits?sha=main&per_page=100" | jq -r '.[] | .sha[:7] + " " + (.commit.message | split("\n")[0])'IMPORTANT: Compare the commits above against the Current References table below. If all SHAs already match — there are no new or changed commits — report "No updates needed" and STOP. Do not proceed further.
The Builder Journal documentation lives in two repositories:
docs/builder-journal/Documentation uses dynamic GitHub references with line ranges:
--8<-- "https://raw.githubusercontent.com/deepsense-ai/ragbits-example/<SHA>/src/ragbits_example/main.py:start:end"
Commits in ragbits-example use format Section X.Y: Description:
Compare the HEAD SHA above against the Current References table. If main hasn't moved, stop.
For each changed commit, fetch and examine the file with line numbers:
curl -s 'https://raw.githubusercontent.com/deepsense-ai/ragbits-example/<SHA>/src/ragbits_example/main.py' | cat -n
Read the local documentation files in docs/builder-journal/ and update references:
:start:end) if code structure changedhl_lines attribute if highlighted lines shiftedUpdate the Current References table in this SKILL.md to match the new state.
Commit documentation changes.
| Step | Commit | Lines | Shows |
|---|---|---|---|
| 1 (class) | 944f1dc | 10:28 | Imports + ChatInterface class |
| 1 (launch) | 944f1dc | 31:33 | if __name__ block |
| 2 | 9cd7d8a | 10:32 | Full class with __init__ |
| 3 | 79dc6be | 25:36 | chat() method with streaming |
| 4 | 19716ef | 29:49 | chat() method with history |
| Complete | 19716ef | (full) | Entire file |