agentleFS
rm2thaddeusrm2thaddeus/Aitor_Skills/ensemble-solving/SKILL.md

ensemble-solving

Skill4 starsChanged 10 months agoMITView on GitHub

Generate multiple diverse solutions in parallel and select the best. Use for architecture decisions, code generation with multiple valid approaches, or creative tasks where exploring alternatives improves quality.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When alternatives might be preferred

    line 73

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Ensemble Problem Solving

Generate multiple solutions in parallel by spawning 3 subagents with different approaches, then evaluate and select the best result.

When to Use

Activation phrases:

  • "Give me options for..."
  • "What's the best way to..."
  • "Explore different approaches..."
  • "I want to see alternatives..."
  • "Compare approaches for..."
  • "Which approach should I use..."

Good candidates:

  • Architecture decisions with trade-offs
  • Code generation with multiple valid implementations
  • API design with different philosophies
  • Naming, branding, documentation style
  • Refactoring strategies
  • Algorithm selection

Skip ensemble for:

  • Simple lookups or syntax questions
  • Single-cause bug fixes
  • File operations, git commands
  • Deterministic configuration changes
  • Tasks with one obvious solution

What It Does

  1. Analyzes the task to determine if ensemble approach is valuable
  2. Generates 3 distinct prompts using appropriate diversification strategy
  3. Spawns 3 parallel subagents to develop solutions independently
  4. Evaluates all solutions using weighted criteria
  5. Returns the best solution with explanation and alternatives summary

Approach

Step 1: Classify Task Type

Determine which category fits:

  • Code Generation: Functions, classes, APIs, algorithms
  • Architecture/Design: System design, data models, patterns
  • Creative: Writing, naming, documentation

Step 2: Invoke Ensemble Orchestrator

Task tool with:
- subagent_type: 'ensemble-orchestrator'
- description: 'Generate and evaluate 3 parallel solutions'
- prompt: [User's original task with full context]

The orchestrator handles:

  • Prompt diversification
  • Parallel execution
  • Solution evaluation
  • Winner selection

Step 3: Present Result

The orchestrator returns:

  • The winning solution (in full)
  • Evaluation scores for all 3 approaches
  • Why the winner was selected
  • When alternatives might be preferred

Diversification Strategies

For Code (Constraint Variation):

ApproachFocus
SimplicityMinimal code, maximum readability
PerformanceEfficient, optimized
ExtensibilityClean abstractions, easy to extend

For Architecture (Approach Variation):

ApproachFocus
Top-downRequirements → Interfaces → Implementation
Bottom-upPrimitives → Composition → Structure
LateralAnalogies from other domains

For Creative (Persona Variation):

ApproachFocus
ExpertTechnical precision, authoritative
PragmaticShip-focused, practical
InnovativeCreative, unconventional

Evaluation Rubric

CriterionBase WeightDescription
Correctness30%Solves the problem correctly
Completeness20%Addresses all requirements
Quality20%How well-crafted
Clarity15%How understandable
Elegance15%How simple/beautiful

Weights adjust based on task type.

Example

User: "What's the best way to implement a rate limiter?"

Skill:

  1. Classifies as Code Generation
  2. Invokes ensemble-orchestrator
  3. Three approaches generated:
    • Simple: Token bucket with in-memory counter
    • Performance: Sliding window with atomic operations
    • Extensible: Strategy pattern with pluggable backends
  4. Evaluation selects extensible approach (score 8.4)
  5. Returns full implementation with explanation

Output:

## Selected Solution

[Full rate limiter implementation with strategy pattern]

## Why This Solution Won

The extensible approach scored highest (8.4) because it provides
a clean abstraction that works for both simple use cases and
complex distributed scenarios. The strategy pattern allows
swapping Redis/Memcached backends without code changes.

## Alternatives

- **Simple approach**: Best if you just need basic in-memory
  limiting and will never scale beyond one process.

- **Performance approach**: Best for high-throughput scenarios
  where every microsecond matters.

Success Criteria

  • 3 genuinely different solutions generated
  • Clear evaluation rationale provided
  • Winner selected with confidence
  • Alternatives summarized with use cases
  • User understands trade-offs

Token Cost

~4x overhead vs single attempt. Worth it for:

  • High-stakes architecture decisions
  • Creative work where first attempt rarely optimal
  • Learning scenarios where seeing alternatives is valuable
  • Code that will be maintained long-term

Integration

  • feature-planning: Can ensemble architecture decisions
  • code-auditor: Can ensemble analysis perspectives
  • plan-implementer: Executes the winning approach

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.