sprint-contract

Write, negotiate, and evaluate Sprint Contracts for Tier 2+ tasks in the Harness Engineering Framework.

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/JoyJoin-Tech-Limited/JoyJoin_app_v0.1 --skill sprint-contract-joyjoin-tech-limited
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sprint-contract
Source: https://github.com/JoyJoin-Tech-Limited/JoyJoin_app_v0.1/tree/main/.github/skills/sprint-contract
Command: npx skills add https://github.com/JoyJoin-Tech-Limited/JoyJoin_app_v0.1 --skill sprint-contract-joyjoin-tech-limited

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often start implementation without a shared, testable definition of done, leading to scope creep, vague acceptance criteria, and disputes during review. This Skill defines Sprint Contracts before any file is edited, so implementers and evaluators agree on measurable outcomes upfront. ## Core Features & Use Cases - Contract Authoring: Produces a hybrid JSON frontmatter plus Markdown contract with testable acceptance criteria, Harness pillar criteria (reliability, scalability, security, observability, maintainability), and explicit out-of-scope sections. - Negotiation Protocol: Manages a structured implementer-verifier review loop with a negotiation log, a maximum of two amendment cycles, and supervisor escalation on deadlock. - Evaluation Protocol: Grades each criterion as PASS, PARTIAL, or FAIL against hard thresholds, writing feedback and verdict JSON files for re-evaluation of only failed criteria. - Use Case: A backend engineer is assigned a Tier 2 task to add a refund endpoint. Before coding, they draft a contract with criteria like "idempotency key prevents duplicate refunds, verified by npm run test", negotiate it with the Verifier, and later the QA Agent evaluates the implementation against those exact thresholds. ## Quick Start Ask the agent to write a sprint contract for your Tier 2 task, including the goal, testable acceptance criteria, and relevant Harness pillar criteria.

Frequently Asked Questions about sprint-contract

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

FAQPage Schema
How do I write a sprint contract for a Tier 2 task?▼

Create a Markdown file at .git/.orchestration/sprints/sprint-contract.{taskId}.md with JSON frontmatter (sprintId, tier, goal, status) and sections for goal, acceptance criteria, Harness pillar criteria, out-of-scope items, and a negotiation log. Each criterion needs an observable condition and a verification method.

What makes a good acceptance criterion in a sprint contract?▼

A good acceptance criterion is observable and testable, with a concrete verification method such as a command, test, or MCP check. Use numbers instead of adjectives, like "< 100ms" rather than "fast", and cover happy path, error path, and boundary conditions.

When is a sprint contract not required?▼

Tier 1 tasks do not need a contract, and neither do documentation-only or test-only changes. A contract is also unnecessary if the task already has an accepted contract in place or if you are reviewing work that never had one.

How does contract evaluation work after implementation?▼

The QA Agent reads the contract, runs each verification method, and grades criteria as PASS, PARTIAL, or FAIL. Any FAIL on a required criterion triggers rejection, and re-evaluation only rechecks the failed criteria rather than the full suite.

What happens if the implementer and verifier disagree on a contract?▼

The negotiation protocol allows a maximum of two amendment cycles between implementer and verifier. If they reach deadlock after those cycles, the dispute escalates to the Supervisor for resolution.