Dogfooding 記録

このディレクトリは、dogfooding のセッション記録を集約するための入口です。1 回ごとの試行結果、発見事項、証跡、次アクションを残し、Issue 起票や ACC 判定へつなげます。

この記録は人間向けの報告書ではなく、AI エージェントが再読・再起票・再検証するための構造化ログとして扱います。

役割分担

• セッション記録: 1 回の dogfooding 実施内容と発見事項を残す
• ACC / 受入台帳: 最終判定と正式証跡の正本として扱う

ファイル構成

• sessions/YYYY-MM-DD-dogfooding-<scope>.yaml
• 1 セッション分の正本ログ
• session.template.yaml
• セッション記録テンプレート

命名ルール

• セッション記録: YYYY-MM-DD-dogfooding-<scope>.yaml
• 同日複数回: YYYY-MM-DD-01-dogfooding-<scope>.yaml

時刻はファイル名ではなく YAML の値に記載します。開始時刻・終了時刻は ISO 8601 形式を使用してください。

AI 向け記述原則

• 記録の正本は Markdown ではなく YAML にする
• キー名はテンプレートから変更しない
• 列挙値は既定値を使う
• 発見事項は 1 件ごとに 1 オブジェクトで記録する
• 長文の感想ではなく、再現・判定・次アクションを抽出しやすい短い文で書く
• 発見した問題は原則として GitHub Issue を起票し、related_issue に紐付ける

追加時の注意

• 記録は当時の事実として残し、後から本文を上書きしない
• 長期保存するスクリーンショットのみ docs/images/dogfooding/YYYY-MM-DD/ に格納する
• Playwright の生 artifact は YAML に要点だけ転記し、恒久文書に大量添付しない