harness-loop

Automate multi-agent orchestration loops with quality gates and Playwright verification.

Updated May 6, 2026
One-click install
npx skills add https://github.com/HMWKR/claude-code-skills --skill harness-loop-hmwkr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-loop
Source: https://github.com/HMWKR/claude-code-skills/tree/main/skills/harness-loop
Command: npx skills add https://github.com/HMWKR/claude-code-skills --skill harness-loop-hmwkr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually coordinating multiple AI agents for iterative project improvements, tracking progress, and verifying results is time-consuming and prone to human error. This Skill eliminates that overhead by automating the entire orchestration, verification, and insight accumulation workflow for any project with pre-defined agents.

Core Features & Use Cases

  • Dynamic Agent Orchestration: Auto-detects and classifies all agents defined in your project's .claude/agents/ directory with no hardcoded agent names, works for any project structure.
  • Mega Loop Iterative Improvement: Runs N-round (default 20) iterative improvement loops with automatic issue carryover between rounds, progress tracking, and final comprehensive reporting.
  • Built-in Quality Gates: Includes mandatory Playwright browser verification for web apps at the end of each loop, plus automated insight accumulation across domain-specific teams.
  • Task Router for One-off Workflows: Routes single tasks like audits, builds, or cleanups to the appropriate agents with verification and insight logging, no loop required.
  • Use Case: For a web app project with defined frontend, backend, and QA agents, use this Skill to run a full 20-round improvement cycle, automatically assigning tasks, verifying each round's work, and generating a final report with remaining issues.

Quick Start

Use the harness-loop skill to run a 20-round iterative improvement loop for the current web app project, automatically coordinating all defined agents and verifying final results with Playwright browser checks.

Frequently Asked Questions about harness-loop

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

FAQPage Schema
How do I automate multi-agent orchestration for iterative code refinement?

Multi-agent orchestration is automated by running an iterative improvement loop that auto-detects agents in your .claude/agents/ directory, assigns tasks across rounds, and carries over unresolved issues automatically.

How does iterative improvement handle unresolved issues between agent rounds?

Iterative improvement handles unresolved issues through automatic cross-round issue carryover, ensuring defects found in one agent round are tracked and passed to subsequent rounds until resolved or reported in the final summary.

Can I use Playwright verification to validate web applications after agent tasks?

Playwright verification is supported as a built-in quality gate for web applications, automatically running browser checks at the end of each improvement loop to validate that agent modifications work correctly.

Do I need predefined agents in a specific directory to run automated agent workflows?

Predefined agents formatted as markdown files in the .claude/agents/ directory are required, as the orchestration engine dynamically detects and classifies these files to route tasks without hardcoding agent names.

What is the best way to run a one-off security audit across multiple agents?

The best way to run a one-off security audit is using the task router, which routes single audit tasks to appropriate agents, executes verification, and logs domain-specific insights without requiring a full loop.

What are the limitations of multi-agent orchestration for non-web projects?

For non-web projects, the main limitation is the inability to use built-in Playwright browser verification, meaning quality gate enforcement must rely solely on agent outputs and automated insight accumulation rather than UI checks.