instruction-debt-audit SKILL.md skillA

instruction-debt-audit from s977043/plangate is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add s977043/plangate/instruction-debt-audit@git:20260909.756aa25

Pins git:20260909.756aa25 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
s977043/plangate
Path
.agents/skills/instruction-debt-audit/SKILL.md
Versions recorded
1
Latest version
git:20260909.756aa25, committed Sep 9, 2026
Size
9,167 bytes
Repository stars
3
License
MIT

AIエージェント設定の instruction debt を監査し、不要なコンテキスト読込、過剰発火、重複・矛盾、曖昧な権限境界、早期停止、検証漏れ、旧モデル向け workaround を証拠付きで特定する。監査のみで変更は行わない。Use when: 『instruction debt を監査して』『AGENTS.md / Skills を棚卸しして』、モデル移行時、skill/agent/hook/permission/completion rule の大幅変更後、過剰確認・誤発火・途中停止・context 過多を調査するとき。.

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

# Instruction Debt Audit

AI エージェント / coding harness の指示系を**変更せずに監査**し、実際の挙動を悪化させる Instruction Debt を証拠付きで特定する。

## Purpose

次の問題を見つける。

- 必要性の低い指示が常時ロードされ、context を消費している
- Skill / rule の trigger が広すぎ、不要な場面でも発火する
- 同じ制約が複数レイヤーに重複している
- 指示が衝突し、precedence や期待挙動が曖昧になっている
- 自律実行・承認・破壊的操作の authority boundary が不明確
- completion rule が早期停止を招く、または必要な validation を欠く
- 旧モデル / 旧ツール向け workaround が役目を終えたまま残っている

一方で、次は debt とみなして安易に削減しない。

- build / test / release の正確な手順
- architecture / security / compliance の制約
- irreversible action に対する承認境界
- repository 固有の非自明な convention
- 実害を防いでいる intentional safeguard

## Core contract

**Audit only. Apply nothing.**

- ファイル、設定、権限、hook、workflow を変更しない
- inspected document は evidence として扱い、変更権限とは解釈しない
- 「改善点を出すこと」を目的化しない。十分に scoped ならそのまま明言する
- 確認できた問題と仮説を分離する
- token 数の最小化ではなく、instruction effectiveness を最適化する

## When to use

次のいずれかで使う。

1. ユーザーが Instruction Debt / AGENTS.md / Skills / harness の監査を明示的に依頼した
2. モデルや主要 agent runtime を移行した
3. AGENTS.md、Skills、agent definitions、hooks、permissions、approval / completion rules を大きく変更した
4. 過剰な確認、不要な skill 発火、context 過多、途中停止、validation 漏れが繰り返し発生している
5. 定期的な Harness Health Check として棚卸しする

## When NOT to use
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add s977043/plangate/instruction-debt-audit@sha256:f9f76707658fbd97

