Riffraftコードレビューは、設計図を引く行為だ。

線を引く。消す。重ねる。確定する。——判断の軌跡が、チームの設計資産になる。

function authorize(user) {
  const role = user.role;
  return PERMISSIONS[role];
}

48時間後、設計意図は蒸発している。

非同期のコメント欄に書いた判断理由を、翌週のあなたは覚えていない。

月曜に出したPRに最初のコメントがつくのは水曜の午後。返信を書く頃には実装時の判断理由が曖昧になっている。 コンテキスト復元に費やす30分が、1日に何度も繰り返される。 そして3往復のやり取りを経てApproveされた設計判断は、PRがマージされた瞬間にコメント欄の底に沈む。

判断を重ねるたび、線は太くなる。

レビューコメントがコードの上に積層し、チームの設計図面が形成されていく。

 1async function processOrder(cart) { 2  const validated = validateItems(cart); 3  const total = calculateTotal(validated); 4  const payment = await charge(total); 5  await sendConfirmation(payment); 6  return { status: "completed" }; 7}

Riffraftでは、コードレビューはリアルタイムの共同作業になる。 レビュアーがコメントを書く瞬間、著者の画面にも赤い線が引かれる。 質問が飛び、回答が重なり、合意が太い実線に変わる—— その全過程が、コードの上に「設計判断の地層」として積み重なっていく。

引出線が、変更の理由を解剖する。

Before の行から After の行へ、赤い弧線が意図を接続する。

従来のdiffは「何が変わったか」を示すが、「なぜ変えたか」は表示しない。 Riffraftの注釈線は、変更前の行と変更後の行を弧線で結び、 その上に設計判断の理由を記録する。 6ヶ月後に同じコードを触る開発者は、引出線を辿るだけで設計の文脈を復元できる。

既存の設計図面に、一本線を足すだけ。

GitHub / GitLab / Bitbucket——今の製図台はそのまま使える。

Riffraftは既存のGitワークフローを置き換えない。 導入にインフラ変更は不要、チーム全員がブラウザだけで5分以内に使い始められる。