IDE で組んだ作業をチャット型エージェントに渡す — 2アプリ分離後の文脈受け渡しをファイルで固定する

// scripts/check-handoff.mjs
import { readFileSync } from "node:fs";
import { execSync } from "node:child_process";
 
const raw = readFileSync(".antigravity/handoff.md", "utf8");
const fm = raw.match(/^---\n([\s\S]*?)\n---/);
if (!fm) {
  console.error("❌ handoff.md に frontmatter がありません");
  process.exit(1);
}
 
// 最小限の YAML 読み取り（依存を増やさないため自前）
const meta = {};
let key = null;
for (const line of fm[1].split("\n")) {
  const kv = line.match(/^(\w+):\s*(.*)$/);
  const item = line.match(/^\s*-\s*(.*)$/);
  if (kv) { key = kv[1]; meta[key] = kv[2] ? kv[2].replace(/^"|"$/g, "") : []; }
  else if (item && Array.isArray(meta[key])) meta[key].push(item[1].replace(/^"|"$/g, ""));
}
 
const problems = [];
 
// (1) 鮮度: ブリーフの updated_at が、touched ファイルの最終変更より古くないか
const touched = Array.isArray(meta.touched) ? meta.touched : [];
const briefTime = new Date(meta.updated_at).getTime();
for (const f of touched) {
  try {
    const mtime = execSync(`git log -1 --format=%cI -- "${f}"`).toString().trim();
    if (mtime && new Date(mtime).getTime() > briefTime) {
      problems.push(`鮮度ずれ: ${f} はブリーフ更新後に変更されています`);
    }
  } catch { /* 未コミットは別途 status で見る */ }
}
 
// (2) 整合: done なのに open_checks が残っていないか
const checks = Array.isArray(meta.open_checks) ? meta.open_checks : [];
if (meta.status === "done" && checks.length > 0) {
  problems.push(`未消化の検証が ${checks.length} 件あるのに status が done です`);
}
 
// (3) 受け渡し先の明示
if (meta.status === "ready_for_verify" && !meta.handoff_to) {
  problems.push("検証待ちなのに handoff_to が空です");
}
 
if (problems.length) {
  console.error("🛑 引き継ぎブリーフに問題があります:");
  for (const p of problems) console.error("  - " + p);
  process.exit(1);
}
console.log("✅ 引き継ぎブリーフは現在の作業と整合しています");

# .antigravity/guides/handoff.md
name: handoff-brief
description: 作業を別のアプリ・別のエージェントに渡す前に必ず実行する引き継ぎ手順
 
steps:
  - 変更したファイルを frontmatter の touched に反映する
  - status を in_progress / ready_for_verify / done から選び直す
  - まだ通していない検証を open_checks に列挙する（憶測で済ませない）
  - updated_by と updated_at を現在の実行主体・時刻に更新する
  - `node scripts/check-handoff.mjs` を実行し、✅ を確認してから受け渡す