self-evolutionlisted

Self-healing and self-evolving pattern for agents operating against repo capabilities, scripts, skills, sub-agents, selectors, workflows, and external systems. Classifies evolution events into four tiers — Friction/Workaround, Gap, Failure, Regression — applies repo-profile-gated edits with appropriate autonomy, verifies the fix, and updates domain reference files ("The Map, not the Diary"). Invoke whenever a tool call, subprocess, or workflow returns a failure OR whenever the agent used a workaround, bypass, guess, or manual substitute for an existing repo capability.
richfrem/agent-plugins-skills · ★ 4 · AI & Automation · score 74

Install: claude install-skill richfrem/agent-plugins-skills

# Self-Evolution Skill **Trigger:** Any tool call, subprocess, workflow, skill, sub-agent, helper, or documented repo capability fails, behaves ambiguously, or is bypassed through a workaround, guess, or manual substitute — and the fix or Map Debt entry is within allowed boundaries. **Core principle:** The agent does not just retry — it learns. Every fix either patches a helper (so the failure can't recur) or updates a reference file (so future agents avoid the same dead end). Fixes that aren't recorded are not fixes; they are patches waiting to become the same bug again. --- ## Phase 0 — Read the Repo Profile Before doing anything else, locate and read the repo's self-evolution profile: ``` <repo-root>/plugins/<plugin>/references/self-evolution-profile.md ``` If no profile exists for the current repo/plugin, create a conservative default one now using the template in Phase 0.1 below, then continue — but only proceed if the target edit is inside the default allowed directories. Also read `<plugin>/references/map-debt.md` if it exists. Surface any open entry that matches the current friction — if `Repeat: YES`, escalate immediately (go to Phase 6) instead of deferring again. The profile defines: - **Allowed edit directories** — the only dirs the agent may edit autonomously - **Error pattern → tier classification table** — maps known error signatures to tiers - **Domain playbook location** — where reference files ("The Map") live - **Evolution log path** — where to app