loongflow

name	loongflow
description	PEES (Plan-Execute-Evaluate-Summary) iterative problem-solving methodology with LoongFlow engine for complex tasks. Use when tasks need structured iteration, optimization, evolution, or when user mentions loongflow/PEES/PES.

LoongFlow — PEES Iterative Problem Solving

Use this skill when the user wants to iteratively improve a solution — optimization, evolution, structured retries with learning, or any task that benefits from multiple rounds of refinement rather than a one-shot attempt.

Step 1: Analyze and Advise

Before starting, analyze the task and advise the user on which mode to use. Present both options clearly:

Native PEES (recommended for simple tasks):

• Best for: single-file fixes, small features, bug fixes, focused improvements
• How it works: You run Plan-Execute-Evaluate-Summary iterations yourself within this conversation
• Pros: Fast, no setup, no external dependencies, transparent workspace with full history
• Cons: Limited to ~5 iterations, single-threaded, no population-based evolution

LoongFlow Engine (recommended for complex tasks):

• Best for: optimization problems, multi-file projects, tasks needing many iterations (50+), population-based evolution with diversity preservation
• How it works: Downloads the LoongFlow framework, creates a general_agent task, runs evolutionary optimization in the background, monitors via cron
• Pros: Powerful evolutionary engine with multi-island model, Boltzmann selection, MAP-Elites diversity, checkpointing, cost tracking
• Cons: Requires ANTHROPIC_API_KEY and ANTHROPIC_BASE_URL, setup time, runs as background process
• Source: https://github.com/baidu-baige/LoongFlow

Ask the user which mode they prefer before proceeding.

Step 2: Follow the Mode Guide

Once the user chooses, read the corresponding reference file for detailed instructions:

• Native PEES → Read references/native-pees.md and follow it
• LoongFlow Engine → Read references/engine-mode.md and follow it

Architecture Reference

LoongFlow supports three tiers for agent projects:

Tier	Description	Best For
Simple	ReAct loop + persistent memory	Chatbots, tool calling, format conversion
Standard	ReAct + self-evaluation + iterative improvement	Code review, document generation, data analysis
Advanced	PEES evolution loop with loongflow-memory	Math optimization, algorithm design, NP-hard problems

Complexity Assessment

Task Analysis
├── Only needs conversation + simple tools? → SIMPLE
├── Needs file operations or code generation?
│   ├── Has numerical evaluation metric? → ADVANCED
│   └── No numerical metric? → STANDARD
└── Needs iterative optimization?
    ├── Has clear scoring function? → ADVANCED
    └── Qualitative improvement? → STANDARD