refine

Use when the user has an existing draft, text, code, or artifact and wants it iteratively improved through multi-model critique and weaving across multiple passes. Triggers on phrases like "refine this", "improve this", "make this better", "iterate on this", or "polish this"

Weave Refine

Iteratively improve an artifact through multi-model critique and weaving. Each pass is a full judge-pick-best-incorporate-strengths-address-weaknesses cycle.

When to Use

  • You have a draft that needs improvement
  • You want multiple AI models to critique and enhance an artifact
  • You want iterative refinement where each pass genuinely improves the output
  • You have output from /weave:brainstorm that you want to refine further

Key Features

  • Accepts inline text or file paths (auto-detected)
  • --passes=N (1-5, default 2): Number of refinement cycles
  • Each pass: all models critique and improve, judge picks best, weaves in strengths from runners-up
  • Full rationale chain showing evolution across passes
  • Early-stop when no material improvement detected
  • --judge=host|round-robin: Host judges every pass, or rotate judging across models

The Refinement Cycle

  1. All models independently critique and improve the artifact
  2. Judge scores versions, picks the best, identifies strengths in runners-up
  3. Judge weaves a revised version incorporating all improvements
  4. Woven version goes back to all models for another round
  5. Repeat until passes exhausted or convergence

How to Invoke

Run the /weave:refine command with your text or file path. The command handles context gathering, model detection, the judge-weave-distribute cycle, and artifact persistence.