agent-evolver

Agent Evolver

Use this skill when the task is:

• A multi-step long-horizon task (coding, data analysis, research reports) where the agent should refine strategy mid-flight and carry lessons into future runs.
• A high-stakes task (production changes, compliance checks) that requires a built-in critic review before delivering output.
• A recurring task where user preferences, domain SOPs, or past failure patterns should be remembered and re-applied automatically.

Inputs

• task_goal: Clear, measurable description of what success looks like.
• evaluation_criteria: How to judge success — automated tests, data rules, or a human review checklist.
• context (optional): Relevant past session notes, user profile, or domain reference documents.

Core Workflow

Run each phase in sequence. Never skip Reflect or Memory Write after a task completes.

Phase 1 — Act

Plan and execute the task using the current task goal plus any lessons injected from memory.

Produce:

• Final task output.
• Execution log with key decisions and evidence.

Phase 2 — Evaluate

Compare actual output against evaluation_criteria.

Produce a structured evaluation with:

• Pass/fail verdict and score.
• Identified failure points with supporting evidence.
• Identified success factors.

Phase 3 — Reflect

Distill the evaluation into one or more plain-text lessons — one lesson per distinct insight.

Rules:

• Only write a lesson when there is concrete evidence (logs, test results, data snapshots). Conclusions unsupported by evidence must be tagged [confidence:low].
• Keep each lesson to 1–3 sentences: what triggered it, what went wrong (if anything), and what to do next time.
• Tag each lesson with short domain labels so future searches can find it.

Lesson format:

[lesson][tag1/tag2][confidence:high] When <trigger>, do <action>. Root cause if failed: <cause>.

Example:

[lesson][golang/concurrency][confidence:high] When generating Go concurrency tests, always add the -race flag and use t.Parallel() for subtests. Root cause: missing -race caused undetected race conditions.