К основному содержанию
плагин CX Codex

claude-code-harness — плагин для Claude Code: блюпринт харнесса

Плагин claude-code-harness помогает превратить смутную идею агента в блюпринт рантайма: сборка запроса, цикл хода, права инструментов, память, восстановление.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install claude-code-harness@awesome-codex-plugins
Открыть на GitHub

Что делает claude-code-harness

Скилл собирает блюпринт рантайма вокруг агента: как склеивается запрос к модели, как идёт цикл хода, где живут инструменты и права, что переживает перезапуск. На выходе — план по пунктам, от цели системы и границ делегирования до модели восстановления и порядка сборки. Промпт тут ни при чём.

Сам скилл короткий, глубина в справочниках harness-principles.md и harness-pattern-language.md со словарём для слоёв рантайма. Заставляет расписать то, что обычно пропускают: источники инструкций, критерии успеха для каждого инструмента, откат, сжатие памяти, точку одобрения человеком. Есть отдельный разбор расширений через плагины, MCP и субагентов.

Проект неофициальный, к Anthropic отношения не имеет. Для задачи «сделай промпт получше» или обычной реализации без проектирования рантайма он лишний — автор сам выносит такие случаи за скобки. В Codex после установки нужен перезапуск.

Какие задачи решает

  • расписать сборку запроса: источники инструкций, контекст, список инструментов
  • поставить гейты прав и одобрение человеком на вызовы инструментов
  • решить, что осядет в долгой памяти, а что сожмётся при компактификации
  • описать продолжение работы после обрыва, когда половина сделана
  • понять, нужен ли проекту харнесс вообще или хватит скрипта

Примеры запросов агенту

  • /claude-code-harness:claude-code-harness Собери блюпринт харнесса для агента, который правит файлы в репозитории.
  • /claude-code-harness:claude-code-harness Проверь, есть ли у этой мультиагентной затеи цельный харнесс.
  • $claude-code-harness Преврати эту сырую идею оператора в блюпринт рантайма.

Как установить claude-code-harness

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install claude-code-harness@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о claude-code-harness

Как установить claude-code-harness в Claude Code?

Сначала добавьте маркетплейс: /plugin marketplace add hashgraph-online/awesome-codex-plugins. Потом поставьте плагин: /plugin install claude-code-harness@awesome-codex-plugins.

Что делает claude-code-harness?

Разворачивает идею агента в блюпринт рантайма: сборка запроса, цикл хода, права инструментов, память, восстановление, точки расширения.

Чем он отличается от claude-code-philosophy?

Тот шире и про агентный продукт в целом. Этот уже и только про рантайм вокруг модели: сборка запроса, цикл, память, транскрипт.

Исходный текст

claude-code-harness · MIT
# Claude Code Harness

