harness-goal

Runs Developer and QA agents in a bounded loop until a measurable success criterion is met.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Alan-IFT/harness-kit --skill harness-goal-alan-ift
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-goal
Source: https://github.com/Alan-IFT/harness-kit/tree/main/skills/harness-goal
Command: npx skills add https://github.com/Alan-IFT/harness-kit --skill harness-goal-alan-ift

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Open-ended engineering tasks like "keep refactoring until complexity drops" or "raise test coverage to 80%" have no clean single-shot definition, so they need an iterative loop with a measurable target and a hard budget instead of a one-pass pipeline. ## Core Features & Use Cases - Bounded improvement loop: Dispatches a Developer agent repeatedly, gating every iteration on verify_all and reverting regressions automatically. - Measurable success criteria: Runs a user-supplied command whose output measures progress, recording each iteration in goal_state.json. - Budget enforcement: Stops on max-iterations or max-minutes and reports GOAL ACHIEVED or BUDGET EXHAUSTED in a delivery document. - Use Case: Ask to improve test coverage on the payments/ package from 60% to 80% within 10 iterations; the loop makes one improvement per cycle, keeps the build green, and finishes with an adversarial QA review. ## Quick Start Ask the AI to run /harness-goal with a measurable goal such as "reduce verify_all WARN count from 5 to 0 within 10 iterations".

Frequently Asked Questions about harness-goal

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

FAQPage Schema
How do I run an iterative AI coding loop until a metric is met?▼

Invoke /harness-goal with a one-sentence measurable goal, a success criterion command, and a budget in iterations or minutes. The skill loops a Developer agent, checks the criterion after each change, and stops when the target is met or the budget runs out.

What inputs does the harness-goal skill require?▼

It requires a measurable goal statement, a success criterion command whose output measures progress, and a budget (max-iterations defaulting to 10 or max-minutes defaulting to 60). Optional stop conditions abort the loop on side effects like out-of-scope file changes.

When should I use harness-goal instead of the full harness pipeline?▼

Use harness-goal for open-ended tasks with a measurable target but no single-shot definition, like coverage or performance targets. Use the full /harness pipeline when you want a specific feature, bug fix, or refactor with requirement and design stages.

What happens if the budget runs out before the goal is reached?▼

The loop stops and writes a delivery document with the verdict BUDGET EXHAUSTED plus the current measurement. It does not silently extend the budget; the shortfall is reported to the user with the iteration history.

Does harness-goal keep the build green during iterations?▼

Yes. Every iteration runs verify_all, and if it fails the change is reverted and recorded as a regression without consuming an iteration. The final state also gets one adversarial QA review before delivery.