Skip to content

fix(courses): instruct explicit --attest for reflection checkpoints in all seven tool courses - #113

Merged
xxg1413 merged 1 commit into
masterfrom
fix/lesson-claim-instructions
Nov 4, 2026
Merged

xxg1413 merged 1 commit into
masterfrom
fix/lesson-claim-instructions

Conversation

@xxg1413

@xxg1413 xxg1413 commented Nov 4, 2026

Copy link
Copy Markdown
Member

Problem

The six legacy tool courses (Claude Code, Cursor, DeepSeek Harness, Kimi Code, Codex, ZCode) told learners that the default python verify.py output already contains the L01/L02 claim codes. The verifier requires explicit --attest for self-reported checkpoints, so following the lessons literally never printed the promised codes. L05 said "claim it when you can answer" without giving the command.

Fix

  • L01 (all seven tool courses, EN+ZH): state the default shows [pending] with no code, then instruct python verify.py --attest l01 after answering the checkpoint questions; explain exit code 1 while other checkpoints remain open and that attestations are not persisted between runs.
  • L02 (six legacy courses, EN+ZH): replace "claim code prints when you can answer" with the explicit --attest l02 command (wording matches the Copilot course, which was already correct).
  • L05 (six legacy courses, EN+ZH): give the explicit --attest l05 command.
  • COURSE.md/COURSE_cn.md (all seven): the verify.py teaching contract now describes [passed] vs [attested], non-persistent attestations, exit-code semantics, and the full-attestation completion example; fixed merged Honesty bullet formatting.
  • Bumped content_version and reviewed_on on all touched documents; content-manifest.json regenerated.

Verification

  • make check green: 146 tests, 15 course contracts, 5 examples, 2 paths, all generated artifacts current.
  • Clean-copy behavior tests on all seven courses: default run shows reflections [pending] with no codes; --attest l01 --attest l02 attests exactly those two with codes while l05 stays pending; full flags after implementing the starter exit 0 with all five codes. Every documented command in L01/L02/L05 matches this behavior in both languages.

Verifiers and course code are unchanged; this is a documentation-accuracy fix only.

@xxg1413
xxg1413 merged commit 78e8bf7 into master Nov 4, 2026
2 checks passed
@xxg1413
xxg1413 deleted the fix/lesson-claim-instructions branch November 4, 2026 05:24
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