agent-harness-reference

Solid

Field reference for Claude Code and GitHub Copilot CLI hook contracts. Covers hook locations, events, matchers, payloads, decisions, exit codes, timeouts, plugin roots, and cloud limits with official URLs and versioned probes. Use for `harness contract`, `copilot cli hook behavior`, `hook payload format`, `stale plugin root`, `Errno 2 _dispatch.py`, or before changing cross-harness hooks. Do NOT use to run the porting campaign (use `ai-agents-portability-campaign`).

AI & Automation 38 stars 13 forks Updated today MIT

Install

View on GitHub

Quality Score: 77/100

Stars 20%
53
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Agent Harness Reference Use this reference before changing a hook, dispatcher, generator, hook config, or runtime test. Do not repeat web research unless the refresh rules below say the recorded contract is stale. ## Triggers - `harness contract` - `copilot cli hook behavior` - `hook payload format` - `cross-harness hook change` - `refresh hook evidence` ## Process 1. Read `references/official-hook-contracts.md` for the authoritative row. 2. Read `references/probe-evidence.md` only for versioned runtime evidence. 3. Apply the repository policy in this file and the cited ADRs. 4. If a refresh condition applies, update sources, probes, tests, mirrors, and memory in the same change. 5. Mark an absent official answer `DOCS SILENT`. Do not infer it from Claude. ## Authority Order 1. `references/official-hook-contracts.md` records current official sources, pinned source commits, exact event sets, output fields, and docs gaps. 2. This file states the repository decisions derived from those contracts. 3. `references/probe-evidence.md` records versioned runtime observations. 4. ADR-068 and ADR-071 record the dispatcher and runtime verification choices. 5. Serena memories are retrieval aids. They do not override the sources above. If two sources disagree, use the official contract for authored behavior. Keep the conflicting probe as versioned evidence. Do not erase either side. ## Repository Loading Surfaces The repository keeps one canonical skill tree and one genera...

Details

Author
rjmurillo
Repository
rjmurillo/ai-agents
Created
7 months ago
Last Updated
today
Language
Markdown
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

ai-agents-portability-campaign

Execute cross-harness hook changes for Claude Code and GitHub Copilot CLI using the settled official contract, versioned probes, generators, and runtime tests. Use for `run the portability campaign`, `port hooks to a new harness`, `copilot hook timeout regression`, or `new copilot cli release, recheck the contract`. Do NOT use for fact lookup alone (use `agent-harness-reference`).

38 Updated today
rjmurillo
AI & Automation Solid

agent-harness-design

Designing agent harnesses and tool systems — risk taxonomy for tools, permission decisions, draft/commit pattern, structured tool results, agent budgets (10 types), context trust labels against prompt injection, plan-artifact, approval records, observability and traces, evals (13 categories), event model, streaming buffering, 3rd-party skill install checklist, agentic RAG, self-improving SOP loops, model policy, reasoning effort, and Programmatic Tool Calling adoption gates. Use when building a new Agent SDK app, custom orchestrator, MCP server, Cloudflare Worker with tool calls, agentic RAG pipeline, model router, or model-tier policy; when designing tools and permissions; when writing an agent loop; or when you need trust labels for external content. Do NOT use for improving or auditing an already-built harness (use harness-audit / harness-design instead), nor for ordinary Claude Code sessions where the harness is already given.

138 Updated yesterday
AnastasiyaW
AI & Automation Listed

craft-harness

Given a repo, decide where agent guidance belongs and make or propose the smallest useful harness change. Use for AGENTS.md/CLAUDE.md placement, skills, hooks, MCP, plugins, sync, or pruning.

0 Updated today
sungjunlee