harness-setup

Generate hook scripts and settings to enforce workflow phases in Claude Code.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ElvinOuyang/claude-skill-collection --skill harness-setup-elvinouyang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-setup
Source: https://github.com/ElvinOuyang/claude-skill-collection/tree/main/plugins/harness-engineering-toolkit/skills/harness-setup
Command: npx skills add https://github.com/ElvinOuyang/claude-skill-collection --skill harness-setup-elvinouyang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires superpowers, and includes references (resource) components.

What problem does it solve?

It prevents Claude from skipping required workflow steps (specs, tests, doc updates, and verification) when running autonomously by creating a mechanical harness that blocks completion until phases are satisfied.

Core Features & Use Cases

  • Creates a complete harness system: generates hook scripts, slash-command workflow markers, and .claude/settings.json wiring so enforcement happens automatically.
  • Bootstraps living documentation: scaffolds docs/ templates and fills missing PRD/system-design/component-registry/constraints/feature and behavior specs based on the codebase.
  • Implements scope-aware phase gating: infers whether work is a feature, patch, or design change and enforces only the required phases for that scope.
  • Safety guardrails: includes loop detection for Stop-hook blocking so the enforcement won’t trap the chat in an infinite block/reply loop.
  • Designed for autonomous runs: use it when you want mandatory workflow compliance rather than relying on conversational reminders.

Quick Start

Ask the Skill to set up a harness in the current project by saying: "Set up a harness to enforce mandatory workflow steps for this repository, and scaffold any missing living docs."

Frequently Asked Questions about harness-setup

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

FAQPage Schema
How do I enforce mandatory workflow phases like specs and tests in Claude Code?

To enforce mandatory workflow phases in Claude Code, you need a mechanical harness that blocks completion until specs, tests, and doc updates are satisfied. This setup generates hook scripts and slash commands to automate quality gates.

How do I stop Claude from skipping doc updates and verification when running autonomously?

Stopping Claude from skipping doc updates during autonomous runs requires mechanical enforcement via git hooks and a state machine. The system blocks task completion until verification phases are explicitly satisfied, preventing silent skips.

Can I apply scope-aware quality gates to distinguish between feature and patch work in Claude Code?

Yes, scope-aware quality gates can be applied by inferring whether work is a feature, patch, or design change. The enforcement harness then triggers only the required workflow phases specific to that scope.

How do I bootstrap living documentation templates for an existing repository?

Bootstrapping living documentation involves scaffolding docs templates and filling missing PRD, system-design, and component-registry specs based on the codebase. This ensures documentation stays current alongside code changes.

Do I need the superpowers dependency to set up Claude Code workflow enforcement?

Yes, the superpowers dependency is required to set up this Claude Code workflow enforcement. It provides the foundational capabilities needed to wire enforcement through settings and hook scripts.

What happens if a Stop-hook blocks the chat in an infinite loop during autonomous execution?

If a Stop-hook blocks the chat in an infinite loop during autonomous execution, built-in loop detection safety guardrails intervene. These guardrails prevent the enforcement mechanism from trapping the chat in a block and reply cycle.