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).
- Author
- hanspeterdietiker ↗
- Repository
- open-agent-skills ↗
- Licence
- MIT
- Last repository change
- 12.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 4
No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.
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
- 🧠 Contexto e Mentalidade (Baseado na [MindStudio](https://mindstudio.ai/blog/loop-engineer
- 🎯 Objetivo do Assistente (Claude)
- 📋 Regras de Operação
- 🛠️ Fluxo de Trabalho (Workflow)
- Créditos / Credits
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
| Repository | Score | Licence |
|---|---|---|
| This page · hanspeterdietiker/open-agent-skills | 90 | MIT |
| me-cedric/Shipyard | 90 | MIT |
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…