self-improvement-loop

Self-improvement loop

Purpose

Correct a specific weakness in the system around the model. This event loop changes prompts, skills, routing, tools, memory, or evaluations; it does not train model weights.

Failure evidence

1. Read references/improvement-loop.md.
2. Save the resume point in the original task.
3. Record the triggering event, expected behavior, available logs or checks, and smallest reproduction.
4. Classify the failure: route, context, documentation, tool contract, prompt, memory, evaluation, permission, handoff, or implementation.
5. Decide whether the fault belongs to the product or the agent system. Route ordinary code defects to implementation.
6. Define one measurable improvement target and a stop condition.

Repair cycle

1. Reproduce the failure and identify the first wrong decision supported by evidence.
2. Compare the smallest plausible repairs when the cause is uncertain. Verify current external behavior before changing a technical contract.
3. Change the narrowest durable surface: trigger description, route, procedure, reference, tool schema, context policy, memory rule, or evaluator.
4. Re-run the reproduction and one nearby non-regression case.
5. Add a behavioral regression check when it can catch the same failure class without matching preferred wording.
6. Write a short project-memory note only when the lesson is likely to help a future task. Use the active equivalent of 53-agent-learning-log.md.
7. Resume the original task from the saved point.

Event loop rules

• Run one observe, analyze, repair, validate, remember, resume cycle for a failure class.
• A new cycle needs new evidence, not a feeling that the previous repair was incomplete.
• Keep the user's task moving; process improvement is not the primary deliverable.
• Stop after two ineffective repairs for the same class and report the unresolved cause.
• Never increase autonomy, permissions, retention, external access, or unattended execution as an implicit repair.