harness-boundary

Solid

agent 環境に mechanism(rule / skill / hook / agent / workflow / runtime 拡張 / prompt chain)を追加・変更・レビューするとき、それが 6 層(model capability / skill = 手続き記憶 / values・policy / eval / data・memory / runtime)のどこに属するか、なぜモデル自身に任せられないか、次のモデル世代で不要になるか、runtime を Claude Code → Pi → Codex と交換しても残す価値があるかを問い、Keep / Move / Simplify / Make temporary / Delete / Defer を返す設計レンズ。Use when — 「これはハーネスに入れるべきか」「どの層に置くか」「モデルに任せられないか」「runtime 変えても残るか」「harness が肥大している」「この hook / rule / workflow を足していい?」, when implementation-chain の Plan で harness 自体(~/.claude の rules / skills / hooks / agents / settings)を変更する task と判定されたとき, or /harness-boundary. Delete / Simplify は成功として扱う。NOT for — 未構築物の build-or-not 単体(→ agent architect)、設置済み資産の定期監査と Retire / Dissolve の verdict(→ rules-stocktake / skill-stocktake / agent-stocktake。本 skill は証拠を渡すだけ)、世代交代時の一括照合(→ generation-audit)、loop 構��の妥当性(→ loop-design-check)、harness の作り方の処方(→ agent-harness-construction)。

AI & Automation 3 stars 0 forks Updated 5 days ago MIT

Install

View on GitHub

Quality Score: 82/100

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

Skill Content

# harness-boundary — harness を捨てても残るものだけを資産にする設計レンズ 「ハーネスこそ資産」は半分しか正しくない。モデル固有の弱点を補う harness logic は モデル世代ごとに陳腐化し、runtime(tool 実行・permission・state・retry・agent loop)は 標準化と置換が進む。残るのは harness の中に**混在している別の層**だ。この skill は mechanism を追加・変更・レビューするときに、その混在を分解するための問いを出す。 これは architecture の強制ではなく、資産境界・可搬性・陳腐化を判断するレンズである。 ## 中心原則 - Model capability はモデルに置く。harness で再実装しない - Procedural knowledge は skill に置く - Values と責任境界は明示的で検査可能な形に保つ - Quality の定義は eval に置く - Domain 知識と履歴は data / memory に置く - Runtime は実用上できる限り薄く、交換可能に保つ そして: **harness を保存するために最適化しない。harness を交換しても残るべきものを 保存するために最適化する。** 新しいモデルが既存 logic を不要にしたなら、それは設計の 失敗ではなく削除のタイミングである。Delete / Simplify は成功として扱う。 ## 6 層 | 層 | 中身 | この harness での対応物 | 既存語彙 | |---|---|---|---| | Model capability | reasoning / planning / coding / tool-use 判断 / self-correction / decomposition / reflection | Claude 本体(system prompt + tool description を含む) | substrate、generation-audit の runtime 層 | | Skills(手続き記憶) | この task はこの手順 / このレビューはこの観点 / この障害はこの runbook / この成果物はこの検証 | `skills/*/SKILL.md`、`agents/*.md` の本文 | 「手順は skill」(rules/README.md) | | Values / Policies / 責任境界 | 何を優先するか / 何をしないか / 人間承認が要る操作 / 委譲範囲 / 正本 / 失敗時の優先 | `rules/common/`(identity / values 層、ADR-0018 D7)、`settings.json` の permissions、task request の権限 | 「環境固有の事実・配線・罠」(ADR-0035) | | Evals | acceptance criteria / tests / rubric / benchmark / regression / quality gate | `.claude/verify.sh`、`tests/`、`skill-comply`、`llm-as-judge`、judge agent(readme-judge 等) | Verify、binding 判定 | | Data / ...

Details

Author
shimo4228
Repository
shimo4228/claude-harness
Created
4 months ago
Last Updated
5 days ago
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

harness-engineering

Design the harness — the 8-layer scaffolding around the LLM loop that makes agents reliable. Covers the agent loop itself (gather/act/verify), context management, durable execution, guardrails, human-in-the-loop, evals, observability, and the cross-cutting security & identity layer. In production agents, the harness is 98% of the code. Use whenever the user is structuring code around an agent loop, asks "how do I make this reliable / production-ready," is implementing verification, retry logic, sub-agent delegation, permission systems, approval gates, or wants to understand what makes Claude Code / Codex / Devin work beyond the model.

14 Updated 1 months ago
Moai-Team-LLC
Testing & QA Listed

harness-init

把 harness 制度層(模型調度/停損熔斷/派工模板/知識協議)實例化到一個專案 workspace。當使用者說 /harness:init、「幫這個專案裝 harness」、「實例化 harness」、「把制度層搬到 X 專案」時觸發。流程=盤點→決策→骨架填空→機械驗收;不是複製既有專案的檔,是用通用骨架填入目標專案的已查證事實。

2 Updated today
abs1294
AI & Automation Listed

harness-engineering

Principles and judgment for designing an "agent harness" — the repo-level scaffolding (docs, feedback loops, constraints, memory, review gates) that lets AI coding agents work reliably and autonomously on a codebase. Use this whenever the user asks to make a repo more agent-friendly, set up or audit AGENTS.md/CLAUDE.md, improve how well Claude Code (or another agent) performs on their project, design feedback loops or verification gates for agents, decide what should go in project docs vs skills vs memory, or is generally trying to get better/more reliable results from AI coding agents on a specific codebase. Do not treat this as a rigid setup script — apply the principles to the specific project's language, size, team, and risk profile, and recommend only what that project actually needs.

0 Updated 6 days ago
Samjoel3101