Claude Codeのセッション内容を記録しておくと、設計理由と作業過程を後から探せる(qiita.com)

- 開発者@qwertyhogeは、Claude Codeの作業が終わるときに/decision-logコマンドで呼び出す自作の作業指示ファイル(skill)を紹介している。技術選択、採用しなかった代替案とその理由、AI提案を修正した箇所、PR前のセルフレビューの有無、コードライセンスと機密情報の確認の有無を選び、月別の記録ファイルに追加する。 - 重要な選択があるときは、ADR(Architecture Decision Record、設計決定の背景と代替案を残す文書)も併せて作成する。元記事によると、約1か月の間に作業記録を5件、ADRを10件残したという。 - 筆者は、AIが自分の作業を好意的に解釈して書く傾向があるため、「行っていないことは書くな」という指示を入れたと説明している。Opus 5.5モデルで数回試したところ、なかったことを書いた例は見られなかったと記しているが、これは筆者個人の観察である。 - 記録を見ると、筆者はPR前のセルフレビューをほとんど行っていなかったことが分かった。そこでレビューを強制する別のskillとフックを作り、レビューを経なければPRを作成できないようにしたという。