zouroboros-evolve

Execute and validate prescribed code or file improvements with automatic rollback on regression.

23|4|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/marlandoj/zouroboros --skill zouroboros-evolve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zouroboros-evolve
Source: https://github.com/marlandoj/zouroboros/tree/main/packages/selfheal/docs/evolve
Command: npx skills add https://github.com/marlandoj/zouroboros --skill zouroboros-evolve

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The evolve engine automates applying and validating prescribed improvements so teams can continuously improve code and files without manual rollbacks or missed regressions.

Core Features & Use Cases

  • Prescription Execution: Runs playbooks either as autoloop file-targeting jobs or as generated remediation scripts.
  • Safety and Validation: Captures pre- and post-flight metrics, reverts any regression above two percent, and records each outcome as an episode in memory.
  • Governance Options: Supports dry-run previews and explicit governor overrides for controlled experimentation.
  • Use Case: Apply a daily self-healing prescription that updates a failing pipeline, validate the result against baseline metrics, and automatically revert if performance degrades.

Quick Start

Run the evolve tool with the path to a prescription file to execute and validate the prescribed improvement in dry-run mode.

Frequently Asked Questions about zouroboros-evolve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate prescription-driven code evolution and revert regressions automatically?

Automated code evolution executes and validates prescribed improvements to files, capturing pre- and post-flight metrics to automatically revert any changes that regress performance by more than two percent.

How do I run a dry-run preview for self-healing remediation scripts before applying changes?

Dry-run previews for self-healing remediation scripts are supported through a governor override flag, allowing you to execute prescribed file improvements and validate metrics without permanently applying changes.

Can I use autoloop file-targeting playbooks for automated code evolution workflows?

Yes, autoloop file-targeting playbooks are supported as execution modes for prescribed improvements, running alongside generated remediation scripts during automated evolution workflows.

What happens to metrics when automated code evolution changes cause performance regression?

Automated code evolution captures pre- and post-flight metrics during validation and automatically reverts any changes that regress metrics beyond a two percent threshold.

Why should I record code evolution outcomes as memory episodes during remediation?

Recording code evolution outcomes as memory episodes tracks validation results and revert actions, creating an historical baseline of self-healing prescription performance for future automated workflows.

Does the automated code evolution engine support governor overrides for controlled experimentation?

Yes, the automated code evolution engine supports explicit governor overrides and dry-run previews, providing governance options for controlled experimentation with self-healing prescriptions.