brain-evolve

SkillDocs & knowledge

Analyze accumulated brain memory and propose promotions to CLAUDE.md, rules, or new skills. Makes your brain smarter over time.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the brain-evolve skill

What this skill tells your AI

The instructions your AI receives, as published by toroleapinc/claude-brain in skills/brain-evolve/SKILL.md and read by ahel’s review.

The user wants to evolve their brain by promoting stable patterns from memory.

Steps

  1. Run the evolution analysis:

    bash "${CLAUDE_PLUGIN_ROOT}/scripts/evolve.sh"
    
  2. Read the analysis results from ~/.claude/brain-repo/meta/last-evolve.json.

  3. For each recommendation in promotions, present it to the user:

    For claude_md promotions:

    • Show the proposed addition
    • Show the reason
    • Ask: Accept / Skip / Edit first
    • If accepted, append to ~/.claude/CLAUDE.md

    For rule promotions:

    • Show the proposed rule content
    • Ask: Accept / Skip / Edit first
    • If accepted, write to ~/.claude/rules/.md

    For skill suggestions:

    • Show the proposed skill
    • Ask: Accept / Skip / Edit first
    • If accepted, create in ~/.claude/skills//SKILL.md
  4. For each entry in stale_entries, ask:

    • Archive (remove from memory) / Keep
    • If archived, note in the memory file that it was archived
  5. After all changes are applied:

    bash "${CLAUDE_PLUGIN_ROOT}/scripts/push.sh"
    
  6. Show summary: "Brain evolved: X promotions accepted, Y stale entries archived."

Signals

GitHub stars
87
Forks
19
Last commit
Jun 2026
Advanced
Catalog kind
skill
Gateway key
brain-evolve
Source
github.com/toroleapinc/claude-brain