repair-discipline SKILL.md skillA

repair-discipline from shimo4228/claude-harness is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add shimo4228/claude-harness/repair-discipline@git:20261010.b5821aa

Pins git:20261010.b5821aa in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
shimo4228/claude-harness
Path
skills/repair-discipline/SKILL.md
Versions recorded
6
Latest version
git:20261010.b5821aa, committed Oct 10, 2026
First version recorded
Aug 24, 2026
Size
4,238 bytes
Repository stars
3
License
MIT

Establish what is true now from primary evidence before a fix. Use when fixing a bug (このバグ直して), picking up a stale task, diagnosing something stuck or flaky, or changing a schema or storage format that anything else reads.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Repair Discipline

直す前に、いま何が真かを一次証拠で確定する。原則 1–3 は着手するとき、4–6 は原因を
診断するときに効く。6 原則とも実地の失敗から取った — どの repo でも同じ形で壊れる。

## 1. 着手前に既済照合

残課題ファイル・古い TODO・引き継ぎメモは書かれた時点の観測。着手前に **git log と
実コードで「もう直っていないか」を照合**する。台帳だけが古いまま残る drift は
「作業 → 資料 → 台帳」の最後の 1 ホップで起きる — 見つける経路は日付でなく
正本資料との突き合わせ(決着済みのタスクが数ヶ月 open のまま残る)。

## 2. schema / storage 変更は全消費者を同じ変更で棚卸す

データ形式・保存場所・フィールドを変えたら、**その形式を読む側を全部 grep して同じ
PR で追随させる**。書き手だけ直した変更は、読み手が静かに空を返す形で壊れる —
エラーでなく「何も無い」に見えるのが最悪の壊れ方。消費者は自コードとは限らない
(skill 本文・doc・別 script が名指しで読んでいることがある)。

## 3. bypass は単一ゲートでなく全ゲートを短絡すると知って使う

`SECRET_SCAN_BYPASS=1` 型の逃げ道は、既知の 1 件を通すためのつもりでも **hook が束ねる
全検査(format / lint / security)を一緒に飛ばす**。使う前に「この bypass が黙らせる
検査の全リスト」を言えるか確認し、言えないなら個別の除外手段を探す。

## 4. プロセスの CPU が低い ≠ stuck

I/O バウンドなプロセス(LLM 推論・ネットワーク待ち)は CPU がほぼ 0 でも正常に進行
している。**kill する前に一次ログと相手側の状態**(サーバの load 状況・進捗ログの
タイムスタンプ)を見る。「反応がない気がする」は証拠でない。

## 5. テストの再試行はフォアグラウンド 1 回

失敗したテストをバックグラウンドで連発しない。1 回フォアグラウンドで走らせ、出力を
読み切ってから次の仮説へ。連発は失敗ログを積むだけで情報を増やさず、リソース競合で
新しい偽の失敗を作る。

## 6. 断続的な失敗と時間の飛びは、環境の覆いを先に外す

「たまに成功する外部 API」と「wall time が job 自身のログの時刻より大きく飛ぶ処理」は、
コードの仮説より先に環境で説明できないかを一次記録で見る。**成功した応答の `x-cache` /
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add shimo4228/claude-harness/repair-discipline@sha256:b5c3d1b77c9e4b5f

The line at the top of this page pins the label git:20261010.b5821aa, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ugxdtf4ylejeytpl.svg)](https://markdownregistry.com/a/art_ugxdtf4ylejeytpl)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Aug 24, 2026 and Oct 10, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261010.b5821aa latest2026-10-10 b5821aa 4,238 BA view · diff
git:20261008.b63e5f12026-10-08 b63e5f1 4,233 BA view · diff
git:20261007.d62d71a2026-10-07 d62d71a 4,720 BA view · diff
git:20260923.e444d082026-09-23 e444d08 4,523 BA view · diff
git:20260919.f95d2312026-09-19 f95d231 3,695 BA view · diff
git:20260824.8c939552026-08-24 8c93955 3,757 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4238 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

shimo4228/claude-harness · 3 stars · license MIT · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ugxdtf4ylejeytpl
GET https://markdownregistry.com/api/v1/resolve?ref=shimo4228/claude-harness/repair-discipline
GET https://markdownregistry.com/api/v1/blob/b5c3d1b77c9e4b5f5310dda69de171e0e14423b468d9bb87398ec7e6920b1cfb

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from shimo4228/claude-harness

widen-depth SKILL.md skill
shimo4228/claude-harness · docs/evals/SKILL.md · 依頼を大きな版でなく深い版に書き直す。一流がやること・生の素材・方法と道具・外部の判定を引き出す。
git:20261018.9c2cf31 · audit A · 3 stars
llms-full.txt llms.txt file
shimo4228/claude-harness · llms-full.txt
git:20261010.7fd1204 · audit A · 3 stars
llms.txt llms.txt file
shimo4228/claude-harness · llms.txt
git:20261010.0028cd9 · audit A · 3 stars
adr-writer SKILL.md skill
shimo4228/claude-harness · skills/adr-writer/SKILL.md · Record a design decision as an ADR in the repo's docs/adr/, or decide whether it clears the filing bar or belongs in a…
git:20261010.b5821aa · audit A · 3 stars
agent-send SKILL.md skill
shimo4228/claude-harness · skills/agent-send/SKILL.md · Send a prompt to an agent running in a Herdr pane and confirm it landed, or wait until its work is done. Use when…
git:20261010.b5821aa · audit A · 3 stars
agent-stocktake SKILL.md skill
shimo4228/claude-harness · skills/agent-stocktake/SKILL.md · Audit the ~/.claude/agents definitions and give each a verdict.
v1.0 · audit A · 3 stars
author-calibrated-eval SKILL.md skill
shimo4228/claude-harness · skills/author-calibrated-eval/SKILL.md · Polish LLM-written prose with the author's own reading as ground truth.
git:20261008.b63e5f1 · audit A · 3 stars
authorship-strategy SKILL.md skill
shimo4228/claude-harness · skills/authorship-strategy/SKILL.md · Evaluate a concrete proposal against the author's authorship strategy, or apply and explain the existing judgment…
git:20261008.b63e5f1 · audit A · 3 stars
collect-context SKILL.md skill
shimo4228/claude-harness · skills/collect-context/SKILL.md · Collect sourced material into an evidence dossier before writing an article or essay. Use when gathering material for a…
git:20261008.b63e5f1 · audit A · 3 stars
context-sync SKILL.md skill
shimo4228/claude-harness · skills/context-sync/SKILL.md · Audit a repo's context documents (CLAUDE.md, ADRs, README, graph.jsonld) for role overlap and staleness against the…
git:20261011.dd38b78 · audit A · 3 stars
generation-audit SKILL.md skill
shimo4228/claude-harness · skills/generation-audit/SKILL.md · Audit the harness when a new Claude model takes a role (judge, build or everyday).
v2.0 · audit A · 3 stars
harness-boundary SKILL.md skill
shimo4228/claude-harness · skills/harness-boundary/SKILL.md · Design lens: which layer a harness mechanism belongs in, and whether it outlives the next model or runtime.
git:20261008.b63e5f1 · audit A · 3 stars

Every file in shimo4228/claude-harness

Browse by kind, by grade A, or by owner.