evolving-agent

Orchestrate coding tasks with coder, reviewer, evolver, and retrieval agents.

4|1|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/richenlin/evolving-programming-agent --skill evolving-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evolving-agent
Source: https://github.com/richenlin/evolving-programming-agent/tree/main/evolving-agent
Command: npx skills add https://github.com/richenlin/evolving-programming-agent --skill evolving-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) and references (resource) components.

What problem does it solve?

The Evolving Agent orchestrates complex coding workflows by coordinating specialized sub-agents (coder, reviewer, evolver, retrieval) to implement, review, and evolve coding tasks with governance and auditability.

Core Features & Use Cases

  • Orchestrator-based task flow: dispatches coder, reviewer, evolver, and retrieval sub-agents.
  • Python-enforced state machine: enforces transitions, logs audits, and ensures idempotency.
  • Knowledge accumulation: extracts and stores lessons to a knowledge base after task completion.
  • GitHub learning: analyzes GitHub projects to derive reusable patterns and conventions.
  • Cross-project knowledge isolation: global + project-specific knowledge context for flexible retrieval.
  • Multi-platform support: OpenCode, Claude Code, and Cursor platforms.

Quick Start

Describe your coding task to the orchestrator and let it manage the end-to-end dispatch, coding, review, and evolution loop.

Frequently Asked Questions about evolving-agent

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

FAQPage Schema
How do I orchestrate AI agents for automated coding and code review?

AI agent orchestration coordinates specialized sub-agents like coder, reviewer, and evolver to implement and review coding tasks. The Evolving Agent uses a Python-driven state machine to govern transitions, log audits, and manage the end-to-end workflow.

What is an evolving agent workflow for software engineering tasks?

An evolving agent workflow dispatches coder, reviewer, evolver, and retrieval sub-agents to handle software engineering tasks. It enforces state transitions, captures lessons into a knowledge base, and analyzes GitHub projects to derive reusable patterns.

Can I use this agent orchestration workflow with OpenCode, Claude Code, and Cursor?

Yes, this agent orchestration workflow supports OpenCode, Claude Code, and Cursor platforms. It coordinates coding, refactoring, and bug fixing tasks across these environments using a Python-enforced state machine.

Do I need a YAML configuration to define coding tasks for the orchestrator?

Yes, you need a YAML frontmatter with a name and description in SKILL.md to define coding tasks. The orchestrator-driven flow loads this configuration to dispatch sub-agents and govern state transitions.

How does the agent capture and reuse knowledge across GitHub projects?

The agent extracts and stores lessons to a knowledge base after task completion. It supports cross-project knowledge isolation by maintaining global and project-specific knowledge context for flexible retrieval.

What are the limitations of using a state machine for AI coding agent orchestration?

Using a state machine for AI coding orchestration requires Python and PyYAML dependencies, enforcing strict transitions and idempotency. It limits ad-hoc sub-agent interactions, requiring tasks to follow the defined coder, reviewer, and evolver loop.