From edfe579adb573d9e03b3d4c31f2b27639327e82e Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 4 Sep 2026 13:24:25 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20CLAUDE.md=20=E3=82=92=E9=9A=8E=E5=B1=A4?= =?UTF-8?q?=E5=8C=96=E3=81=97=E3=81=9F=E5=85=B1=E9=80=9A=E3=83=AB=E3=83=BC?= =?UTF-8?q?=E3=83=AB=E3=81=AB=E5=90=88=E3=82=8F=E3=81=9B=E3=81=A6=E6=95=B4?= =?UTF-8?q?=E7=90=86=E3=81=97=E3=80=81GEMINI.md=20=E3=81=A8=20.agents/rule?= =?UTF-8?q?s=EF=BC=88Antigravity=20=E7=94=A8=E5=8F=82=E7=85=A7=EF=BC=89?= =?UTF-8?q?=E3=82=92=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/rules/claude-md.md | 7 ++++++ CLAUDE.md | 47 +++++++------------------------------- GEMINI.md | 24 +++++++++++++++++++ 3 files changed, 39 insertions(+), 39 deletions(-) create mode 100644 .agents/rules/claude-md.md create mode 100644 GEMINI.md diff --git a/.agents/rules/claude-md.md b/.agents/rules/claude-md.md new file mode 100644 index 0000000..130ecd1 --- /dev/null +++ b/.agents/rules/claude-md.md @@ -0,0 +1,7 @@ +--- +trigger: always_on +description: Read the CLAUDE.md hierarchy via GEMINI.md before doing anything in this workspace +--- + +最初に、このディレクトリの `GEMINI.md` を読み、そこに列挙された CLAUDE.md を上から順にすべて読んで従うこと。 +Read `GEMINI.md` in this directory first, then read and follow every CLAUDE.md it lists, in order. diff --git a/CLAUDE.md b/CLAUDE.md index 6302d3a..626319a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,50 +1,19 @@ -# phpMyAdmin Helm Chart - CLAUDE.md +# CLAUDE.md — phpMyAdmin Helm Chart + +> **共通ルール（要約）** — 詳細は `P:\Claude\CLAUDE.md`（全体共通）と `P:\Claude\HelmChart\CLAUDE.md`（Helm チャート共通: リリースフロー・ワークフロー・Gitea Secrets）を参照。 +> 作業前に pull ／ 機能変更時は README 更新 ／ 作業単位ごとに commit → push まで ／ コミットに AI クレジットを付けない ／ pull で入った変更を revert しない ／ Helm・PHP はローカル実行不可（Python のみ可）。 ## リポジトリ概要 nginx をリバースプロキシとして使用する phpMyAdmin を Kubernetes 上にデプロイするHelmチャートです。 Raspberry Pi などのベアメタル上で動作する Kubernetes クラスタを想定した構成になっています。 +- **Gitea リポジトリ**: `ssh://git@192.168.9.65/helmchart/phpmyadmin.git` +- **主アプリ**: phpMyAdmin（チャートのバージョン = phpMyAdmin のバージョン） +- **サブアプリ**: nginx（nginx のみの更新ではリリースしない） + ## 実行環境について **PHP実行環境はこのチャートには含まれません。** phpMyAdmin は公式イメージ (`phpmyadmin/phpmyadmin`) の `-fpm-alpine` タグを使用しており、 PHP-FPM はその公式イメージ内に含まれています。別途 PHP 実行環境を用意する必要はありません。 - -## Git 情報 - -- **ユーザー名**: Claude -- **メールアドレス**: claude@cafepieters.com -- **リポジトリ**: ssh://git@192.168.9.65/helmchart/phpmyadmin.git - -## リリースフローのルール - -### バージョン番号の方針 -- Helmチャートのバージョン番号（`Chart.yaml` の `version` / `appVersion`）は、**主アプリ（phpMyAdmin）のバージョン番号と同一**とする。 - -### 自動リリース条件 -- **phpMyAdmin バージョン更新時**: `values.yaml` と `Chart.yaml` を更新し、Gitタグ・Giteaリリース・Gitea Package Registry への発行まで行う。 -- **nginx のみの更新時**: `values.yaml` の該当タグのみ更新してコミットするが、**リリースは行わない**。 - -### 手動リリース（臨時） -- 改修作業などで手動リリースが必要な場合は、バージョン末尾にアルファベットを付与する。 - - 例: `5.2.3` → `5.2.3-a`, `5.2.3-b` - -## ワークフロー構成 - -### `.gitea/workflows/image-update-and-release.yaml` -毎週月曜日 3:00 AM（JST 12:00 PM）に自動実行され、以下を行う: -1. Docker Hub から nginx・phpMyAdmin の最新バージョンを取得 -2. 更新がある場合は `values.yaml` を更新 -3. phpMyAdmin のバージョンが更新された場合のみ、Helm チャートのリリースを実施 - -### `.gitea/workflows/helm-release.yaml` -`main` ブランチへのプッシュ時に自動実行。Gitea Package Registry にチャートを発行する。 - -## 必要な Gitea Secrets - -| シークレット名 | 用途 | -|---|---| -| `GITEA_TOKEN` | Gitea API（リリース作成・タグ操作） | -| `REGISTRY_USER` | Gitea Package Registry ユーザー名 | -| `REGISTRY_TOKEN` | Gitea Package Registry トークン | diff --git a/GEMINI.md b/GEMINI.md new file mode 100644 index 0000000..4fa7ad0 --- /dev/null +++ b/GEMINI.md @@ -0,0 +1,24 @@ +# GEMINI.md — Antigravity (Gemini) 用エントリポイント（HelmChart\phpmyadmin） + +このディレクトリのルールはすべて **`CLAUDE.md`** に記載されている。本ファイルにはルール本文を書かず、読むべき CLAUDE.md への参照だけを置く（正本は常に CLAUDE.md）。 + +## 必ず最初に実行すること + +以下のファイルを**上から順に**読み込み、すべての指示に従うこと。上位ほど広い範囲に適用される共通ルールで、下位は上位を前提とした補足・例外である。 + +1. `P:\Claude\CLAUDE.md` — 全組織共通ルール（Git 運用・コミット書式・実行環境・情報記載の原則） +2. `P:\Claude\HelmChart\CLAUDE.md` — HelmChart 組織共通ルール +3. `P:\Claude\HelmChart\phpmyadmin\CLAUDE.md` — phpmyadmin リポジトリ固有ルール（このディレクトリ） + +> Antigravity はワークスペース（または git ルート）直下のルールしか自動で読まず、親フォルダを遡らない。そのため上位階層のパスをここに明示している。`P:\Claude` はクラウド同期されており、デスクトップ・ノート PC とも同じパスで存在する。 + +## 読み替え + +- CLAUDE.md 中の「Claude」「Claude Code」は、Antigravity で作業する場合は Gemini 自身のことと読み替える。 +- Git のコミット者は Antigravity でも `user.name = Claude` / `user.email = claude@cafepieters.com` のまま使う（変更しない）。コミットメッセージに AI クレジットを付けない。 +- Claude Code 固有の機能（`.claude/` 設定、スキル、メモリ等）に関する記述は無視してよい。 + +## 保守ルール + +- ルールの追加・変更は **CLAUDE.md にのみ**行う。本ファイルと `.agents/rules/claude-md.md` は参照だけを保持し、内容を増やさない。 +- CLAUDE.md を新しいディレクトリに追加したときは、同じ形式の `GEMINI.md` と `.agents/rules/claude-md.md` も併置する。