プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Krusch Grounded Harness

✓ 提供元 · krusch.dev

作者:kruschdevバージョン 0.2.1i★ 0iパソコンで動く公式サイト ↗
レジストリ名dev.krusch/grounded-harness

インストール方法

What it does

Turn-0 workspace grounding, spin-loop blocker, and defect-only stop gate for AI coding agents.

  • Connects パソコンで動く
  • Account or key No key needed
  • Category 開発者ツール

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

rea

Reverse engineer anything with agents, from app behavior down to native binaries.

作者:morluto★ 467,2351 個の skill

Skill · 手順書

andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

作者:multica-ai★ 234,1251 個の skill

Skill · 手順書ライセンス記載なし

graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

作者:Graphify-Labs★ 149,8731 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア12/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Krusch Grounded Harness をインストールして。https://mcp.popnx.com/i/krusch-grounded-harness.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月19日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Krusch Grounded Harness を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "grounded-harness": { "command": "npx", "args": [ "-y", "krusch-grounded-harness", "mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Krusch Grounded Harness のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "grounded-harness": {
          "command": "npx",
          "args": [
            "-y",
            "krusch-grounded-harness",
            "mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Krusch Grounded Harness を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Krusch Grounded Harness を使っていると言うか、回答に Krusch Grounded Harness のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Krusch Grounded Harness につなげません

Krusch Grounded Harness はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Krusch Grounded Harness につなげるアプリを使う

  • 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)

