Skip to main content
Open Lessons in the project sidebar. The selector above the lesson tree switches between Lessons in production and proposals.

​
Create a proposal

  1. Choose New proposal for changes and give it a descriptive title.
  2. Select an existing lesson to edit, or choose New lesson. Use New folder to organize lessons.
  3. Fill in Title, When to use, and Content.
  4. Choose Save changes.
Saving updates the proposal. Agents use the changes only after you apply them to production.

​
Review the changes

Use View changes to compare edits with production. Add comments and source trace links in the proposal timeline. Sovara chat can help refine wording or check for overlapping lessons. Choose Add AI review for feedback on the saved proposal. Review the latest changes before applying them.

​
Apply to production

Choose Apply to production when ready. Resolve conflicts and duplicate lesson titles first. If the latest changes lack AI approval, you can request a review or apply anyway. Close a proposal to leave it unapplied; reopen it to continue editing.

​
Projects connected to GitHub

Choose Create proposal in GitHub, then View proposal in GitHub to review the pull request. Production updates through the connected repository’s tracked branch, after the changes are merged.

​
Maintain the library

Rename, move, copy, or delete lessons and folders within a proposal. In production’s History of changes, Revert creates a new proposal to undo an earlier application. After applying a change, check it on a representative task. See runtime retrieval and evaluations.