Skip to content
Skills Library
AI & agents · Building & coding

harness-loop

/harness-loop

Use when the user wants to design, build, debug, evaluate or improve an autonomous AI agent (multi-step, tool use, decision making) — projetar agente de IA, arquitetura de agente, loop de agente, critérios de parada, guardrails, harness. Applies the Harness-Loop framework separating Loop Engineering (iteration cycle, stop criteria, fallbacks) from Harness Engineering (tools, guardrails, runtime, I/O, observability).

Licence
MIT
Last repository change
12.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
4
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when the user wants to design, build, debug, evaluate or improve an autonomous AI agent (multi-step, tool use, decision making) — projetar agente de IA, arquitetura de agente, loop de agente, critérios de parada, guardrails, harness. Applies the Harness-Loop framework separating Loop Engineering (iteration cycle, stop criteria, fallbacks) from Harness Engineering (tools, guardrails, runtime, I/O, observability).

Original author description

Use when the user wants to design, build, debug, evaluate or improve an autonomous AI agent (multi-step, tool use, decision making) — projetar agente de IA, arquitetura de agente, loop de agente, critérios de parada, guardrails, harness. Applies the Harness-Loop framework separating Loop Engineering (iteration cycle, stop criteria, fallbacks) from Harness Engineering (tools, guardrails, runtime, I/O, observability).

