correction-pipeline

訂正パイプライン

規約： conventions/brain-first.md を参照してください。 — 根本原因をたどるチェーンのステップ 1 は、何よりも先に行うブレインファーストの検索チェーンです（正確なトークンには search、概念に関する質問には query を使います）。

規約： _brain-filing-rules.md を参照してください。 — 訂正ではページをその場で編集します。ページは引き続き主要な対象に基づいて分類されます。

トリガー

ユーザーが指摘した事実誤認はすべて対象です。例外はありません。「記録しておきます」も不可です。

（ここへの振り分けはハーネスの規約であり、機械的に保証されるものではありません。ただし、このスキルが適用されたら、上記の例外なしのルールを徹底してください。）

即時の応答

1. 誤りを認めます。 弁明しないでください。説明もしないでください。ただ、「そのとおりです。私の誤りでした」と伝えます。
2. 具体的な誤った主張を引用します。 何が誤りだったのかを正確に理解していると、ユーザーにわかるようにします。
3. ユーザーが示した正しい事実を伝えます。

根本原因の分析（記憶のメモだけで済ませず、以下を実行してください）

以下の手順を必ず順番どおりに実行します。調査結果をユーザーに報告してください。

ステップ 1：ブレインを検索する

gbrain search "<relevant terms>" --limit 10

概念に関する主張や同義表現で述べられた主張の場合は、gbrain query "<question>" に切り替えます（LLM による拡張で、search が見落とす表現を検出できます）。主張が含まれるインデックス済みページをすべて一覧表示するには、キーワード検索を使います（該当するすべての結果がページ分けされます）。チェックアウト内の grep は、まだ同期されていない編集だけを対象にします。

gbrain search '"<wrong claim terms>"' --match keyword
BRAIN_DIR=$(gbrain config get sync.repo_path)
grep -ri "<wrong claim terms>" "$BRAIN_DIR/people/" "$BRAIN_DIR/companies/" "$BRAIN_DIR/concepts/" 2>/dev/null

質問： 誤った事実はブレインにありますか？ ある場合 → ブレインが混入源です。ブレイン内のページを修正します（ステップ 6）。

ステップ 2：メモリファイルを検索する

