evolve

Extract session patterns from JSONL metrics into structured learnings.

50|7|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/Kanevry/session-orchestrator --skill evolve-kanevry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evolve
Source: https://github.com/Kanevry/session-orchestrator/tree/main/skills/evolve
Command: npx skills add https://github.com/Kanevry/session-orchestrator --skill evolve-kanevry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Evolve extracts recurring patterns and quality signals from interactive session history and converts them into explicit, managed learnings to improve future session planning and execution.

Core Features & Use Cases

  • Pattern extraction: Detect fragile files, effective sizing, recurring issues, scope guidance, deviation patterns, and stagnation-class frequency from session JSONL metrics.
  • Safe persistence: Deduplicate, update confidence, set expirations, and perform atomic rewrites to .orchestrator/metrics/learnings.jsonl with strict safeguards and user confirmation.
  • Vault mirroring: Optionally mirror confirmed learnings to an Obsidian vault via a configurable mirror script with warn/strict modes.
  • Use case: Run analyze to surface files that frequently break across waves, confirm learnings, and mirror high-confidence guidance into a knowledge vault.

Quick Start

Run the evolve skill in analyze mode to extract patterns from your session history and confirm which learnings to save.

Frequently Asked Questions about evolve

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

FAQPage Schema
How do I extract recurring issues and fragile file patterns from session metrics?

You can extract recurring issues and fragile file patterns from session metrics by running an analyze process on historical session JSONL files to identify deviation patterns, sizing insights, and stagnation-class frequency across waves. This surfaces files that frequently break for targeted review.

What is the best way to deduplicate and safely persist learnings from session history?

The best way to deduplicate and persist learnings is to use atomic writes to update a learnings.jsonl file, which prevents data corruption. The process updates confidence scores, sets expirations, and requires user confirmation before saving extracted session patterns.

Can I mirror extracted session learnings to an Obsidian vault?

Yes, you can mirror confirmed learnings to an Obsidian vault using a configurable mirror script. This vault integration supports warn and strict modes to safely synchronize high-confidence guidance into your knowledge base.

How do I identify scope guidance and deviation patterns during project orchestration?

To identify scope guidance and deviation patterns during project orchestration, apply pattern extraction to session metrics. This analyzes historical waves to detect stagnation-class frequency and recurring issues, converting them into structured learnings for future planning.

Do I need user confirmation before updating atomic learnings files?

Yes, user confirmation is required before performing atomic rewrites to the learnings.jsonl file. This safeguard ensures you review and approve extracted session patterns, fragile files, and scope guidance before they are persisted or mirrored.