Conversation
… overlays, test what is on disk Shared and pack lessons declare verify type `tests`; the workspace language's runner (languages.<code>.verify.type) decides what runs. Each language owns one folder: content/<lang>/shared/<stage>/<lesson>/ and content/<lang>/focus/<pack>/<lesson>/ overlays hold snippets/, exercise/, solution/ and optional TUTOR.md/quiz.json; LESSON.md carries <!-- lang: <slot> --> anchors that scaffold renders per language, so a language that ships no snippet for a slot leaves the other languages' bytes untouched. exercises/<lang>/ and solutions/<lang>/ are retired. - ci is lesson-centric: every (exercise, solution) pair on disk runs for every language that carries it, regardless of language status; --language filters; skips print a reason; an empty --filter fails; strict validate runs first - pytest runs as `uv run -q --locked pytest -q`; pytest exercises must ship pyproject.toml, uv.lock and .python-version; toolchains are preflighted with an install hint instead of a traceback - is_authored is per language; shared lessons without a variant are content pending for that language in sync, status, roadmap, graph and ci - init seeds a workspace .gitignore, warns on focus packs that add nothing and on an ancestor pyproject.toml, and takes --carry-over DIR to note shared-lesson passes from another language's workspace - sync_needed derives from a composition hash of the workspace's own slice of the registry, so edits to another language no longer nag learners - validate checks the verify-type invariants, anchors and snippets, overlay layout, pytest project files, and warns on toolchain commands in a shared Exercise section or an overlay exercise without README.md - tests/test_engine.py drives a scratch copy of the engine through a synthetic curriculum (30 cases); ruff.toml pins one style for the repo
…t/go/shared overlays tools/migrate-go-overlays.py moves exercises/go/ and solutions/go/ into each lesson's Go overlay and extracts every `In Go` block of the shared LESSON.md files into snippets/<slot>.md, leaving a <!-- lang: <slot> --> anchor in place (40 lessons, 72 snippets). The script fingerprints every Go-path lesson the way the previous engine scaffolded it and again through the new engine after the move: all 112 are byte-identical, so no Go learner sees a sync. Unmarked Go prose and fences that remain in the shared theory are the shared batch's work (CONTEXT.md, Phase 6.3).
…unners languages.<code> gains verify.type (gotest, pytest) and workspace_ignore; the 22 shared and 13 pack lessons that ran go test now declare `tests`. The 24 Python stubs become the 54 lessons of the planned track (p1 17, p3 18, p5 13, p7 6) with objectives and honest verify types; Python stays `stub` until the track is authored. docs/curriculum-outline.md carries the four Python tables with a deps column and the shared-stage note.
…n authoring conventions CONTEXT.md gains decision rows 19-32, the overlay layout, verify types, per-language rendering, the Python path table, the Phase 6 checklist and the release policy; DESIGN.md explains why overlays live under content/<lang>/; the authoring guide becomes language-neutral with Python bars, layouts, self-checks and the anchor grammar; README, CONTRIBUTING, SKILL.md, the issue and PR templates, .gitignore and renovate.json follow the engine.
The validate job runs validate --strict and the engine test suite and extends the path guard. The solutions job becomes one row per language whose content changed (shared lessons, the engine, the registry, the tests and the workflow itself select both), with setup-uv pinned by SHA, a uv managed CPython 3.14, and ruff over the engine, tests, tools and Python content; an aggregate job keeps the ruleset's required check name.
…and a ci gate The three workflow scripts take a language, derive exemplar, bar, runner, formatter and markers from one LANG table, add a variant mode that writes only under a language's overlay, carry a Python review lens, and check each agent's reply for the ci summary line instead of trusting exit status.
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.
Summary
Phase 0 of the Python track (CONTEXT.md, Phase 6.0): everything the content phases depend on, with Python still
stub.tests, resolved throughlanguages.<code>.verify.type; each language owns one folder (content/<lang>/shared/...,content/<lang>/focus/...) whose overlay holdssnippets/,exercise/,solution/and optionalTUTOR.md/quiz.json;LESSON.mdanchors (<!-- lang: <slot> -->) are rendered per language at scaffold time.ciis lesson-centric and language-filterable, pytest runs asuv run -q --locked pytest -q, toolchains are preflighted,initseeds a workspace.gitignoreand takes--carry-over, andsync_neededno longer fires for other languages' registry edits.exercises/<lang>/andsolutions/<lang>/are retired.tools/migrate-go-overlays.pymoved the Go slice of all 40 shared lessons intocontent/go/shared/overlays (72 snippets). Every one of the 112 Go-path lessons renders byte-identically tomain, so existing Go workspaces see no sync.testson 35 shared/pack lessons, the 54-lesson Python track with objectives and honest verify types; outline tables to match.validate --strictplustests/test_engine.pyin CI and a go/python solutions matrix; workflow scripts with aLANGtable, avariantmode and acigate.Lessons touched
All 40 shared lessons that carried Go material (layout move only; rendered Go bytes unchanged). Registry: 35 shared/pack lessons flip
gotesttotests; 24 Python stubs replaced by 54 Python lessons.Checklist
python3 skills/tutor/scripts/tutor.py validate --strictpasses (0 errors)python3 skills/tutor/scripts/tutor.py ci --language gopasses (88 solutions tested, 0 failed, 5 machine-inspecting graders skipped as before)python3 -m unittest discover -s testspasses (30 tests)TUTOR.md,quiz.json,solution/,snippets/) updated wherever the lesson changedadaexample persona; nothing machine-specific