principle-prove-it-works

動作を証明する

すべてのタスクの出力を、実物を直接確認して検証してください。代理指標、自己申告、「コンパイルできた」だけから推測しないでください。

理由： 検証されていない作業の正しさは不明です。間接的な検証（ファイルの更新日時、出力の鮮度、エージェントの自己申告、キャッシュされたスクリーンショット）は、直接確認するより手軽に感じられます。しかし、誤った推測に基づいて行動すると、元の情報を確認するよりはるかに大きなコストがかかります。

代理指標ではなく、実物を確認してください。

• 派生状態を間接的に見るのではなく、プロセスが生きているかを直接確認する
• キャッシュされた表現や派生した表現ではなく、実際の値を読み取る
• 検証に失敗したときは、システムを疑う前に、観察方法を疑う

可能ならチェックをスクリプト化する

最も確かな証明は、一度目視で確認することではなく、同じ比較を再実行する決定的なスクリプトです。スクリプトを書いて実行し、その出力を成果物として残してください。レビュー担当者があなたの言葉を信じるのではなく、再実行して確認できるようにします。

人が確認できるよう、成果物は見える状態にしておいてください。後から経緯を監査できるようにする必要がある、大規模な移植や移行などの大規模または複雑な作業に限り、成果物をコミットしてください（作業成果を示すスキル）。