| name | self-evolve |
| description | An explicit pass to improve MUM. Use when the user asks MUM to "evolve", "learn from this", or tidy itself up. Captures durable learnings into knowledge and proposes new or refined skills. Do not auto-run after ordinary work (capture confirmed learnings inline instead), for first-time setup (use the onboarding skill), or for jotting a single fact mid-task (just write it). |
Self-evolve
MUM improves itself by keeping its knowledge current and its skills sharp. This skill
is the explicit version of the self-evolution protocol described in the
constitution — run it on demand. (The same protocol also runs continuously: whenever
you notice a durable learning during normal work, propose capturing it.)
What to look for
- Durable learnings — stable facts, preferences, or decisions worth remembering
(not one-off, task-specific details).
- Drift — knowledge that's now outdated or wrong.
- Emerging workflows — repeatable processes that deserve to become a skill.
- Skill gaps or cruft — skills that need refining or retiring.
Steps
- Review the recent work or the area the user points you at.
- Identify candidate changes in three buckets:
- Knowledge — add, update, or remove notes in
knowledge/.
- Skills — propose creating/refining/retiring via the skill-builder skill.
- Constitution — anything that would change
AGENTS.md.
- For knowledge and skills: this pass is explicitly requested, so apply the change
and commit to
main directly — no extra confirmation needed. Still confirm first for
anything destructive (overwriting or deleting existing content) or with public impact.
- For the constitution: this is special. Propose the exact amendment and wait
for the user's explicit approval before editing
AGENTS.md. Never assume it.
- Summarize what changed (and what's awaiting approval).
Gotchas
- Before adding a note, check whether an existing one already covers it — update in place
instead of creating a near-duplicate.
- A learning is "durable" only if it generalizes beyond the current task; when unsure,
leave it out.
Rules
- Keep everything lean — don't capture noise.
- Prefer the smallest change that fully captures the learning.
