Skip to content

docs: finish the workshop (assignments as md, labs for F6/F12/F13, patterns, two-day paths) - #167

Merged
Param-Harrison merged 12 commits into
mainfrom
docs/finish-workshop
Nov 1, 2026
Merged

Param-Harrison merged 12 commits into
mainfrom
docs/finish-workshop

Conversation

@Param-Harrison

Copy link
Copy Markdown
Contributor

What

Finishes the workshop after workshop-2026-11: assignments become md files, the parked issues #149 to #156 are done, the F6, F12 and F13 labs exist, and every reader gets a two-day path.

Per phase: files, the check, the planted fault

Phase Files Check Planted fault, seen red
A assignments assignments/*.md, assignments/README.md, tests/assignments/* tests/structure/assignments.test.ts missing Walkthrough heading, Level expert, no skipIf, an assignment-x.md template
B1 (#149) docs/factory/f8-workflows.md workflows-doc.test.ts row renamed typo; extra workflow yaml
B3 (#154) f6, f7 and lab walkthroughs claim ledger: 386 ok, 3 fixed, 1 deleted n/a
B4 doc-paths.test.ts, repo-roots.ts, doc-paths.allow.ts every doc path and make target exists engine/retro.ts, make prove-all, stale allowlist entry
B5 doc-symbols.test.ts every named symbol is in code classifyy() in f6
B6 (#156) doc-links.test.ts every link and anchor resolves f99.md, #nope
B7 (#155) lab-harness.ts, lab-solutions-<lane>.test.ts one file per lane deleted start-02 solution
B8 tricks, scripts/labs/cheat-sheet.ts, docs/labs/cheat-sheet.md cheat-sheet.test.ts edited trick not regenerated; trick removed
C Stories 8 diagrams, f6, f10, f12 Stories story-quotes.test.ts 31 of 33 to 30 of 33
D labs labs/factory/08 to 10, walkthrough sections lab-solutions-factory.test.ts, lane heading test factory-09 section removed
E patterns docs/patterns.md patterns.test.ts anchor classifyy
E two days docs/learn-in-two-days.md walkthrough.test.ts Team lead without Day 2
E Principal a bullet in every Discussion walkthrough.test.ts bullet removed from f5
E run of show docs/run-of-show.md removed git grep run-of-show is empty n/a

Open items

  • docs/visual-storytelling-rest is not merged; only aa0d242 was cherry-picked. The branch goes in the prune script.
  • The dependabot astro 7 PR is closed: main is already on astro 7.4.2.
  • The private learnwithparam/teach repo (run of show, facilitator guides) follows after this merges.

Refs #149, #150, #151, #152, #153, #154, #155, #156.

🤖 Generated with Claude Code

Param-Harrison and others added 12 commits November 1, 2026 16:58
…es 152 and 153

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…ach have a test

The F8 table must match .factory/workflows, every path and make target a doc names
must exist, every camelCase symbol must be in the code, and every relative link and
anchor must resolve. Fixes found on the way: f6 cited a run.log that is not there,
f7 wrote engine/retro.ts for factory/engine/retro.ts, context.md named a function
Claude is only expected to invent.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Adds a Trick to start-03 and daily-01 to daily-04, each checked against
claude --help or the lab itself, and scripts/labs/cheat-sheet.ts that
renders them to docs/labs/cheat-sheet.md. A test holds the file to the
render and requires a trick on every start and daily lab.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Eight more hand-written SVGs: the artifact chain, risk ladder, workflow
selector, sigma loop, model routing, test ladder, spend cap and cloud
push. Every remaining module opens with a Story from a real ticket or
retro item, then a picture and a Notice caption. f6 now says interpret.ts
imports classify and APPROVALS from risk.ts, and that nothing imports
deploy.ts.

The visuals test now also fails any module with no picture.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s every quote

story-quotes.test.ts checks each double-quoted phrase in a Story against a file the Story cites,
a factory test, the retro or an assignment brief. f12 and the model-routing picture no longer say
the docs write step misses its route.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…-set test

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…w leaves the public repo

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…achine

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
A level snapshot holds just its own files, so the doc link, path, symbol,
pattern and two-day checks have nothing to read there.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@Param-Harrison
Param-Harrison merged commit a7492ba into main Nov 1, 2026
12 checks passed
@Param-Harrison
Param-Harrison deleted the docs/finish-workshop branch November 1, 2026 15:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant