Skip to content

Refine learning-os thesis around cognitive ledgers - #46

Open
kmosoti wants to merge 2 commits into
mainfrom
thesis/cognitive-ledgers
Open

Refine learning-os thesis around cognitive ledgers#46
kmosoti wants to merge 2 commits into
mainfrom
thesis/cognitive-ledgers

Conversation

@kmosoti

@kmosoti kmosoti commented Jun 18, 2026

Copy link
Copy Markdown
Owner

Summary

Refines the learning-os thesis around a ledger-first model of learning.

Key changes:

  • Treats the syllabus as a delivery schedule, not a complete cognitive model.
  • Defines learning-os as a source-grounded cognitive ledger system.
  • Adds prerequisite debt, failure modes, readiness evidence, and next-action planning to the project thesis.
  • Updates the README demo target around prerequisite ledgers and failure-mode tracking.
  • Expands the project brief with thesis commitments, ledger types, and MVP completion criteria.

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

  • Compared thesis/cognitive-ledgers against main.
  • Branch is ahead by 2 commits and behind by 0.
  • Changed files: README.md, docs/00-project-brief.md.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 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".

Comment thread docs/00-project-brief.md
Comment on lines +84 to +86
| 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 |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge 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 👍 / 👎.

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