B · 開発者ツール の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Krusch Grounded Harness を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user grounded-harness -- npx -y krusch-grounded-harness mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Krusch Grounded Harness のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user grounded-harness -- npx -y krusch-grounded-harness mcp
  4. Claude Code で /mcp と入力

    Krusch Grounded Harness が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Krusch Grounded Harness を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Krusch Grounded Harness を使っていると言うか、回答に Krusch Grounded Harness のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Krusch Grounded Harness を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "grounded-harness": { "command": "npx", "args": [ "-y", "krusch-grounded-harness", "mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Krusch Grounded Harness のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Krusch Grounded Harness を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Krusch Grounded Harness を使っていると言うか、回答に Krusch Grounded Harness のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Krusch Grounded Harness を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "grounded-harness": { "type": "stdio", "command": "npx", "args": [ "-y", "krusch-grounded-harness", "mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Krusch Grounded Harness のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Krusch Grounded Harness を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Krusch Grounded Harness を使っていると言うか、回答に Krusch Grounded Harness のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Krusch Grounded Harness を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user grounded-harness -- npx -y krusch-grounded-harness mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "grounded-harness": {
      "command": "npx",
      "args": [
        "-y",
        "krusch-grounded-harness",
        "mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "grounded-harness": {
      "command": "npx",
      "args": [
        "-y",
        "krusch-grounded-harness",
        "mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "grounded-harness": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "krusch-grounded-harness",
        "mcp"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
確認済みドメイン
✓ krusch.dev
接続方法
パソコンで動く
最新バージョンi
0.2.1
レジストリ公開日i
2026年11月19日
コードの最終更新i
2026年11月19日
作者
kruschdev
パッケージ
npm: krusch-grounded-harness
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン krusch.dev で確認済みです(レジストリがドメインの所有を確認しています)

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:今日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に krusch-grounded-harness@0.2.1 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月19日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/krusch-grounded-harness.svg)](https://mcp.popnx.com/en/servers/krusch-grounded-harness)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

開発者ツールのほかのサーバーとの比較i

  • このカテゴリのほかの6116件のうち0%よりスターが多い
  • このカテゴリのほかの6116件のうち99%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの6116件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Krusch Grounded Harnessは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は今日、最新バージョン(0.2.1)がレジストリに届いたのは今日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

作者:ahmedkhaleel2004広く使われている★ 1.9万2 か月前更新

クラウドで動く✓ 提供元 · gitdiagram.comPopNx チームが実際に試用

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

作者:Appllama広く使われている★ 52303 か月前更新

クラウドで動く✓ 提供元 · appllama.io

Omnara

Deploy durable AI agents with Omnara, an open-source managed-agent platform.

作者:omnara-ai広く使われている★ 34172 か月前更新

クラウドで動く✓ 提供元 · omnara.com

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

作者:repowise-dev広く使われている↓ 6506/週★ 8180 リポジトリ全体のスター6 日前更新

パソコンでもクラウドでも✓ 提供元 · repowise.dev
似たものと比べる
これ
Krusch Grounded Harness
GitDiagramAppllamaCloudflare MCPOmnaraRepowise
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使える
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえはいいいえいいえ
基本チェック3/34/44/44/44/45/5
ライセンスMITMITMITApache-2.0Apache-2.0AGPL-3.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Krusch Grounded Harness (krusch-grounded-harness v0.2.0)

Standalone Turn-0 workspace grounder, duplicate-call spin-loop blocker, and zero-turn defect-only output gate for AI coding and data agents. Runs 100% locally on Node 22 `node:sqlite` (`7` MCP tools + HTTP `:3782` gateway + ESM library) with zero cloud calls.

Turn-0 Grounded, Scale-Aware, Low-Tool-Call Agent Harness (HTTP :3782 Control Gateway + 7-tool stdio MCP Server + Node 22 ESM library) built on @krusch/toolkit (v1.8.1).


⚡ 30-Second Standalone Quickstart (Zero Cloud, Zero Docker)

1. Clone, Test & Ground Any Workspace Locally

Requires only Node.js `>= 22.0.0` (uses built-in node:sqlite in WAL mode with zero Docker containers, zero native C++ compilation, and zero API keys):

git clone https://github.com/kruschdev/grounded-harness.git

cd grounded-harness npm ci npm test

Verify SQLite WAL engine, 7 annotated MCP tools, and v0.2.0 invariants

node bin/krusch-grounded-harness.js doctor

Compile Turn-0 workspace schemas, dataset hazard flags & Raw-RAG chunks (0 LLM calls)

node bin/krusch-grounded-harness.js ground --dir . --goal "Inspect workspace schemas and hazards"

2. Connect to Your Agent (.mcp.json / Cursor) or Run via krusch-stack

Paste into your project .mcp.json, Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), or Antigravity (~/.gemini/antigravity/mcp_config.json):

{

"mcpServers": { "krusch-grounded-harness": { "command": "node", "args": ["/absolute/path/to/grounded-harness/bin/krusch-grounded-harness.js", "mcp"] } } }

Prefer a zero-clone npx command or single-package ESM import? Run the bundled engine directly through krusch-stack:

# Start the 7-tool stdio MCP server without cloning a separate repo

npx -y krusch-stack mcp --server krusch-grounded-harness

// Embed via krusch-stack (zero external runtime dependencies) or standalone package

import { createGroundedHarnessEngine } from 'krusch-stack/grounded-harness'; // Standalone repo import: import { createGroundedHarness } from 'krusch-grounded-harness';


🩹 Before vs. After (What It Fixes)

Common Agent Failure ModeWithout krusch-grounded-harnessWith krusch-grounded-harness ($0.00, 0 Cloud Calls)
Blind file foraging & CSV `"NA"` = North America `NaN` corruptionWastes 60%–75% of turns running ls/head/cat and silently drops "NA" country codes as NaN or misreads JSON null vs. [] wildcards.compileTurnZeroGrounding introspects RFC-4180 CSV/TSV, JSON/JSONL, read-only SQLite DDL, code symbols, and 256/32-tok Raw-RAG docs before Step 1, flagging keep_default_na=False and null/[] hazards automatically.
Identical failing or redundant tool-call spin loopsRe-runs the same broken query or file read with tweaked comments/whitespace, burning context and API budget.normalizeCodeSnippetForHash strips comments outside strings (preserving Python // floor division) to serve MEMOIZED_PRIOR_READ on repeats and BLOCK_SPIN_LOOP (0 wasted re-executions) on repeat failures while keeping maxReadStreak = 0 for distinct reads.
Raw `np.float64(...)` / ` ` leaks or self-doubt nudgesLeaks raw np.float64(...), pandas dtype:, XML, or NaN into final answers, or loses accuracy from unconditional "are you sure?" stop-nudges.inspectOutputDefects approves clean answers in `0` extra turns and triggers a single targeted repair (maxDefectRetries = 1) strictly on objective output defects.

🧩 Ecosystem Fit (Use Standalone or Combined)

krusch-grounded-harness has zero runtime service dependencies and works standalone out of the box, or pairs cleanly with sibling tools when you want deeper state guarantees:

  • [`krusch-context-mcp`](https://github.com/kruschdev/krusch-context-mcp) (Persistent Working Memory): Pair Turn-0 workspace grounding with cross-session episodic memory, decision lineage, and pre-commit invariant nudges (5 MCP tools on node:sqlite).
  • [`krusch-coding-harness`](https://github.com/kruschdev/krusch-coding-harness) (2PC Staged File Diffs): Add content-addressed diff staging, Bubblewrap sandbox verification, and SIGKILL-recoverable write-ahead disk apply for unattended background daemons.
  • [`krusch-stack`](https://github.com/kruschdev/krusch-stack) (Unified One-Command Bundle): Run Turn-0 grounding alongside memory, Git/AST symbol graphs, and staged execution via npx -y krusch-stack init (supports --server krusch-grounded-harness, --components grounded-harness, and --profile coding-agent).

⚡ Overview & Six Empirical Design Laws (INV-GH-01..10)

Distilled from 16,800 Official DolphinBench traces (28 official 600-task multi-session tool runs across 6 model families: 17 $0.00 open-weights + 11 frontier/model-matched runs, 98.33% Oracle@28, 83.17% $0.00 Oracle@17), 120 DABstep multi-step analytics episodes, BEAM (100K–10M tokens), and BFCL v3 (64 live tools), krusch-grounded-harness replaces unconditional outer-loop 2PC stop-nudging with six zero-overhead-when-healthy structural laws:

  1. Turn-0 Schema + `Raw-RAG` Briefing with Dataset Hazard Flags (`INV-GH-01`, `INV-GH-02`)
  • compileTurnZeroGrounding introspects RFC-4180 CSV/TSV columns, JSON/JSONL object arrays, read-only SQLite DDL & row counts, code symbols, and 256/32-token Raw-RAG documentation chunks with `0` LLM ingestion calls, paired with Okapi BM25 tool deferral (-70% to -80% schema tokens) and SHA-256 prefixHash KV-cache normalization.
  • Explicitly flags CSV `"NA"` string literals (keep_default_na=False in pandas.read_csv) and JSON `null` vs. empty-list `[]` wildcards before Step 1 (skipping .env / secret files automatically).
  1. Gemini Tool-Less `functionCallingConfig: { mode: "NONE" }` Guard (`INV-GH-09`)
  • buildSafeGeminiToolConfig (and buildGeminiPayload in @krusch/toolkit/llm) automatically injects toolConfig: { functionCallingConfig: { mode: 'NONE' } } whenever tools is omitted or empty [], eliminating MALFORMED_FUNCTION_CALL empty turns on markdown ```py code blocks.
  1. **Zero-Turn *Defect-Only* Output Gate (inspectOutputDefects, INV-GH-05)**
  • Approves clean completions in `0` extra turns while blocking objective output defects (maxDefectRetries = 1):
  • EMPTY_OR_NULL_BAILOUT: literal "", None, null, NaN, [], {} when an answer is expected (never blocking "0", 0, false, "Not Applicable", or "N/A").
  • TRUNCATED_OUTPUT: finishReason in MAX_TOKENS / length / MALFORMED_FUNCTION_CALL or truncated tool JSON.
  • SERIALIZED_TOOL_CALL_IN_TEXT: raw {...} or call:fn{...} emitted in prose when toolCalls.length === 0.
  • RAW_DATAFRAME_OR_NUMPY_REPR: unformatted np.float64(...) or pandas dtype: repr leaks in final answers.
  1. Quote-Safe Comment-Normalized Call Hashing (`BLOCK_SPIN_LOOP`) & `maxReadStreak = 0` (`INV-GH-04`)
  • normalizeCodeSnippetForHash strips comments outside string literals (preserving Python // floor division and indentation) prior to SHA-256 hashing. First repeats of COMMITTED reads return MEMOIZED_PRIOR_READ with cached preview; repeat identical FAILED calls or repeats after MEMOIZED_PRIOR_READ return BLOCK_SPIN_LOOP with 0 tool re-executions. Distinct multi-step reads (1..N) are never throttled (maxReadStreak === 0).
  1. Scale-Aware Thinking Curve & Staged-Diff-Only `FORCE_VERIFY` (`INV-GH-03`, `INV-GH-05`)
  • SMALL_MODEL (< 15B non-thinking) receives compact [PLAN -> BIND -> ACT] guidance plus placeholder ({{var}}) and invalid-calendar-date soft-holds (HOLD); MID_MODEL (15B–70B) and FRONTIER_REASONING (>= 70B or native thinking) execute with 0 outer thinking overhead. FORCE_VERIFY fires strictly when `pendingDiffsCount > 0 && !latestVerificationPassed`, never on read-only analytics or policy abstentions.
  1. Partial `stdout` Preservation on Sandbox Timeouts (`INV-GH-10`)
  • execCommandWithPartialStdout and formatTimeoutWithPartialStdout preserve partial stdout emitted prior to timeout alongside TimeoutError while clearing stale finalAnswer: null (hasFinalAnswer: false).

📊 Empirical Benchmark Results (4,200 Grounded / 16,800 Total Official DolphinBench Traces & 120 Adyen DABstep Episodes)

1. Official DolphinBench Multi-App Suite (7 × 600 = 4,200 Grounded Traces Within 28 Runs / 16,800 openai/gpt-5.6-sol Traces, 0o444 Frozen SQLite, 5/5 Clean-Room Gates)
Model & Scale Tier (N = 600 Tasks/Run)Standard Harness+ Grounded Harness (v0.2.0 / v0.3)Key Latency, Persona & Telemetry OutcomesArchive SHA-256
`Google Gemini 4 Argon` (`FRONTIER_REASONING`, Low, `v0.3`, `$24.54` / `$30.54`)`91.17%` (`547/600`, uploaded `dolphinbench.ai` submission `UUID c047b063`, `status: "queued"` awaiting leaderboard acceptance; exceeds current `70.67%` published leaderboard entry in independent `600/600` evaluation)`90.67%` (`544/600`, self-run clean-room evaluation; highest `Riley` slice `181/200 = 90.50%`, published SHA-256 audit logs)`+1.50 pp` (`+9` tasks: `+28W / -19L`) over `Grounded v0.2` (statistically tied w/ Std., exact McNemar $p = 0.766$ NS) · `Morgan 94.5%` (`189`), `Alex 87.0%` (`174`), `Riley 90.5%` (`181`, first-ever `90%+` on `Riley`) · 192/600 (32.0%) zero-turn live-state delta hydrations, 80/600 deep 4–8 memory-search tasks, 7,994 passive duplicates suppressed · `+21` unique wins vs. `Std.` (`Argon Low Oracle@2 = 94.67%` [`568/600`], `Argon Low Oracle@3 = 95.83%` [`575/600`], `Argon Oracle@4 = 96.83%` [`581/600`])665fb7ad5a042eeb943f15a875b3be1a06f7d1aa26e21842a69fb597d1939ba7
[`krush420/gemma4-31b-sre-lora`](https://huggingface.co/krush420/gemma4-31b-sre-lora) (`Wave-6 QLoRA+DPO`, `MID_MODEL`, Thinking ON, `$0.00`)54.83% (329/600 *Wave-5*) / 54.17% (325/600 *Stock*, uploaded & queued UUID 288671ad)`57.33%` (`344/600`, highest open-weights score in self-run 28-run evaluation)`+3.17 pp` (`+19` tasks) over `54.17%` Stock (+0.67 pp / +4 tasks over 56.67% Stock + Grounded) · Morgan 74.5% (149), Alex 51.5% (103), Riley 46.0% (92) · 50.81s median · Beats all 8 non-Luna cloud stacks up to $1,830.57 (Grounded Oracle@2 = 65.33% [392/600], `Gemma 4 Oracle@6 = 71.83%` [`431/600`, +1.16 pp > published 70.67% Mem0 entry])b7a26ef96ae99a93042ba2270ed5cae4094850f4cb789c782143e145a2eb069e

| `Google Gemma 4 31B Dense Stock` (`MID_MODEL`, Thinking ON, `$0.00`) | 54.17% (325/600, uploaded & queued UUID 288671ad) | `56.67%` (`340/600`, clean-room stock + Grounded) | `+2.50 pp` (`+15` net tasks) · Lifts every persona (Morgan 73.0% [146], Alex 48.5% [97], `Riley 48.5%` [`97`, `+5.50 pp`]

冒頭だけを表示しています。続きはリポジトリで読めます