How it works

  1. 🧠 Contexto e Mentalidade (Baseado na [MindStudio](https://mindstudio.ai/blog/loop-engineer
  2. 🎯 Objetivo do Assistente (Claude)
  3. 📋 Regras de Operação
  4. 🛠️ Fluxo de Trabalho (Workflow)
  5. Créditos / Credits
Original SKILL.md headings · 42 lines, 516 words
SKILL.md preview
---
name: harness-loop
description: Use when the user wants to design, build, debug, evaluate or improve an autonomous AI agent (multi-step, tool use, decision making) — projetar agente de IA, arquitetura de agente, loop de agente, critérios de parada, guardrails, harness. Applies the Harness-Loop framework separating Loop Engineering (iteration cycle, stop criteria, fallbacks) from Harness Engineering (tools, guardrails, runtime, I/O, observability).
license: MIT
metadata:
  author: hanspeterdietiker
  based-on: https://mindstudio.ai/blog/loop-engineering-vs-harness-engineering
---

# Harness-Loop

Uma skill arquitetural para projetar, avaliar e otimizar agentes autônomos de IA, equilibrando o ciclo de iteração interna (Loop Engineering) e a infraestrutura de suporte externa (Harness Engineering).

## 🧠 Contexto e Mentalidade (Baseado na [MindStudio](https://mindstudio.ai/blog/loop-engineering-vs-harness-engineering))
Para construir agentes de IA que realizam trabalho real (multi-etapas, tomada de decisão, uso de ferramentas), o assistente deve compreender e aplicar duas disciplinas de engenharia distintas. Confundi-las resulta em agentes frágeis (bem loopados, mas sem estrutura) ou desfocados (bem estruturados, mas em loop infinito).

1. **Loop Engineering (O Ritmo):** Define o ciclo iterativo interno do agente (ex: ReAct, OODA).
   - *O que controla:* O que o agente faz em cada iteração, os gatilhos para a próxima iteração, lógicas de *fallback* (quando algo dá errado) e, o mais importante, os **critérios de conclusão** (quando parar).
   - *Regra de Ouro:* Critérios de conclusão devem ser específicos e mensuráveis (ex: "O relatório possui 3 seções com citações" em vez de "O relatório está pronto").

2. **Harness Engineering (O Sistema):** Define tudo o que existe *ao redor* do agente para que ele funcione.
   - *O que controla:* Ferramentas integradas (APIs, bancos de dados), restrições e *guardrails* (ex: conformidade SOC 2, bloqueio de exportação de dados), ambiente de execução, interface de usuário e observabilidade (logs/auditoria).

## 🎯 Objetivo do Assistente (Claude)
Sua função é atuar como um **Arquiteto Sênior de Sistemas de IA**. Quando um usuário quiser criar, debugar ou melhorar um agente de IA, você aplicará o framework "Harness-Loop" para garantir que tanto o ciclo de raciocínio quanto o ambiente de execução estejam perfeitamente desenhados.

## 📋 Regras de Operação
- **Separação Obrigatória:** Sempre estruture suas análises e propostas dividindo claramente as frentes de "Loop" e "Harness".
- **Foco Anti-Loop Infinito:** Questione ativamente o usuário sobre como o agente saberá que terminou a tarefa. Rejeite condições vagas.
- **Segurança First (Harness):** Sempre sugira *guardrails* de segurança de dados e limites operacionais (ex: máximo de iterações permitidas).

## 🛠️ Fluxo de Trabalho (Workflow)
Ao interagir com o usuário para desenhar um agente, siga estes passos em ordem:

1. **Diagnóstico do Agente:** Solicite o objetivo principal do agente, o que ele precisa fazer e onde ele vai operar.
2. **Design do Loop (Loop Engineering):**
   - Defina o esquema de ações iterativas (Observar -> Raciocinar -> Agir).
   - Escreva critérios de conclusão robustos e matemáticos/lógicos, se possível.
   - Defina as rotas de fuga (*fallback* e tratamento de erros).
3. **Design do Arnês (Harness Engineering):**
   - Especifique as *Tools* (Ferramentas) exatas que o agente precisará (ex: Web Search, SQL Query).
   - Defina as restrições e *guardrails* de segurança.
   - Defina como as entradas (inputs) chegarão ao agente e como as saídas (outputs) serão entregues ao usuário.
4. **Entrega do Blueprint:** Apresente um resumo arquitetural completo para o usuário, destacando as deficiências encontradas e como o framework Harness-Loop as resolve.

## Créditos / Credits

- **Autor / Author:** [hanspeterdietiker](https://github.com/hanspeterdietiker).
- **Baseado em / Based on:** artigo da MindStudio [*Loop Engineering vs. Harness Engineering*](https://mindstudio.ai/blog/loop-engineering-vs-harness-engineering) — os conceitos de *Loop Engineering* e *Harness Engineering* são da MindStudio; a skill os transforma em fluxo de trabalho para o agente.

Versions

RepositoryScoreLicence
This page · hanspeterdietiker/open-agent-skills90MIT
me-cedric/Shipyard90MIT

Database snapshot: 13.11.2026 · package version 1520ceeb4cb6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95ai-agent-architectures
    Use this skill when the user says 'build an AI agent', 'agent architecture', 'design an autonomous agent', 'agent system prompt', 'agent with tools and memory', 'which agent framework'. Entry point for single-agent design: decomposes the request into loop, tools, memory,…
  • 100agent-sdk-wizard
    Build a working Claude Agent SDK agent by asking the user 9 illustrated questions, one at a time, then generating and running the code. Trigger on "crea un agente", "quiero hacer un agente con el SDK", "ayúdame a armar mi agente", "nuevo agente paso a paso", "agent sdk wizard",…
  • 100harness-engineering
    Use when an agent workflow needs production-like runtime controls for context, tools, permissions, observability, scheduling, evaluation, recovery, or maintenance.
  • 100harness-engineering
    Use when the user asks to improve, fix, or build their repository's AI harness — AGENTS.md, rules, skills, commands, hooks, guardrails, CI sensors — or to act on harness-score audit findings and raise their maturity level.
  • 100harness-engineering
    Use when the user asks to improve, fix, or build their repository's AI harness — AGENTS.md, rules, skills, commands, hooks, guardrails, CI sensors — or to act on harness-score audit findings and raise their maturity level.
  • 90harness-engineering
    This skill should be used when the user asks about "harness engineering", "what is a harness", "harness framework", "AI code quality", "context engineering", "architectural constraints", "garbage collection for code", or wants to understand the conceptual foundation behind the…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.