harness-role-separation

Separates planner, generator, and evaluator roles for complex tasks using a sprint contract.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-role-separation-maicongambini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-role-separation
Source: https://github.com/MaiconGambini/opencode-harness-guide/tree/main/skills/harness-role-separation
Command: npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-role-separation-maicongambini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Complex, subjective, or UI-heavy tasks often suffer from quality drift and missed requirements when a single agent both writes and reviews its own work. This Skill enforces explicit role separation so planning, implementation, and evaluation happen as distinct phases with a written contract. ## Core Features & Use Cases - Sprint Contract First: Requires filling docs/harness/sprint-contract.md with scope in/out, acceptance criteria, and a verification plan before any code is written. - Three Sequential Roles: Planner defines scope, Generator implements only contracted scope, and Evaluator judges against acceptance criteria using the harness-evaluator-rubric without self-approval. - Scope Discipline: Adjacent discoveries are logged to feature_list.json as not_started instead of being implemented, and scope changes require contract updates and approval. - Use Case: When building a multi-file UI feature where previous attempts missed requirements, invoke this Skill to produce a sprint contract, implement strictly within scope, then evaluate against observable acceptance criteria with an evidence log. ## Quick Start Invoke the harness-role-separation skill to plan, implement, and evaluate my UI feature using a sprint contract with separate planner, generator, and evaluator phases.

Frequently Asked Questions about harness-role-separation

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

FAQPage Schema
How do I separate planning and implementation roles in an AI coding workflow?

Define a sprint contract first with scope in/out, acceptance criteria, and a verification plan, then implement only what the contract lists. Finish with a separate evaluation phase that judges output against the contract instead of self-approving.

When should I use role separation for a coding task?

Use it for complex, subjective, or UI-heavy tasks, work spanning multiple files or subsystems, and high-risk changes like auth or public APIs. It is also recommended when prior single-role attempts produced incomplete output or quality drift.

Can one AI agent play all three roles in the harness workflow?

Yes, one agent can play planner, generator, and evaluator, but only sequentially with explicit role transitions. The evaluator phase must not produce its verdict in the same response as the implementation.

What happens if I discover extra work during the generator phase?

Do not implement it immediately. Add the discovery to feature_list.json with status not_started, or if scope must change, stop, update the sprint contract, get approval, and then continue.

What are the limitations of single-role self-review for code quality?

Self-review tends to miss defects and requirement gaps because the same reasoning that produced the code evaluates it. Role separation with an independent evaluator rubric and evidence log catches these gaps but adds process overhead unsuited to trivial tasks.