Refine learning-os thesis around cognitive ledgers - #46
Conversation
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 7f647fe0a3
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| | Prerequisite Ledger | What blocks advanced topics | dependency edges, readiness gates, prerequisite debt | | ||
| | Learner Graph | What the learner believes and can do | mastery, attempts, misconceptions, confidence | | ||
| | Failure-Mode Ledger | Why the learner missed | error type, repeated pattern, linked prerequisite | |
There was a problem hiding this comment.
Record an ADR before making ledgers mandatory
This makes the prerequisite and failure-mode ledgers part of the “Non-Negotiable Architecture Principle,” which changes learner-state semantics and creates durable storage/modeling boundaries, but there is no matching ADR or decision-log update. The repo’s ADR guidance requires a full ADR for significant decisions, including learner-state semantics or expensive-to-change choices, so implementation cards will now see a mandatory architecture that has not passed the governance gate.
Useful? React with 👍 / 👎.
Summary
Refines the learning-os thesis around a ledger-first model of learning.
Key changes:
Rationale
The current architecture already separates source, domain, outcome, learner, evidence, and planner layers. This update sharpens why those layers exist: to expose hidden prerequisite debt and map course materials to how a learner actually builds toward advanced topics.
Verification
thesis/cognitive-ledgersagainstmain.README.md,docs/00-project-brief.md.