code-harness

Enforce a three-layer verification pipeline before writing implementation code.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/anhtrinh919/claude-code-sdd --skill code-harness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-harness
Source: https://github.com/anhtrinh919/claude-code-sdd/tree/main/skills/code-harness
Command: npx skills add https://github.com/anhtrinh919/claude-code-sdd --skill code-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A three-layer discipline pipeline (Spec-Light + TDD-Guard + Verify-Script) that prevents the "AI claims done, doesn't work, non-dev can't verify, debug spiral" failure mode. Trigger this skill ALWAYS before writing any implementation code for a non-developer operator: whenever the user says "let's build/implement/add/fix/change", invokes /dev or /implement, starts a new task, or asks for a "quick fix" or "simple change". Also trigger when resuming work mid-session on a task that already had code written without a verify-script. Do NOT skip this skill to "save time" — skipping it IS the failure mode the skill exists to prevent. Use it proactively without being asked.

Core Features & Use Cases

  • Layer 1 — Spec-Light: Post three lines with TASK, ESTIMATE, VERIFY before any implementation.
  • Layer 2 — TDD-Guard: Enables a guard around edits, requires failing tests before commits, and manages ignore patterns via tdd-config.
  • Layer 3 — Verify-Script: Ships a tiny verification script that executes a small set of checks before any code is considered done.
  • Browser & automation gate: Uses the browse tool for browser-level verification and enforces per-task discipline to prevent drift.
  • The agent is responsible for starting servers and running necessary checks; user interactions are minimized to specification and verification.

Quick Start

Begin by posting three lines that specify the TASK, ESTIMATE, and VERIFY before starting any implementation.

Frequently Asked Questions about code-harness

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

FAQPage Schema
How do I prevent AI-generated code from shipping without verification?

To prevent unverified AI-generated code from shipping, enforce a three-layer discipline pipeline before implementation: post a lightweight spec, require failing tests via a TDD guard, and run a dedicated verify-script to validate results.

How do I set up test-driven development guardrails for AI coding tasks?

Set up TDD guardrails for AI coding tasks by enabling a guard around code edits that requires failing tests to exist before any commits are allowed, and by managing ignore patterns through a dedicated configuration file.

What is the best way to structure an AI coding task before implementation?

The best way to structure an AI coding task before implementation is to post three lines specifying the TASK, ESTIMATE, and VERIFY, ensuring non-developer operators have a clear, auditable specification before any code is written.

Can non-developer operators verify AI code changes independently?

Non-developer operators can verify AI code changes independently by relying on a tiny verification script that executes a small set of automated checks, alongside browser-level checks, to confirm the task is actually working.

Why does AI claim a coding task is done but the code doesn't actually work?

AI claims a coding task is done but the code doesn't work due to a lack of enforced discipline. Skipping a pre-implementation spec, TDD guard, and verify-script creates a debug spiral where non-dev operators cannot independently audit the result.

Do I need a browser tool to verify AI-generated web application code?

You need a browser tool to verify AI-generated web application code because browser-level checks enforce per-task discipline and prevent drift, ensuring the agent starts servers and runs necessary checks for testable, auditable results.