ハーネスが常時読み込むメモリファイルを grep します（例：ワークスペースの MEMORY.md と、関連する memory/*.md ファイル。正確な場所はハーネスによって異なります）。

grep -ri "<wrong claim terms>" <memory files> 2>/dev/null

質問： 誤った事実はメモリにありますか？ ある場合 → メモリが混入源です。メモリファイルを修正します。

ステップ 3：SOUL.md と USER.md を確認する

grep -i "<relevant terms>" <workspace>/SOUL.md <workspace>/USER.md 2>/dev/null

質問： 誤った推論につながりかねない、誤解を招く記述はありますか？ SOUL.md と USER.md はすべてのコンテキストウィンドウに含まれます。ここにある曖昧な記述は、すべてのセッションに波及します。

重要： gbrain のインストール環境では、これらのファイルはブートストラップ回答バンク（state/interview.json）からレンダリングされます。調査結果をここに記録し、修正はステップ 6 で回答バンクを通じて行ってください。直接編集はしないでください。

ステップ 4：事実テーブルを確認する

gbrain recall <entity-slug>            # facts about the subject, newest first
gbrain recall --grep "<claim terms>"   # substring filter when the entity is unclear

確信度の高い誤った事実はありますか？ 該当する場合は、その事実 ID を記録します。

ステップ 5：誤りを分類する

分類	説明	修正箇所
BRAIN_ERROR	ブレイン内のページに誤った事実がある	ブレインリポジトリ内のページを編集し、コミットして再同期する
MEMORY_ERROR	メモリファイルに誤った事実がある	メモリファイルを修正する
SOUL_USER_ERROR	SOUL.md または USER.md に誤解を招く記述がある	回答バンクを修正して再レンダリングする。レンダリング済みファイルは絶対に編集しない
FACTS_TABLE_ERROR	gbrain の事実テーブルに誤った事実がある	recall → forget <fact-id> → 訂正内容を remember する
HALLUCINATION	情報源がなく、LLM が断片的なシグナルから事実を捏造した	混入の要因（どの断片的なシグナルが原因になったか）を明示し、ガード用の事実を記述する
STALE_DATA	以前は正しかったが、現在は正しくない事実	現在の真実に合わせて情報源を更新し、古くなった事実を置き換える
CROSS_CONTAMINATION	人物 A に関する正しい事実が、人物 B のものとして誤って伝えられた	情報源で、両方の人物の帰属を修正する

Step 6: ソースを修正する

• BRAIN_ERROR： brain リポジトリ内のページファイルを編集します。修正した行に [Source: user correction, YYYY-MM-DD] を含めます。コミットしてから gbrain sync を実行し、DB に修正を反映します。（リポジトリ内のファイルを修正せずに DB の行だけを編集した場合、またはその逆の場合、次回の同期でどちらかが上書きされるまで両者の内容が一致しません。）
• MEMORY_ERROR： memory ファイルを編集します。日付入りの修正メモを追加します。
• SOUL_USER_ERROR： SOUL.md / USER.md を直接編集してはいけません。これらはレンダリングされたファイルであり、手動で編集しても次のレンダリング時に何も通知されずに失われます。共有の初期設定回答バンクで元の回答を修正し、その後、再レンダリングします。

  gbrain bootstrap interview --set KEY "corrected value"   # verbatim, user's words
  gbrain bootstrap interview --show                        # read back
  gbrain bootstrap interview --status                      # get the confirm hash
  gbrain bootstrap interview --confirm <hash>
  gbrain bootstrap render --only SOUL.md --force           # repeat per affected file
  

  面接時の手順全体（読み返しの手順、回答の逐語記録、バックアップ時の動作）は skills/soul-audit/SKILL.md に記載されています。単一キーの修正を超える場合は、そちらを通してください。
• FACTS_TABLE_ERROR： 誤った行を期限切れにし、出典情報とともに修正内容を書き込みます。

  gbrain recall <entity-slug>                                  # find the fact id
  gbrain forget <fact-id>                                      # expire the wrong fact
  gbrain remember "<correct fact>" \
    --provenance "user correction, YYYY-MM-DD" --entity <entity-slug>
  

• HALLUCINATION： 修正するソースはありません。作話のきっかけとなった不完全な手がかりを特定し、同じ誤りが再び生じないようガードを追加します。

  gbrain remember "WRONG: <what was said>. RIGHT: <what is true>. Guard: <instruction to prevent recurrence>" \
    --provenance "user correction, YYYY-MM-DD (hallucination guard)" --entity <entity-slug>
  

• STALE_DATA： ソースページを最新の事実に更新し（BRAIN_ERROR の手順に従います）、古くなった事実の行があれば置き換えます（forget を実行し、最新の事実と新しい出典情報を添えて remember します）。
• CROSS_CONTAMINATION： ソースで帰属を修正し、両方のエンティティを確認します。人物 A のページと facts（事実が正しい場所に記載されているか）と、人物 B のページと facts（誤った帰属の痕跡がすべてなくなっているか）を確認します。

Step 7: 伝播を確認する

誤った事実が、ほかの brain ページ、統合出力、または memory ファイルに伝播している可能性があります。

gbrain search '"<wrong claim terms>"' --match keyword
grep -ri "<wrong claim terms>" "$BRAIN_DIR" 2>/dev/null | grep -v ".git"   # edits not yet synced

最初に見つかったものだけでなく、すべての箇所を修正します。リポジトリ内のファイルを編集した後、再同期します。

Step 8: ユーザーに報告する

簡潔に報告します。

**Error:** [what was wrong]
**Root cause:** [BRAIN_ERROR | HALLUCINATION | etc.]
**Source:** [specific file/line or fact id, or "no source — confabulated from X"]
**Fixed:** [what was changed, where]
**Propagation:** [other files fixed, or "no propagation found"]

重大度の段階

段階	説明	対応
S1 — アイデンティティに関する誤り	ユーザーの家族、ルーツ、経歴、核となるアイデンティティに関する誤った事実	直ちに修正します。あらゆる情報に影響します。すべての統合、すべての書籍ミラー、すべての会話が汚染されます。
S2 — エンティティに関する誤り	brain 内の人物、会社、取引に関する誤った事実	brain ページを修正し、伝播を確認します
S3 — コンテキストに関する誤り	ユーザーの現在の状態、感情、状況に関する誤った推論	remember で事実にガードを追加します。通常はハルシネーションです。
S4 — 軽微な事実誤認	日付、数値、詳細の誤り	ソースを修正します。伝播の確認は不要です

注意すべき繰り返し発生するエラーパターン

パターン	例	ガード
治療的なストーリーを投影する	「共同創業者との難しい話し合いを避けてきましたね」（根拠なし）	ユーザーの行動や状態について主張する前に、カレンダーや行動データを確認します
名前を有名人の名前に自動修正する	alice-example Cho という連絡先が、名前の似た有名人に気づかないうちに置き換わる	世界的に有名な人よりもユーザーの知人を優先し、まず people/ と照合します
意見と事実を混同する	takes テーブルの意見を facts に書き込む	Takes = 他人の意見。Facts = ユーザー個人の知識。
セッションのコンテキストだけに基づく列挙的な主張	「2社で働いたことがあります」——brain にしか記録されていない1社が抜けている	brain を検索せずに、列挙的な主張（「X のすべて」「Y の全員」「Z をした3回」）を絶対にしてはいけません。セッションのコンテキストは常に不完全です。
常時読み込まれるファイルのデータ欠落	重要な事実が brain ページにしかなく、USER.md / MEMORY.md にはないため、セッションのたびに誤って推論し直す	修正によって常時読み込まれるファイルの欠落が判明した場合は、適切な手段で不足データを追加します（レンダリングされるファイルは回答バンク、memory ファイルは直接編集）。今後のすべてのコンテキストウィンドウに含まれるようにします

補足：矛盾検出プローブ

このスキルはリアクティブです。ユーザーが誤りを指摘したときに作動します。同梱の矛盾検出プローブは、同じ取り組みのプロアクティブな側面で、ユーザーが気づく前に脳内の矛盾を検出します。

gbrain eval suspected-contradictions   # run the probe
gbrain find-contradictions             # read the latest run's findings

訂正によってある種の矛盾（たとえば、2つのページで日付が食い違っていること）が判明した場合は、その後にプローブを実行してください。同じ汚染パターンが脳内のほかの場所にも存在する可能性があります。

契約

このスキルは、以下を保証します。

• すべての事実誤認について、記録するだけでなく根本原因を特定します
• 情報源は、誤りの種類に応じた本当の修正箇所で修正します（ページの編集＋コミット＋再同期、事実行の場合はforget／remember、SOUL／USERの場合は回答バンク＋再レンダリング。レンダリング済みファイルを直接編集することはありません）
• 伝播を確認します（脳全体のgrep＋gbrain search）
• 何が誤りだったのか、なぜ誤りだったのか、何を修正したのかを明確にユーザーへ報告します
• ルーティングはfrontmatterの正規トリガーに一致します
• プライバシー契約を維持します。実名、フォーク固有のファイルシステムパスのリテラル、上流フォークへの言及は含めません

出力形式

このスキルの出力は、会話中に提示するステップ8の根本原因レポートと、適用したすべての情報源の修正（脳リポジトリの編集をコミットして再同期、事実行の期限切れ／置き換え、回答バンクからのIDファイルの再レンダリング）です。

重複排除（明確な境界）

• skills/maintain/SKILL.md — プロアクティブな脳の健全性管理（古いページ、孤立ページ、引用、doctor）。このスキルはリアクティブで、特定のユーザー訂正を汚染元までたどります。「それは違います」と誰も指摘していない場合は、maintainの担当範囲です。
• 矛盾検出プローブ（gbrain eval suspected-contradictions／gbrain find-contradictions）— プロアクティブな脳内矛盾の検出です。両者は補完関係にあり、重複しません。プローブは2つの脳内情報源の間の矛盾を検出し、このスキルはユーザーからの訂正を起点とします。
• skills/soul-audit/SKILL.md — ID全体の再インタビューを行う窓口です。このスキルはSOUL_USER_ERRORの修正をそこへ委任し、インタビューやレンダリングの手順を再実装することはありません。
• skills/citation-fixer/SKILL.md — 引用形式への準拠を扱います。主張の真偽を訂正するのはこのスキルであり、正しい主張の引用方法を修正するのはcitation-fixerです。
• frontmatter-guard（ホスト側）— ページの構造（YAMLの形式）を検証します。主張の真偽は対象外です。

失敗した場合

gbrainのエラーcode、終了コード、[AGENT]ブロック、通知ブロックについては、エージェントオペレータープロトコルに従ってください。このスキルに固有の対応は以下のとおりです。

• forget <fact-id>／rememberがfact_not_foundまたはfact_already_expiredを返した場合は、recallを再実行して現在の事実IDを取得してください。推測したIDで忘却処理をしてはいけません。
• ページの修正でrevision_conflictが返された場合は、ページを読み直し、現在のテキストに修正を適用して、新しいリビジョンで保存してください。
• write_pending（終了コード10）の場合、訂正は受理されていますが、まだコミットされていません。修正済みだとユーザーに伝える前に、gbrain write-request <request_id>をポーリングしてください。

アンチパターン

• 「承知しました。覚えておきます。」 いいえ。情報源をたどってください。情報源を修正してください。
• 脳を確認せず、メモリだけを修正する。 脳が永続ストアです。メモリはフラッシュされます。
• SOUL.md／USER.mdを直接編集する。 これらは回答バンクからレンダリングされるため、手動編集は次のレンダリングで失われ、誤りが再発します。回答を修正して、再レンダリングしてください。
• 再同期せずに脳リポジトリのファイルを編集する（またはコミットせずにDB行を編集する）。 2つのストアの内容が食い違い、次の同期で誤りが復活します。
• 伝播を確認せずに、1つの箇所だけを修正する。 誤った事実は広がります。
• 部分的な手がかりを特定せず、幻覚のせいにする。 幻覚には必ず種があります。それを見つけてください。
• 防御的な対応をする。 誤りを認める前に、なぜ間違えたのかを説明してはいけません。