From c7e2e493bb6f1ac617d28962b00de47dd4af1f5a Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 4 Sep 2026 13:24:00 +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 | 49 +++++++------------------------------- GEMINI.md | 24 +++++++++++++++++++ 3 files changed, 39 insertions(+), 41 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 728e4d9..6ea7737 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,4 +1,7 @@ -# n8n Helm Chart - CLAUDE.md +# CLAUDE.md — n8n Helm Chart + +> **共通ルール（要約）** — 詳細は `P:\Claude\CLAUDE.md`（全体共通）と `P:\Claude\HelmChart\CLAUDE.md`（Helm チャート共通: リリースフロー・ワークフロー・Gitea Secrets）を参照。 +> 作業前に pull ／ 機能変更時は README 更新 ／ 作業単位ごとに commit → push まで ／ コミットに AI クレジットを付けない ／ pull で入った変更を revert しない ／ Helm はローカル実行不可（Python のみ可）。 ## リポジトリ概要 @@ -6,17 +9,14 @@ n8n ワークフロー自動化ツールを Kubernetes 上にデプロイするH Raspberry Pi などのベアメタル上で動作する Kubernetes クラスタを想定した構成になっています。 `n8nio/n8n` 公式マルチアーキテクチャイメージ（linux/arm64 対応）を使用します。 +- **Gitea リポジトリ**: `ssh://git@192.168.9.65/helmchart/n8n.git` +- **主アプリ**: n8n（チャートのバージョン = n8n のバージョン。サブアプリは無いため、n8n 更新時は常にリリース） + ## ARM 対応について `n8nio/n8n` は linux/arm64 に対応したマルチアーキテクチャイメージです。 Raspberry Pi 4 以降（arm64）で動作します。 -## Git 情報 - -- **ユーザー名**: Claude -- **メールアドレス**: claude@cafepieters.com -- **リポジトリ**: ssh://git@192.168.9.65/helmchart/n8n.git - ## チャート構成 | リソース | 説明 | @@ -41,42 +41,9 @@ n8n のデータは `/home/node/.n8n` に保存されます。 - デフォルト: SQLite（`/home/node/.n8n/database.sqlite`） - 本番推奨: PostgreSQL（`n8n.database.type: postgresdb`） -## 更新時のルール +## README 更新時の反映先 -**チャートに何らかの変更を加えた場合、必ず `README.md` を最新状態に更新してからコミットすること。** -更新内容に応じて以下を反映する: - イメージバージョン・設定値の変更 → values の表を更新 - テンプレート追加・削除 → チャート構成表を更新 - 設定項目の追加・変更 → 設定リファレンス表を更新 - 注意事項・制限事項の変更 → 該当セクションを更新 - -## リリースフローのルール - -### バージョン番号の方針 -- Helmチャートのバージョン番号（`Chart.yaml` の `version` / `appVersion`）は、**n8n のバージョン番号と同一**とする。 - -### 自動リリース条件 -- **n8n バージョン更新時**: `values.yaml` と `Chart.yaml` を更新し、Gitタグ・Giteaリリース・Gitea Package Registry への発行まで行う。 - -### 手動リリース（臨時） -- 改修作業などで手動リリースが必要な場合は、バージョン末尾にアルファベットを付与する。 - - 例: `2.19.2` → `2.19.2-a`, `2.19.2-b` - -## ワークフロー構成 - -### `.gitea/workflows/image-update-and-release.yaml` -毎週月曜日 3:00 AM（JST 12:00 PM）に自動実行され、以下を行う: -1. Docker Hub から n8n の最新バージョンを取得 -2. 更新がある場合は `values.yaml` と `Chart.yaml` を更新 -3. Gitタグ・Giteaリリース・Gitea Package Registry への発行を実施 - -### `.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..c4b82af --- /dev/null +++ b/GEMINI.md @@ -0,0 +1,24 @@ +# GEMINI.md — Antigravity (Gemini) 用エントリポイント（HelmChart\n8n） + +このディレクトリのルールはすべて **`CLAUDE.md`** に記載されている。本ファイルにはルール本文を書かず、読むべき CLAUDE.md への参照だけを置く（正本は常に CLAUDE.md）。 + +## 必ず最初に実行すること + +以下のファイルを**上から順に**読み込み、すべての指示に従うこと。上位ほど広い範囲に適用される共通ルールで、下位は上位を前提とした補足・例外である。 + +1. `P:\Claude\CLAUDE.md` — 全組織共通ルール（Git 運用・コミット書式・実行環境・情報記載の原則） +2. `P:\Claude\HelmChart\CLAUDE.md` — HelmChart 組織共通ルール +3. `P:\Claude\HelmChart\n8n\CLAUDE.md` — n8n リポジトリ固有ルール（このディレクトリ） + +> 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` も併置する。