[![Featured in awesome-agent-skills](https://img.shields.io/badge/featured%20in-awesome--agent--skills-2563eb?style=flat-square)](https://github.com/heilcheng/awesome-agent-skills)
[![Featured in awesome-codex-plugins](https://img.shields.io/badge/featured%20in-awesome--codex--plugins-0f766e?style=flat-square)](https://github.com/hashgraph-online/awesome-codex-plugins)

> Turn an agent idea into a real harness blueprint.

`claude-code-harness` is a public skill and plugin package for developers who want to design the runtime around an agent, not just the prompt inside it.

It is inspired by Claude Code's harness design and generalized into a reusable pattern language for building agentic systems with clearer request assembly, tighter control loops, safer tool boundaries, and stronger recovery behavior.

This project is unofficial. It is not affiliated with Anthropic.

## What a harness is

A harness is the layer that turns a model into an operating system for work.

It decides:

- how a request is assembled
- how a turn progresses
- what tools exist and how they are governed
- what memory survives which boundary
- what gets logged, resumed, compacted, or escalated
- how a human can still understand and control the system

```mermaid
flowchart LR
    U["User / Host"]
    RA["Request Assembly<br/>instructions + context + tools + history"]
    TL["Turn Loop<br/>gather → think → act → verify"]
    TP["Tool Plane<br/>capabilities + permissions"]
    MP["Memory Plane<br/>context + durable memory + compaction"]
    TR["Transcript / Recovery<br/>logs + resume + continuity"]
    EP["Extension Plane<br/>plugins + MCP + subagents"]

    U --> RA --> TL
    TL --> TP
    TL --> MP
    TL --> TR
    TP --> TL
    MP --> TL
    TR --> TL
    EP --> TL
```

## Why this repo exists

Most agent projects still stop at one of these weak states:

- a prompt with a tool list
- a loop with no governance
- memory with no boundaries
- autonomy with no control surface
- retries with no recovery model

This repo is meant to force a higher bar.

The question it keeps asking is:

**What is the harness here, exactly?**

## What this skill does

This repository currently ships one skill:

- `claude-code-harness`

The skill helps you produce a **harness blueprint** for an agentic system. It pushes you to specify the runtime planes that are usually hand-waved away.

| Plane | What the skill forces you to define |
|------|--------------------------------------|
| Request assembly | instruction sources, system/user context, tool exposure, transcript normalization |
| Turn loop | gather, decide, act, verify, stop/retry/escalate |
| Tool plane | capability contracts, permission gates, success criteria, rollback story |
| Memory plane | active context, retrieval, durable memory, compaction |
| Recovery plane | transcript, resumability, partial work, continuity |
| Human control | approvals, visibility, interruption, auditability |
| Extension plane | plugins, MCP, subagents, future expansion points |

## When to use it

Use this skill when you need to answer questions like:

- What is the runtime shape of this agent?
- How should we assemble each model request?
- What are the real boundaries between loop, tools, memory, and persistence?
- Where should permissions and approvals live?
- How would this system recover from interruption or partial failure?

Do **not** use it when you only need:

- a better prompt
- a generic product brainstorm
- a feature list for an AI app
- plain implementation tasks with no runtime design problem

## How this differs from `claude-code-philosophy`

`claude-code-philosophy` is broader. It helps people design better agentic products in general.

`claude-code-harness` is narrower and sharper. It is specifically about the runtime architecture around the model:

- request assembly
- control loop
- capabilities
- memory boundaries
- transcript and recovery

If `claude-code-philosophy` asks “what kind of agent product should this become?”, this repo asks “what harness must exist for that product to actually work?”

## What a good output looks like

When the skill is doing its job, the result should look like a blueprint, not a pep talk.

The default output shape includes:

1. system goal and delegation boundary
2. harness layers
3. request assembly design
4. turn loop design
5. tool runtime and permission boundaries
6. memory and context strategy
7. transcript and recovery model
8. extension surfaces
9. build order

## Quick install

| Platform | Install | Invoke |
|---------|---------|--------|
| Codex | `$skill-installer install https://github.com/dadwadw233/claude-code-harness/tree/main/skills/claude-code-harness` | `$claude-code-harness` |
| Claude Code plugin | `/plugin marketplace add dadwadw233/claude-code-harness` then `/plugin install claude-code-harness@claude-code-harness` | `/claude-code-harness:claude-code-harness` |
| Claude Code standalone | copy `skills/claude-code-harness` to `~/.claude/skills/claude-code-harness` | `/claude-code-harness` |

Restart Codex after installing a new skill.

## Example prompts

### Codex

- `Use $claude-code-harness to design a harness for this coding agent.`
- `Use $claude-code-harness to turn this vague operator idea into a runtime blueprint.`
- `Use $claude-code-harness to decide whether this workflow needs a real harness or just a simpler script.`

### Claude Code plugin install

- `/claude-code-harness:claude-code-harness`
- `/claude-code-harness:claude-code-harness Design a harness for a repo-writing agent with request assembly, permissions, and recovery.`

### Claude Code standalone skill install

- `/claude-code-harness`
- `/claude-code-harness Review whether this multi-agent idea really has a coherent harness.`

## Advanced install notes

### Codex local plugin install

```bash
git clone [email protected]:dadwadw233/claude-code-harness.git
mkdir -p ~/.codex/plugins
cp -R /absolute/path/to/claude-code-harness ~/.codex/plugins/claude-code-harness
```

Create or update `~/.agents/plugins/marketplace.json`:

```json
{
  "name": "personal-plugins",
  "interface": {
    "displayName": "Personal Plugins"
  },
  "plugins": [
    {
      "name": "claude-code-harness",
      "source": {
        "source": "local",
        "path": "./.codex/plugins/claude-code-harness"
      },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Productivity"
    }
  ]
}
```

### Claude Code manual install

```bash
mkdir -p ~/.claude/skills
cp -R skills/claude-code-harness ~/.claude/skills/claude-code-harness
```

## Reference files

The skill itself stays concise. Depth lives in the references:

- `harness-principles.md`
  What a harness is, why it matters, and why request assembly is central.
- `harness-pattern-language.md`
  A reusable vocabulary for runtime planes such as request assembler, turn loop, transcript spine, and recovery plane.
- `harness-blueprint-template.md`
  The exact blueprint shape the skill should produce.
- `claude-code-derived-insights.md`
  The Claude Code-inspired lessons that were generalized into this skill.

## Repository structure

```text
.
├── .claude-plugin/
│   ├── marketplace.json
│   └── plugin.json
├── .codex-plugin/
│   └── plugin.json
├── .agents/plugins/
│   └── marketplace.json
└── skills/
    └── claude-code-harness/
        ├── SKILL.md
        ├── LICENSE.txt
        ├── agents/
        │   └── openai.yaml
        └── references/
            ├── claude-code-derived-insights.md
            ├── harness-blueprint-template.md
            ├── harness-pattern-language.md
            └── harness-principles.md
```

## Design stance

This project is opinionated.

It prefers:

- smaller loops over theatrical orchestration
- explicit control planes over vague autonomy
- bounded power over hidden power
- recoverability over one-shot cleverness
- runtime architecture over prompt mysticism

## Inspiration

This repo is strongly informed by:

- Claude Code's request assembly and runtime structure
- Claude Code's turn loop, memory maintenance, and transcript/recovery model
- official OpenAI/Codex skill and plugin conventions
- Claude Code plugin and marketplace conventions
- broader agent skills repositories that present skills as shareable, reusable building blocks

## Non-goals

This project is not trying to:

- clone Claude Code
- be a full agent framework
- make every workflow autonomous
- replace implementation with architecture theater

It is trying to help developers design stronger harnesses.

© Yuanhong Yu · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
test-harness zernie Скилл test-harness для Claude Code тестирует харнес — хуки, скиллы, настройки и CLAUDE.md. Запускается на каждом коммите, две из трёх ступеней бесплатны и не требуют API-ключа. CX Codex +1 2 100установок create-harness-spec hedera-dev Превращает идею фичи Hedera в готовый harness-рецепт: PRD, spec.yaml, валидаторы и опциональные стадии. Проводит «гриллинг» — серию уточняющих вопросов — и выдаёт файлы только после подтверждения. CX Codex +1 593установок harness-spec-anatomy hedera-dev Скилл harness-spec-anatomy для Claude Code, Codex, Cursor и других агентов: хранит общий словарь структуры hedera-harness v3 — файлы, дефолты, стадии, правило blind/evaluate-checklist. CX Codex +1 592установок meta-harness-optimization reason-machines Скилл meta-harness-optimization для Claude Code, Codex, Cursor, Copilot и Gemini CLI, который запускает автоматический поиск по пространству обвязок модели — кода, управляющего памятью, retrieval и контекстом. CX Codex +1 420установок harness-engineering guanyang Скилл harness-engineering для Claude Code и других платформ проектирует обвязку автономного агента: поверхности редактирования, обратную связь, логи и точки одобрения. Включается при построении циклов исследования и экспериментов. CX Codex +1 204установок MetaGO Agent Harness metago-ai MCP-сервер MetaGO Agent Harness для Claude Code и Codex добавляет 55 инструментов и 8 промптов для контроля галлюцинаций, многослойной памяти и самогенерации навыков. Работает через stdio. CX Codex +1 ★ 6звёзд репо

Из того же набора391

Весь набор →
click Плагин click управляет инкрементальным запуском тестов в Claude Code и Codex. Пропускает нетронутые проверки и выдаёт короткие квитанции вместо длинных логов. CX Codex ★ 1 596звёзд репо clean-room Плагин clean-room разделяет анализ разрешённого исходного кода и чистую реализацию. Он пригодится для подготовки поведенческих спецификаций без переноса исходных материалов в код. CX Codex ★ 1 596звёзд репо claudemon Плагин claudemon превращает агентов Claude в пиксельных существ: за ними видно работу в файлах, а в перерывах открывается Clawland, одиночный .io-бравлер. CX Codex ★ 1 596звёзд репо claude-code-skills Плагин добавляет в Claude Code набор навыков и агентских инструментов для задач разработки и других доменов. Навыки задают агенту инструкции и рабочие процессы. CX Codex ★ 1 596звёзд репо cc Плагин cc запускает ревью кода, аудит архитектурных решений и фоновые задачи Claude Code прямо из рабочего процесса Codex. CX Codex ★ 1 596звёзд репо claude-code Связывает Codex с локальным Claude Code CLI через MCP. Подходит для проверки статуса, входа и запуска запросов в безопасном режиме. CX Codex ★ 1 596звёзд репо chatgpt-agent Плагин chatgpt-agent для Claude Code и Codex подключает ChatGPT как ревьюера, советника, редактора или исполнителя. Работает через ZIP-пакет, MCP или GitHub. CX Codex ★ 1 596звёзд репо casefile Плагин casefile ведёт журнал уязвимостей для CTF, аудитов и bug bounty с автоматической проверкой PoC в Docker. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой