harness-engineering

Design development environments with CI, linters, and tests as agent feedback loops.

13|3|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/phrazzld/agent-skills --skill harness-engineering-phrazzld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-engineering
Source: https://github.com/phrazzld/agent-skills/tree/main/core/harness-engineering
Command: npx skills add https://github.com/phrazzld/agent-skills --skill harness-engineering-phrazzld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of creating effective development environments where AI agents can operate productively and reliably, minimizing errors and maximizing their ability to self-correct.

Core Features & Use Cases

  • Environment Design: Focuses on building robust CI/CD pipelines, test suites, and linters that act as direct feedback loops for AI agents.
  • Machine-Readable Documentation: Emphasizes structuring documentation so agents can parse and act upon it directly.
  • Mechanical Enforcement: Prioritizes using tooling (type systems, linters, tests) over human-readable instructions to enforce architectural boundaries and coding standards.
  • Progressive Autonomy: Outlines a strategy for gradually increasing agent autonomy based on demonstrated reliability.

Quick Start

Use the harness-engineering skill to design a feedback loop for an AI agent that prioritizes immediate, automated error detection.

Frequently Asked Questions about harness-engineering

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

FAQPage Schema
How do I optimize CI/CD pipelines and tests as feedback loops for AI coding agents?

To optimize CI/CD pipelines as agent feedback loops, you must structure tests and linters to provide immediate, automated error detection. This allows AI agents to parse output directly and self-correct during autonomous coding sessions.

What is the best way to enforce architectural boundaries for autonomous coding agents?

The best way to enforce architectural boundaries is through mechanical enforcement using tooling like type systems and linters, rather than relying on human-readable instructions, ensuring AI agents reliably maintain project structure.

How do I make documentation machine-readable for AI agents to parse?

To make documentation machine-readable, you must structure it as an artifact that AI agents can act upon directly. This involves formatting data so autonomous coding workflows can parse context without human intervention.

How do I safely increase autonomy for an AI coding agent in a development environment?

You increase AI coding agent autonomy progressively by designing infrastructure that grants privileges based on demonstrated reliability, using robust test suites and CI pipelines to validate successful self-correction.

Why use automated linters and type systems over human-readable instructions for agent workflow design?

Automated linters and type systems are preferred over human-readable instructions because they provide mechanical enforcement of coding standards, creating direct, unambiguous feedback loops that AI agents can process autonomously.

Do I need a specific test suite framework to design agent environments for autonomous coding?

No specific framework is required, but the test suite must be structured to provide immediate, automated error detection. Any framework works if its output acts as a direct feedback loop for the AI agent.