Module 8: walk through GitHub PAT setup, link SSH as optional (#106) #107

2026-06-23T20:26:40-04:00

justin commented

2026-06-23 20:26:40 -04:00

Adds a concrete, GitHub-specific authentication walkthrough to the Module 8 lab, since auth is failure mode #1 and the most common first-push wall, but the lab never showed how.

What changed (`modules/08-remotes-and-hosting/README.md` only)

New lab subsection "Set up GitHub authentication (do this first)" between the "You'll need" block and Part A:
- Path 1 (PAT / HTTPS), step by step on GitHub: Settings → Developer settings → Personal access tokens → Fine-grained tokens; set expiry; select only the tasks-app repo; Contents: Read and write (calling out the write-scope 403 gotcha that ties back to failure mode #1); copy-once; paste the token at git's password prompt (invisible paste is normal); credential helper caches it.
- Path 2 (SSH), optional: links GitHub's official docs (generate key + ssh-agent, add key to account, test connection) rather than re-writing a walkthrough, per the issue.
- Pros/cons table so the learner chooses deliberately (setup, after-setup, network/ports, maintenance/rotation, risk).
- A Verify-before-publish note on the volatile GitHub UI labels.
Extended the Verify-before-publish checklist with the GitHub-specific menu path, token types, and Contents scope.
The lesson's generic "Getting a credential (the shape)" callout and the three-failure-modes section were left provider-neutral, as the issue directed.

Validation

python3 tools/build_wiki.py … renders 31 wiki files cleanly.
bash tools/check.sh PASSES (including the no-em-dash slop guard and required-section structure check).

Closes #106

🤖 Generated with Claude Code

https://claude.ai/code/session_014strzwARMpFSrdSV3wi4Ns

Adds a concrete, GitHub-specific authentication walkthrough to the Module 8 lab, since auth is failure mode #1 and the most common first-push wall, but the lab never showed *how*. ## What changed (`modules/08-remotes-and-hosting/README.md` only) - **New lab subsection "Set up GitHub authentication (do this first)"** between the "You'll need" block and Part A: - **Path 1 (PAT / HTTPS), step by step on GitHub:** Settings → Developer settings → Personal access tokens → Fine-grained tokens; set expiry; select only the `tasks-app` repo; **Contents: Read and write** (calling out the write-scope `403` gotcha that ties back to failure mode #1); copy-once; paste the token at git's password prompt (invisible paste is normal); credential helper caches it. - **Path 2 (SSH), optional:** links GitHub's official docs (generate key + ssh-agent, add key to account, test connection) rather than re-writing a walkthrough, per the issue. - **Pros/cons table** so the learner chooses deliberately (setup, after-setup, network/ports, maintenance/rotation, risk). - A **Verify-before-publish** note on the volatile GitHub UI labels. - **Extended the Verify-before-publish checklist** with the GitHub-specific menu path, token types, and Contents scope. - The lesson's generic "Getting a credential (the shape)" callout and the three-failure-modes section were left provider-neutral, as the issue directed. ## Validation - `python3 tools/build_wiki.py …` renders 31 wiki files cleanly. - `bash tools/check.sh` PASSES (including the no-em-dash slop guard and required-section structure check). Closes #106 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_014strzwARMpFSrdSV3wi4Ns

justin added 1 commit 2026-06-23 20:26:41 -04:00

Module 8: walk through GitHub PAT setup, link SSH as optional (#106 )

CI / check (pull_request) Successful in 7s

Details

2165122232

Add a concrete "Set up GitHub authentication" subsection to the Module 8
lab, before Part A. It walks the PAT/HTTPS path step by step on GitHub as
the worked example (fine-grained token, Contents: Read and write scope,
copy-once, paste-at-password-prompt), links GitHub's official SSH docs as
the optional alternative, and gives a pros/cons table so the learner can
choose deliberately. Extend the Verify-before-publish checklist with the
GitHub-specific menu path and scope labels, since those drift.

Closes #106

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_014strzwARMpFSrdSV3wi4Ns

claude merged commit 58f54ce745 into main

2026-06-23 20:32:05 -04:00

claude deleted branch claude/issue-106

2026-06-23 20:32:05 -04:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: justin/ai-workflow-course#107

Module 8: walk through GitHub PAT setup, link SSH as optional (#106) #107

What changed (modules/08-remotes-and-hosting/README.md only)

Validation

What changed (`modules/08-remotes-and-hosting/README.md` only)