dev-journal

name	dev-journal
description	実装中の設計上の気づき・疑問・バックログ送りにしたタスクを spec/dev-journal.md に記録するスキル。USE WHEN: ユーザが「ジャーナルに書いて」「メモしておいて」「dev-journal に追記して」「これ記録して」「あとで見返せるようにして」「バックログに入れて」「後回しにしたい」など、実装中の気づきや先送りタスクの記録を依頼したとき。spec/dev-journal.md を読み書きするときは必ず参照すること。

開発ジャーナルスキル

実装中に発生する設計上の気づき・疑問・バックログ送りタスクを spec/dev-journal.md に時系列で蓄積するスキル。

ファイル配置

• 記録先は spec/dev-journal.md の 1 ファイルに集約する。
• ファイルが存在しない場合は初期テンプレートで作成する。
• テーマが膨らんで独立した設計判断が必要になった場合、該当エントリを仕様書へ昇格させる。

エントリ形式

## YYYY-MM-DD: {タイトル}

### 現状

{現在の実装・設計がどうなっているか}

### 観察

{何が問題か、何を改善できるか}

### 方針

{対応策・回避策、または先送りの判断理由}

• エントリ見出しは H2 (##) + 日付 (ISO 8601) + タイトル。
• 本文ラベルは H3 で 現状 / 観察 / 方針 の 3 セクションを立てる。
• 新しいエントリは既存エントリの末尾に追記する。
• 同一テーマで進展があった場合は、新しいエントリとして追記し、本文冒頭に前回日付を記載する。

ponkan-python で記録するもの

• cc3dsfs 原典読解で未確定の仮説。
• 実機 new 3DS XL capture board の観測結果。
• USB driver 状態、product string、VID/PID、転送 length などの bring-up 情報。
• 仕様化するには小さいが、後続実装で拾うべき設計判断。

書かないこと

• 実装手順や TODO リスト。
• 議論の経緯。
• 装飾や絵文字。

初期テンプレート

# Dev Journal

実装中の設計上の気づき・疑問・バックログ送りタスクの記録。