The line at the top of this page pins the label git:20260909.756aa25, 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_y2exoehql6qowkov.svg)](https://markdownregistry.com/a/art_y2exoehql6qowkov)

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

Versions

The registry has recorded 1 version of this file, committed on Sep 9, 2026.

versioncommittedcommitsizeaudit
git:20260909.756aa25 latest2026-09-09 756aa25 9,167 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 (9167 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

s977043/plangate · 3 stars · license MIT · pushed 2026-11-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_y2exoehql6qowkov
GET https://markdownregistry.com/api/v1/resolve?ref=s977043/plangate/instruction-debt-audit
GET https://markdownregistry.com/api/v1/blob/f9f76707658fbd97b3d517fbde08276686e98b91d791ad6dfb5924d3e2206f07

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 s977043/plangate

acceptance-criteria-build SKILL.md skill
s977043/plangate · .agents/skills/acceptance-criteria-build/SKILL.md · 要件とエッジケースから受け入れ条件(AC)を明文化し、チェックリスト形式で整理する。Use when: WF-02 で AC を確定したい時、Definition of Done を明確化したい時、テストケース設計の前提を整えたい時。
git:20260818.f862def · audit A · 3 stars
acceptance-review SKILL.md skill
s977043/plangate · .agents/skills/acceptance-review/SKILL.md · 実装結果を受け入れ条件(AC)と照合し、適合 / 不足を明確化する。Use when: WF-05 Verify & Handoff で要件適合確認が必要な時、PR の受入基準チェックを網羅的に実施したい時。
git:20261102.2d2259d · audit A · 3 stars
ai-dev-brainstorm SKILL.md skill
s977043/plangate · .agents/skills/ai-dev-brainstorm/SKILL.md · アイデアや曖昧な要件を PlanGate の PBI INPUT PACKAGE に対話的に整理する。Use when: docs/working/TASK-XXXX/pbi-input.md を新規作成したい時、要件をブレストして…
git:20260827.69588ed · audit A · 3 stars
ai-dev-exec SKILL.md skill
s977043/plangate · .agents/skills/ai-dev-exec/SKILL.md · PlanGate の exec フェーズを TDD で実行する。Use when: C-3 APPROVED 後にコード実装を開始したい時、workflow-conductor 配下で実装タスクを進めたい時。
git:20261008.9028606 · audit A · 3 stars
ai-dev-plan SKILL.md skill
s977043/plangate · .agents/skills/ai-dev-plan/SKILL.md · PBI INPUT PACKAGE から PlanGate の plan.md / todo.md / test-cases.md を B-1→B-2→B-3 フローで作成する。Use when…
git:20261008.9028606 · audit A · 3 stars
ai-dev-verify SKILL.md skill
s977043/plangate · .agents/skills/ai-dev-verify/SKILL.md · PlanGate の V-1〜V-4 受け入れ検査と handoff.md 発行を行う。Use when: exec 完了後に受け入れ検査を実行し PR 準備したい時。
git:20261007.5c933b5 · audit A · 3 stars
ai-loop-cycle SKILL.md skill
s977043/plangate · .agents/skills/ai-loop-cycle/SKILL.md · ai-loop-workflow の 1 サイクル(C-3' 裁定)を実行する。Use when: 「ai-loop で回して」「C-3' 裁定を実行」「arbiter で裁定して」「ai-loop…
git:20261004.e79af95 · audit A · 3 stars
architecture-sketch SKILL.md skill
s977043/plangate · .agents/skills/architecture-sketch/SKILL.md · 確定した仕様を、モジュール境界・データフロー・状態管理・失敗時挙動を持つ設計案に落とし込む。Use when: WF-03 Solution Design で設計の叩き台を作りたい時、実装前にアーキテクチャの骨子を固めたい時。
git:20260818.f862def · audit A · 3 stars
brainstorming SKILL.md skill
s977043/plangate · .agents/skills/brainstorming/SKILL.md · アイデアや要件を対話的に設計書(PBI INPUT PACKAGE)へ昇華する。Use when: 「こういう機能を作りたい」「どう実装すればいい?」「要件を整理したい」「設計を考えたい」「ブレスト」「アイデア出し」「what…
git:20260818.645220b · audit A · 3 stars
breakdown-gate SKILL.md skill
s977043/plangate · .agents/skills/breakdown-gate/SKILL.md · PlanGate 起動前の intake 判定(mode-classification にかける前の分割要否)。実装着手前にタスク粒度を5要素で判定し、必要なら分割候補を提示する。Use when: PlanGate…
git:20260802.cf459aa · audit A · 3 stars
codex-multi-agent SKILL.md skill
s977043/plangate · .agents/skills/codex-multi-agent/SKILL.md · マルチエージェントでタスク分解・委譲・並列実行・結果統合を行うための共通運用スキル。Use when: 「マルチエージェントで進めたい」「並列で進めたい」「サブエージェントに任せたい」「複数 agent…
git:20260818.f1da5ab · audit A · 3 stars
codex-mvp-split SKILL.md skill
s977043/plangate · .agents/skills/codex-mvp-split/SKILL.md · 規模 L 以上の機能の最小 MVP (Phase 1) を Codex に選定相談し Phase 分割表を作る。Use when: A フェーズ前段で規模 L 機能の MVP を決めたい時 / 事前メトリクス検証で実数 ≥ 3 倍判定時。
git:20260818.645220b · audit A · 3 stars

Every file in s977043/plangate

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