harness-session-guard

Classifies implementation tasks into harness tiers and gates edits behind Sprint Contracts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using a harness-based development workflow need consistent enforcement of when a Sprint Contract is required before code changes begin. This Skill removes guesswork by automatically classifying every implementation request into a tier and pausing work until the required contract is negotiated and verified. ## Core Features & Use Cases - Automatic Tier Classification: Runs a detection script against the user's request and proposed files to assign Tier 1 (small fix), Tier 2 (new feature requiring a Sprint Contract), or Tier 3 (core engine changes requiring deliberation). - Contract Gating: Generates Sprint Contracts, verifies them with a contract gate script, and blocks file edits until the gate passes. - Trigger Word Reference: Ships a built-in vocabulary of trigger phrases for each tier, plus edge-case rules such as trusting file patterns over wording. - Use Case: A user asks to add a CSV export button to the admin finance page. The Skill classifies it as Tier 2, pauses implementation, generates a Sprint Contract with acceptance criteria, and only proceeds after the user accepts and the contract gate returns ok. ## Quick Start Ask the agent to run the harness session guard classification on your implementation request before any files are edited.

Frequently Asked Questions about harness-session-guard

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

FAQPage Schema
How do I check if a Sprint Contract is required before editing code?

Run the harness-auto-trigger script with the user's request and the files you plan to touch. It returns a tier, a contractRequired flag, and an action of PROCEED or PAUSE_FOR_CONTRACT that tells you whether to start editing or negotiate a contract first.

How do I generate and verify a Sprint Contract?

Run generate-sprint-contract with a task id, goal, files, and affected workspaces, then have the user review the acceptance criteria. After acceptance, run harness-contract-gate with the task id; an ok result of true means implementation can begin.

When should the harness session guard be skipped?

Skip it for questions and explanations, documentation-only updates, read-only debugging, and running tests or commands. It applies only to tasks that write or modify code, create files, refactor, or change schemas and migrations.

What happens if a request is ambiguous between tiers?

Ask the user for clarification before classifying. When wording conflicts with file patterns, trust the file patterns; for example a quick fix touching server routes is treated as Tier 2.

Can I resume work that already has a Sprint Contract?

Yes. Check the orchestration sprints directory for an existing contract and run the contract gate with its task id. If the gate returns ok true, proceed; if false, show the user what must be fixed before continuing.