Review what agents learn about a repository
Inspect a run’s unreviewed build or test lesson, approve it into repository memory, and see why CodeBook kept or reverted a proposed recipe change.
Open a factory, then Workflow settings → Factory settings → Learning. Each repository lists the workflows using it, the lessons saved by runs, and changes to its proof recipe. Use this page when a run discovers a build requirement or proposes a test command for the next run.
Review a lesson
- Find the affected repository under Lessons in use. A lesson is one short fact about installing, building, running, testing, linting or the environment. Use the displayed source run and agent to check that the fact applies to this repository.
- Choose Edit to correct the wording or topic while it remains unreviewed. Choose Approve to review the text and optionally add a title. Approval creates a repository note in Memory, where the applicable memory trial and activation rules apply. Choose Remove to stop using a mistaken lesson.
- Check No longer in use for lessons that were approved, dropped or removed. A run can save up to three lessons. CodeBook keeps at most 15 unreviewed lessons per repository, each up to 280 characters.
For example, “Run the export tests with the test database seeded first” can help a later worker reproduce the environment. Record the actual test result and commit on the story or proof run. A lesson about how to run a test does not establish that a change passed it.
Readers with factory access can see this page. A workspace owner or admin can manage the switch, edit or remove lessons, and revert recipes. Approving a lesson into shared repository memory also requires an organization owner or admin.
Choose who receives unreviewed lessons
Unreviewed lessons is on by default. Eligible station runs can save and read lessons for the workflow’s first approved repository. Approved notes and station instructions take precedence. A factory can switch this off to stop its runs saving or receiving unreviewed lessons. The switch applies to that factory. Another factory using the same repository may still use its lessons.
Workspaces governed by MadeBook and stations checked by an EvalBook suite receive approved information under their governance rules. Chat, planning and manager conversations do not receive the unreviewed station context. Agent Studio also has a Learning review for proposals about one agent’s instructions. That review creates a candidate instruction version for evaluation and release. Agent Studio
Inspect a recipe change
Under Recipe changes, compare the proposed command or value with what it replaced. Each entry identifies the proposing run, agent when available, and the reason. A proposed value is on trial in the repository recipe. A verified proof that actually exercises the changed step can decide it.
| Outcome | What to check |
|---|---|
| Kept | The relevant proof step passed with the proposed value. Read that proof for its commit and outcome. |
| Dropped | The step failed and CodeBook restores the prior value, or removes a new step. Read the recorded reason. |
| Replaced | Another proposal replaced this trial before proof decided it. Inspect the newer change. |
| Reverted | A person restored the previous value. Use Revert for a change still in the recipe. |
If no workflow has a repository, connect one before looking for lessons. If a repository has no recipe, configure its install, build and test steps in Factory settings → Proof runs. A proof that skips the changed step can leave the change on trial. Proof runs