Skip to content

docs: seal teaching against the final staged diff - #16

Merged
chtnnh merged 1 commit into
mainfrom
docs/teach-after-final-diff
Aug 24, 2026
Merged

docs: seal teaching against the final staged diff#16
chtnnh merged 1 commit into
mainfrom
docs/teach-after-final-diff

Conversation

@chtnnh

@chtnnh chtnnh commented Aug 24, 2026

Copy link
Copy Markdown
Owner

Closes #13

Summary

Corrects the documented know-code workflow so teaching is sealed after implementation and staging, against the final intended diff hash.

The previous order told users to run know-code taught before editing. Any subsequent implementation changed the hash and immediately invalidated that seal, creating unnecessary re-sealing and instructions that disagreed with the CLI’s artifact binding.

Documentation updates

  • Update the canonical know-code-teach sequence.
  • Move the explain-playbook sealing checkpoint to after the final intended diff is staged.
  • Align the public skills workflow table with the final-hash requirement.

Verification

  • npm run lint
  • npm run build:docs
  • git diff --check

…docs

Know-Code-Verified: ea53884420ab9b9d3935dee90c39602824b352fe040d7847c373487252689c86
@chtnnh chtnnh self-assigned this Aug 24, 2026
@chtnnh
chtnnh marked this pull request as ready for review August 24, 2026 13:23
@cursor

cursor Bot commented Aug 24, 2026

Copy link
Copy Markdown

PR Summary

Cursor Bugbot is generating a summary for commit 6bcf0d8. Configure here.

@chtnnh
chtnnh merged commit 3940547 into main Aug 24, 2026
3 checks passed
@chtnnh
chtnnh deleted the docs/teach-after-final-diff branch August 24, 2026 13:29
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.

teach guidance asks for know-code taught before the diff exists

1 participant