Harness Maintainer & Dictionary

ナレッジ昇華PRレビュー & オンデマンド逆引きトラブル辞書

JIT辞書ハブ同期完了
起票中のPR
3 件
承認 3 / 棄却 0
登録済み知見辞書
8 項目
GLOBAL_RULES.md (逆引き対応)
監視先プロジェクト
2 repos
gallant-maxwell, Dice Realms
次回定期スキャン
Mon 09:00
完全自動プッシュ連動済

ポケット知見辞書 (トラブル逆引き検索)

困った時やエラー発生時にキーワードで即時逆引きできるナレッジベース

CLI: .\harness rule find <query>
クイック検索:
未検証完了の禁止 Vitality: 100
❌ 禁止: 未検証での推論完了宣言
✅ 推奨: node -c またはテスト実行で Exit Code 0 を確認

理由: エラー早期検知。推論ハルシネーションによる構文破壊を排す。

大容量コマンド実行時のバッファ枯渇防止 Vitality: 100
❌ 禁止: 大容量出力やバイナリ抽出での execSync デフォルト呼出
✅ 推奨: ストリーム(spawn + stdout.pipe)または maxBuffer 明示指定

理由: 10MB超抽出時のデフォルト1MB超過によるプロセス落脱を防止。

バイナリ解析時の境界長アサーション Vitality: 100
❌ 禁止: バッファ長やオフセット未検証での固定ポインタ読み出し
✅ 推奨: assert(pos + length <= buf.length) による事前境界ガード

理由: チャンクポインタ不正によるクラッシュ・不正ビット深度読み取り防止。

再帰探索時の深さ制限と権限エラー耐性 Vitality: 100
❌ 禁止: 例外トラップなし・無制限の再帰的ファイル走査
✅ 推奨: Depth制限付き走査 + EPERM/EACCES の個別 catch/continue

理由: 環境依存の権限不足による探索全体の中断を防止。

ルール直接上書きの防止 Vitality: 100
❌ 禁止: エージェントによるプロジェクトルールの勝手な自己改変
✅ 推奨: .agent/rule_proposals.md へのPRドラフト起票

理由: 人間承認プロトコルの維持と自己改変事故防止。

テスト除外提案の禁止 (Anti-Goodhart) Vitality: 100
❌ 禁止: テスト除外項目の追加や合格基準の自己緩和
✅ 推奨: 肯定的代替実装による正しい仕様への修正

理由: グッドハートの法則によるテスト骨抜きを物理防御。

起票されたルール提案 (Pull Requests)

3 件
仕分け状況:
PR #1

決定論的検証先行

承認予定
禁止対象 (Forbidden)

未検証での推論完了宣言

LLMの推論完了のみを根拠とし、シンタックスチェックや単体テストなどの事後機械検証を行わずに作業完了とする行為。

推奨置換 (Positive Replacement)

node -c またはテスト実行による事後確認

スクリプト編集・生成直後は必ず言語別構文チェッカーや確定テストを実行し、Exit Code 0 を確認してから完了とする。

採用根拠 (Rationale):

構文・実行時エラーの早期検知。推論ハルシネーションによるサイレントな構文破壊を排し、決定論的パイプラインで品質を担保する。

承認用CLIコマンド (Decay Memory登録): 1-Clickでコピー
.\harness rule add --forbidden "未検証完了" --replacement "確定検証実行" --rationale "エラー早期検知" --pin
PR #2

バイナリ解析時の境界長アサーション義務化

承認予定
禁止対象 (Forbidden)

バッファ長やオフセット未検証での固定ポインタ読み出し

`buf.readUInt32BE(pos + offset)` 等において、チャンク長やバッファ末尾境界の妥当性を検証せずに固定加算で直接アクセスする記法。

推奨置換 (Positive Replacement)

チャンク読み取り前の境界長アサーションとスキーマ検証

`assert(pos + length <= buf.length)` による事前境界ガードを徹底し、ヘッダメタデータの型・範囲検証を先行させる。

採用根拠 (Rationale):

Dice Realms等でのPNGヘッダ・IHDRチャンク解析時に発生したポインタ不整合・不正ビット深度読み取りクラッシュの再発防止。

承認用CLIコマンド (Decay Memory登録): 1-Clickでコピー
.\harness rule add --forbidden "未検証固定オフセット読出" --replacement "境界長アサーションとスキーマ検証" --rationale "バイナリポインタ不整合防止" --pin
PR #3

大容量I/O・バイナリ抽出時のバッファ枯渇防止

承認予定
禁止対象 (Forbidden)

大容量出力やバイナリ抽出での execSync デフォルト呼び出し

`git show` や大容量コマンドで `maxBuffer` を指定せず同期実行し、上限(1MB等)到達時にプロセスを落とす行為。

推奨置換 (Positive Replacement)

ストリーム(spawn + stdout.pipe)または maxBuffer 明示指定

大容量データはストリーム処理でオンメモリ負荷を抑えるか、`maxBuffer: 10 * 1024 * 1024`(10MB)以上を明示的に確保する。

採用根拠 (Rationale):

Dice Realms等での10MB超リソース・バイナリ抽出時に発生した `maxBuffer` 超過クラッシュの防止。巨大データI/Oの堅牢性向上。

承認用CLIコマンド (Decay Memory登録): 1-Clickでコピー
.\harness rule add --forbidden "未指定execSync抽出" --replacement "ストリームまたはmaxBuffer明示" --rationale "バッファ枯渇クラッシュ防止" --pin
承認: 3 件 | 棄却: 0 件