AIとの作業ログを管理する仕組みを作った

背景

Claude Code で作業することが増えてきて、「何をやったか」をどこに残すかが問題になってきました。AIとのセッションは流れるように進むので、あとから振り返ると何を決めたのかわからなくなります。

そこで、作業ログを Git で管理する logs リポジトリを整備しました。

ディレクトリ構成

logs/
├── raw/2026/          # 生ログ。低摩擦・私的。セッション単位で残す
└── journals/2026/     # 整理済み。Note.com などへの発信用

raw/ は摩擦なく書けることを優先しています。ファイル名は YYYYMMDD_snake_case_title.md で統一。内容は箇条書きでも走り書きでもOK。

journals/ は raw/ を元に整理したもの。外に出せる形に直したものだけ置きます。

Makefile で操作を簡単に

毎回ファイル名を考えるのが面倒なので、Makefile にまとめました。

note:   ## 今日の日付でrawログを開く
new:    ## タイトルを指定して新規作成
save:   ## add → commit → push を一発で
install: ## Claude skillをグローバルに配置

make note で今日のファイルが開き、make save でそのまま GitHub に上がります。

Claude Code の /journal スキル

Claude Code には独自スキルを定義できるので、/journal コマンドを作りました。~/.claude/commands/journal.md に置いておくと、Claude がセッション中に自動的にそのルールに従ってログを書いてくれます。

~/.claude/commands/journal.md
↓ make install で展開

スキル自体は logs/journals/ 配下で管理していて、make install でグローバルなパスに配置する仕組みです。

GitHub private repo に接続

logs リポジトリは private にして GitHub に置いています。手元のメモがそのままバージョン管理される形。

git remote add origin git@github.com:yhamamon/logs.git
git push -u origin main

使ってみて

セッションが終わったら make save するだけ、という習慣がつくと割と快適です。AIとの会話の文脈がファイルとして残るので、次のセッションで「前回のログを渡す」だけで続きから始められます。

iPhoneから音声でログを入れる仕組み（Siriショートカット + GitHub API）は次の課題です。