4 files changed, 56 insertions, 0 deletions
diff --git a/caddy/README.md b/caddy/README.md
new file mode 100644
index 0000000..2faf232
--- /dev/null
+++ b/caddy/README.md
@@ -0,0 +1,11 @@
+# caddy
+
+Caddy によるリバースプロキシ設定。`git push` で自動デプロイされる。
+
+| ファイル | 内容 |
+|---|---|
+| `Caddyfile` | ホスト別ルーティング定義 |
+| `docker-compose.yml` | Caddy コンテナ定義 |
+| `deploy.sh` | post-receive フックから呼ばれるデプロイスクリプト |
+
+新しいホストを追加する場合は `Caddyfile` を編集して push する。
diff --git a/claude/README.md b/claude/README.md
new file mode 100644
index 0000000..3f3e101
--- /dev/null
+++ b/claude/README.md
@@ -0,0 +1,19 @@
+# claude
+
+yyamashita ユーザーの Claude Code セッション（systemd user service）を管理する。
+
+| ファイル | 内容 |
+|---|---|
+| `sessions.txt` | `user:repo` 形式でセッションを定義 |
+| `systemd/claude-code@.service` | サービステンプレート |
+| `sync.sh` | root が実行し、sessions.txt に基づいて user service を同期 |
+
+```bash
+# 変更を反映する
+git push origin master
+ssh root@localhost 'bash /app/infra/claude/sync.sh'
+
+# 状態確認
+systemctl --user status 'claude-code@*.service'
+tmux ls
+```
diff --git a/git/README.md b/git/README.md
new file mode 100644
index 0000000..6bb2d30
--- /dev/null
+++ b/git/README.md
@@ -0,0 +1,16 @@
+# git
+
+サーバー上のベアリポジトリとフックを管理する。変更は `install.sh` を手動実行して反映する。
+
+| ファイル | 内容 |
+|---|---|
+| `repos.txt` | `name:work-tree` 形式でリポジトリを定義 |
+| `hooks/<repo>/post-receive` | 各リポジトリの post-receive フック |
+| `install.sh` | ベアリポジトリ作成・フック展開・SSH 鍵適用 |
+| `server-setup.sh` | 初回のみ: Docker インストールと hetzner-infra ブートストラップ |
+
+```bash
+# 変更を反映する
+git push origin master
+ssh root@localhost 'bash /app/infra/git/install.sh'
+```
diff --git a/server/README.md b/server/README.md
new file mode 100644
index 0000000..bd009e7
--- /dev/null
+++ b/server/README.md
@@ -0,0 +1,10 @@
+# server
+
+サーバー共通の設定ファイル。`git/install.sh` 実行時に適用される。
+
+| ファイル | 内容 |
+|---|---|
+| `authorized_keys` | root の SSH 公開鍵一覧 |
+| `requirements.md` | 必要なツール・パッケージ一覧 |
+
+SSH 鍵を追加・削除する場合は `authorized_keys` を編集して push し、`install.sh` を実行する。