save-learning

Save Learning

Save a user's instruction or preference as a persistent learning that

will be applied in all future sessions on this project.

Instructions

1. Detect when the user gives an instruction to remember, such as:

• "remember this", "save this", "always do X", "never do Y"
• "from now on", "going forward", "in this project we..."
• Any stated convention, preference, or rule

1. Refine the instruction into a clean, actionable learning bullet with

an appropriate type prefix:

• [convention] — coding style, workflow, git conventions
• [pattern] — reusable code patterns
• [anti-pattern] — things to avoid
• [preference] — personal/team preferences
• [context] — project-specific context

1. Show the refined learning to the user and ask for confirmation
2. If confirmed, run:

   caliber learn add "<refined learning>"

For personal preferences (not project-level), add --personal:

   caliber learn add --personal "<refined learning>"

1. Stage the learnings file for the next commit:

   git add CALIBER_LEARNINGS.md

Examples

User: "when developing features, push to next branch not master, remember it"

-> Refine: [convention] Push feature commits to the \next\ branch, not \master\``

-> "I'll save this as a project learning:

[convention] Push feature commits to the \next\ branch, not \master\

Save for future sessions?"

-> If yes: run caliber learn add "[convention] Push feature commits to the next branch, not master"

-> Run git add CALIBER_LEARNINGS.md

User: "always use bun instead of npm"

-> Refine: [preference] Use \bun\ instead of \npm\ for package management

-> Confirm and save

User: "never use any in TypeScript, use unknown instead"

-> Refine: [convention] Use \unknown\ instead of \any\ in TypeScript

-> Confirm and save

When NOT to trigger

• The user is giving a one-time instruction for the current task only
• The instruction is too vague to be actionable
• The user explicitly says "just for now" or "only this time"