Skip to content

Agent-memory spec + Ledger categories and gate-labeling fix in the guide#4

Open
Carr1005 wants to merge 2 commits into
mainfrom
agent-memory-spec
Open

Agent-memory spec + Ledger categories and gate-labeling fix in the guide#4
Carr1005 wants to merge 2 commits into
mainfrom
agent-memory-spec

Conversation

@Carr1005

Copy link
Copy Markdown
Collaborator

Summary

  • Spec-generation guide: rework the Decision Ledger surfacing bar into five explicit entry routes (design-argued / design-structural / realization / contradicted / learner) recorded in a new Category column, with a fixed row order (design → realization → learner → contradicted) so the §0 gate presents the highest-judgment decisions first. Learner-context invariants now carry the pattern's capability requirements (e.g. "model must support native tool calling") instead of being always-empty.
  • §0 gate labeling fix (observed in a real build run): the gate template only said to mark the course default, so a build agent following AskUserQuestion's own conventions labeled it "(Recommended)" — implying the course's choice is advice for the learner's project. The template (and its rationale bullet) now name the required label "(course default)" and forbid "(Recommended)" explicitly.
  • New: courses/agent-memory-building-memory-aware-agents/spec.md — generated by /generate-spec in an isolated clean-context agent from materials/notebooks + transcripts only (audited: no builds/, evals/, prior specs, or web reads). 18-row Decision Ledger, 13 business rules, 17 ACs, Course Context Pack, and the labeling fix applied to its §0 gate.

Test plan

  • /prepare-build + a build run against this spec presents §0 options labeled "(course default)", not "(Recommended)"
  • Next /generate-spec run on any course emits the updated §0 template verbatim

🤖 Generated with Claude Code

Carr1005 and others added 2 commits July 15, 2026 23:07
Rework the Decision Ledger's surfacing bar into five explicit entry
routes (design-argued / design-structural / realization / contradicted /
learner), each recorded in a new Category column, with a fixed
presentation order so the highest-judgment decisions reach the human
first. Learner-context invariants now carry the pattern's capability
requirements instead of being always-empty.

Also close a real-run labeling leak in the §0 gate: the template only
said to mark the course default, so a build agent following Claude
Code's AskUserQuestion conventions tagged it "(Recommended)" instead.
The template now names the required label "(course default)" and
forbids "(Recommended)" explicitly.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Generated by /generate-spec in an isolated clean-context agent from
materials/notebooks + transcripts only (no builds/, evals/, or prior
specs read). Includes the §0 gate labeling fix so options are presented
as "(course default)", never "(Recommended)".

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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