docs: compress CLAUDE.md/AGENTS.md — remove redundancy, ~40% token reduction
- 散文説明をコード内コメントに統合 - セクション5を3箇条→1文に圧縮 - 重複する注意書き削除 - 両ファイルを同一内容に統一 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
3551070812
commit
1f5ae79f11
107
AGENTS.md
107
AGENTS.md
|
|
@ -1,81 +1,56 @@
|
||||||
# Posimai Project — AI 規約 (Core Rules)
|
# Posimai Project — AI 規約
|
||||||
|
|
||||||
これは `posimai-project` の全 AI ツール（Claude Code, Cursor, Antigravity 等）が**必ず遵守すべき絶対の掟**です。
|
全 AI ツール（Claude Code, Cursor 等）が遵守すること。詳細は `docs/` を参照。
|
||||||
詳細な仕様や手順は `docs/` ディレクトリ内の外部ドキュメントを参照してください。
|
|
||||||
|
|
||||||
## 1. 絶対の禁止事項・コーディング規約（違反時は即修正）
|
## 1. 禁止事項（違反時は即修正）
|
||||||
|
|
||||||
| 禁止事項 | 理由 |
|
| 禁止 | 理由 |
|
||||||
|---------|------|
|
|------|------|
|
||||||
| **絵文字の使用**（コード・ファイル・コミット）| デザインルール違反 |
|
| 絵文字（コード・ファイル・コミット）| デザインルール違反 |
|
||||||
| **`lucide@latest` の使用** | バージョン固定済み（`@0.344.0`） |
|
| `lucide@latest` | `@0.344.0` 固定 |
|
||||||
| **CDN のバージョン未固定**（`@latest` 等） | SW キャッシュ破壊・予期せぬ破壊的変更のリスク |
|
| CDN バージョン未固定（`@latest` 等）| SW キャッシュ破壊リスク |
|
||||||
| **`vercel --prod` の直接実行** | GitHub push で Vercel 自動デプロイが走るため二重になる |
|
| `vercel --prod` 直接実行 | GitHub push で自動デプロイが二重になる |
|
||||||
| **`git push origin` の使用** | `gitea` と `github` の2つのリモートを使うアーキテクチャのため |
|
| `git push origin` | gitea/github の2リモート構成のため |
|
||||||
| **デザインシステム外の色の直接使用** | ダーク/ライトテーマ切り替えが壊れる。`var(--accent)` を使うこと |
|
| デザイントークン外の色直接使用 | テーマ切替が壊れる。`var(--accent)` を使うこと |
|
||||||
| manifest.json / sw.js のないアプリ | 全アプリ PWA 必須 |
|
| manifest.json / sw.js のないアプリ | 全アプリ PWA 必須 |
|
||||||
| クロスオリジン GET リクエストの SW キャッシュ | API データが古くなる・消失バグの原因 |
|
| クロスオリジン GET の SW キャッシュ | API データ消失バグの原因 |
|
||||||
| 外部リンクに `rel="noopener"` なし | Tabnabbing 攻撃の温床。`target="_blank"` には必ず付ける |
|
| `target="_blank"` に `rel="noopener"` なし | Tabnabbing 対策必須 |
|
||||||
| AI 訓練データのみによるバージョン回答 | 情報が古い可能性があるため、`WebSearch` ツールで確認してから答える |
|
| AI 訓練データのみでバージョン回答 | `WebSearch` で確認してから答える |
|
||||||
| 新アプリ作成時に「Giteaリポジトリは手動で作成してください」と案内する | credential store に認証情報あり。AI が自律で curl + gh を使って作成まで完結させること |
|
| 新アプリ作成時に Gitea を手動案内 | credential store 認証あり。curl + gh で自律作成すること |
|
||||||
|
|
||||||
## 2. 必須のデプロイ・パイプライン
|
## 2. デプロイパイプライン
|
||||||
|
|
||||||
コードのデプロイは**以下の Git コマンドのみ**を実行すること。
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git add .
|
# フロントエンド（全アプリ共通）
|
||||||
git commit -m "feat/fix/chore: 変更内容"
|
git add . && git commit -m "feat/fix/chore: ..." && npm run deploy
|
||||||
npm run deploy # = git push gitea main && git push github main
|
# = git push gitea main && git push github main → Vercel 自動デプロイ
|
||||||
|
|
||||||
|
# VPS バックエンド（server.js 変更時）
|
||||||
|
bash deploy-server.sh
|
||||||
|
|
||||||
|
# Supabase Edge Function（posimai-together/supabase/functions/ 変更時）
|
||||||
|
bash deploy-edge.sh # ~/.supabase-token からトークン読込
|
||||||
|
|
||||||
|
# Ubuntu PC サービス（posimai-dev/ 変更時）
|
||||||
|
npm run deploy:dev # git push + scp + systemctl restart（git push だけでは反映されない）
|
||||||
```
|
```
|
||||||
|
|
||||||
ローカル（Gitea）とクラウド（GitHub → Vercel トリガー）の2箇所へプッシュします。
|
## 3. アプリ追加・更新時（自律で実施）
|
||||||
|
|
||||||
**VPS バックエンド（server.js）のデプロイ:**
|
- 既存アプリ修正時：`posimai-dashboard/src/app/timeline/page.tsx` を更新
|
||||||
`bash deploy-server.sh` を実行する（完全無人。手動で `scp` しない）。
|
- 新規アプリ作成時：上記に加え `projects.json`, `apps/page.tsx`, `ecosystem/page.tsx`, `roadmap.json` も更新（詳細: `docs/new-app-guide.md`）
|
||||||
|
|
||||||
**Supabase Edge Function のデプロイ:**
|
## 4. 参照ドキュメント
|
||||||
`posimai-together/supabase/functions/` 以下を変更したら、必ず以下を実行すること。
|
|
||||||
|
|
||||||
```bash
|
|
||||||
bash deploy-edge.sh # ~/.supabase-token からトークンを読み込み自律デプロイ
|
|
||||||
```
|
|
||||||
|
|
||||||
**posimai-dev（Ubuntu PC サービス）のデプロイ:**
|
|
||||||
`posimai-dev/` 以下のファイルを変更したら、必ず以下を実行すること。
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm run deploy:dev # = git push + scp転送 + systemctl restart posimai-dev
|
|
||||||
```
|
|
||||||
|
|
||||||
`git push` だけでは Ubuntu PC に反映されない（Syncthing の同期遅延があるため）。
|
|
||||||
|
|
||||||
## 3. アプリ追加・更新時の必須タスク（ダッシュボード追記）
|
|
||||||
|
|
||||||
エコシステムからの孤立を防ぐため、新規アプリ作成や既存アプリ修正の際は**必ずユーザーに言われる前に**ダッシュボードのリポジトリを更新しデプロイすること。
|
|
||||||
|
|
||||||
- 既存アプリ修正時：`posimai-dashboard/src/app/timeline/page.tsx` を必ず更新。
|
|
||||||
- 新規アプリ作成時：Timeline の他に、`projects.json`, `apps/page.tsx`, `ecosystem/page.tsx`, `roadmap.json` などをすべて更新する（詳細は `docs/new-app-guide.md` 参照）。
|
|
||||||
|
|
||||||
## 4. プロジェクト構成とドキュメント辞書
|
|
||||||
|
|
||||||
必要な情報に応じて、以下の外部ドキュメントを参照してください。
|
|
||||||
|
|
||||||
| ドキュメント | 内容 |
|
| ドキュメント | 内容 |
|
||||||
|------------|------|
|
|-------------|------|
|
||||||
| `docs/master-architecture.md` | インフラ構成図、VPS/DB 定義、全アプリ一覧と URL |
|
| `docs/master-architecture.md` | インフラ構成・全アプリ一覧・URL |
|
||||||
| `docs/design-system.md` | デザインシステム（posimai-ui）、カラートークン、特例色 |
|
| `docs/design-system.md` | カラートークン・デザインシステム |
|
||||||
| `docs/new-app-guide.md` | 新規アプリ作成の手順と各種ダッシュボード更新のチェックリスト |
|
| `docs/new-app-guide.md` | 新規アプリ作成チェックリスト |
|
||||||
| `docs/disaster-recovery.md` | PC 完全消失時の復元手順（posimai-root / claude-memory の clone 手順）|
|
| `docs/disaster-recovery.md` | PC 消失時の復元手順 |
|
||||||
| `posimai-dashboard/src/data/projects.json` | 全アプリのステータス・技術スタック |
|
| `posimai-dashboard/src/data/projects.json` | 全アプリのステータス・スタック |
|
||||||
| `memory/MEMORY.md` | AI 固有の記憶（`claude-memory` リポジトリへも push して同期すること） |
|
| `memory/MEMORY.md` | AI 記憶（変更後は claude-memory リポジトリへも push すること）|
|
||||||
|
|
||||||
## 5. AI が自律で守るメタルール
|
## 5. メタルール
|
||||||
|
|
||||||
**新しい行動ルールが決まったら、その場で CLAUDE.md と AGENTS.md に書くこと。**
|
新しい行動ルールが決まったら即座に **CLAUDE.md と AGENTS.md の両方**に追記してコミットすること。memory は Claude Code 専用補助記憶であり他 AI には読まれない。CLAUDE.md を変更したら必ず AGENTS.md も同内容に更新すること。
|
||||||
|
|
||||||
- memory（`~/.claude/.../memory/`）に feedback/reference 型のルールを書く際、それが「AI がやること・やらないこと」を定めるなら、**同時に** CLAUDE.md と AGENTS.md にも追記してコミットすること。
|
|
||||||
- memory は Claude Code セッション間の補助記憶であり、他 AI ツール（Cursor 等）には読まれない。CLAUDE.md/AGENTS.md が唯一の全 AI 共有ルールソースである。
|
|
||||||
- ユーザーから「ルール化して」と言われなくても自発的に書くこと。
|
|
||||||
|
|
||||||
> **注意**: `CLAUDE.md` を変更した場合は必ず `AGENTS.md` の更新も確認すること。
|
|
||||||
|
|
|
||||||
107
CLAUDE.md
107
CLAUDE.md
|
|
@ -1,81 +1,56 @@
|
||||||
# Posimai Project — AI 規約 (Core Rules)
|
# Posimai Project — AI 規約
|
||||||
|
|
||||||
これは `posimai-project` の全 AI ツール（Claude Code, Cursor, Antigravity 等）が**必ず遵守すべき絶対の掟**です。
|
全 AI ツール（Claude Code, Cursor 等）が遵守すること。詳細は `docs/` を参照。
|
||||||
詳細な仕様や手順は `docs/` ディレクトリ内の外部ドキュメントを参照してください。
|
|
||||||
|
|
||||||
## 1. 絶対の禁止事項・コーディング規約（違反時は即修正）
|
## 1. 禁止事項（違反時は即修正）
|
||||||
|
|
||||||
| 禁止事項 | 理由 |
|
| 禁止 | 理由 |
|
||||||
|---------|------|
|
|------|------|
|
||||||
| **絵文字の使用**（コード・ファイル・コミット）| デザインルール違反 |
|
| 絵文字（コード・ファイル・コミット）| デザインルール違反 |
|
||||||
| **`lucide@latest` の使用** | バージョン固定済み（`@0.344.0`） |
|
| `lucide@latest` | `@0.344.0` 固定 |
|
||||||
| **CDN のバージョン未固定**（`@latest` 等） | SW キャッシュ破壊・予期せぬ破壊的変更のリスク |
|
| CDN バージョン未固定（`@latest` 等）| SW キャッシュ破壊リスク |
|
||||||
| **`vercel --prod` の直接実行** | GitHub push で Vercel 自動デプロイが走るため二重になる |
|
| `vercel --prod` 直接実行 | GitHub push で自動デプロイが二重になる |
|
||||||
| **`git push origin` の使用** | `gitea` と `github` の2つのリモートを使うアーキテクチャのため |
|
| `git push origin` | gitea/github の2リモート構成のため |
|
||||||
| **デザインシステム外の色の直接使用** | ダーク/ライトテーマ切り替えが壊れる。`var(--accent)` を使うこと |
|
| デザイントークン外の色直接使用 | テーマ切替が壊れる。`var(--accent)` を使うこと |
|
||||||
| manifest.json / sw.js のないアプリ | 全アプリ PWA 必須 |
|
| manifest.json / sw.js のないアプリ | 全アプリ PWA 必須 |
|
||||||
| クロスオリジン GET リクエストの SW キャッシュ | API データが古くなる・消失バグの原因 |
|
| クロスオリジン GET の SW キャッシュ | API データ消失バグの原因 |
|
||||||
| 外部リンクに `rel="noopener"` なし | Tabnabbing 攻撃の温床。`target="_blank"` には必ず付ける |
|
| `target="_blank"` に `rel="noopener"` なし | Tabnabbing 対策必須 |
|
||||||
| AI 訓練データのみによるバージョン回答 | 情報が古い可能性があるため、`WebSearch` ツールで確認してから答える |
|
| AI 訓練データのみでバージョン回答 | `WebSearch` で確認してから答える |
|
||||||
| 新アプリ作成時に「Giteaリポジトリは手動で作成してください」と案内する | credential store に認証情報あり。AI が自律で curl + gh を使って作成まで完結させること |
|
| 新アプリ作成時に Gitea を手動案内 | credential store 認証あり。curl + gh で自律作成すること |
|
||||||
|
|
||||||
## 2. 必須のデプロイ・パイプライン
|
## 2. デプロイパイプライン
|
||||||
|
|
||||||
コードのデプロイは**以下の Git コマンドのみ**を実行すること。
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git add .
|
# フロントエンド（全アプリ共通）
|
||||||
git commit -m "feat/fix/chore: 変更内容"
|
git add . && git commit -m "feat/fix/chore: ..." && npm run deploy
|
||||||
npm run deploy # = git push gitea main && git push github main
|
# = git push gitea main && git push github main → Vercel 自動デプロイ
|
||||||
|
|
||||||
|
# VPS バックエンド（server.js 変更時）
|
||||||
|
bash deploy-server.sh
|
||||||
|
|
||||||
|
# Supabase Edge Function（posimai-together/supabase/functions/ 変更時）
|
||||||
|
bash deploy-edge.sh # ~/.supabase-token からトークン読込
|
||||||
|
|
||||||
|
# Ubuntu PC サービス（posimai-dev/ 変更時）
|
||||||
|
npm run deploy:dev # git push + scp + systemctl restart（git push だけでは反映されない）
|
||||||
```
|
```
|
||||||
|
|
||||||
ローカル（Gitea）とクラウド（GitHub → Vercel トリガー）の2箇所へプッシュします。
|
## 3. アプリ追加・更新時（自律で実施）
|
||||||
|
|
||||||
**VPS バックエンド（server.js）のデプロイ:**
|
- 既存アプリ修正時：`posimai-dashboard/src/app/timeline/page.tsx` を更新
|
||||||
`bash deploy-server.sh` を実行する（完全無人。手動で `scp` しない）。
|
- 新規アプリ作成時：上記に加え `projects.json`, `apps/page.tsx`, `ecosystem/page.tsx`, `roadmap.json` も更新（詳細: `docs/new-app-guide.md`）
|
||||||
|
|
||||||
**Supabase Edge Function のデプロイ:**
|
## 4. 参照ドキュメント
|
||||||
`posimai-together/supabase/functions/` 以下を変更したら、必ず以下を実行すること。
|
|
||||||
|
|
||||||
```bash
|
|
||||||
bash deploy-edge.sh # ~/.supabase-token からトークンを読み込み自律デプロイ
|
|
||||||
```
|
|
||||||
|
|
||||||
**posimai-dev（Ubuntu PC サービス）のデプロイ:**
|
|
||||||
`posimai-dev/` 以下のファイルを変更したら、必ず以下を実行すること。
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm run deploy:dev # = git push + scp転送 + systemctl restart posimai-dev
|
|
||||||
```
|
|
||||||
|
|
||||||
`git push` だけでは Ubuntu PC に反映されない（Syncthing の同期遅延があるため）。
|
|
||||||
|
|
||||||
## 3. アプリ追加・更新時の必須タスク（ダッシュボード追記）
|
|
||||||
|
|
||||||
エコシステムからの孤立を防ぐため、新規アプリ作成や既存アプリ修正の際は**必ずユーザーに言われる前に**ダッシュボードのリポジトリを更新しデプロイすること。
|
|
||||||
|
|
||||||
- 既存アプリ修正時：`posimai-dashboard/src/app/timeline/page.tsx` を必ず更新。
|
|
||||||
- 新規アプリ作成時：Timeline の他に、`projects.json`, `apps/page.tsx`, `ecosystem/page.tsx`, `roadmap.json` などをすべて更新する（詳細は `docs/new-app-guide.md` 参照）。
|
|
||||||
|
|
||||||
## 4. プロジェクト構成とドキュメント辞書
|
|
||||||
|
|
||||||
必要な情報に応じて、以下の外部ドキュメントを参照してください。
|
|
||||||
|
|
||||||
| ドキュメント | 内容 |
|
| ドキュメント | 内容 |
|
||||||
|------------|------|
|
|-------------|------|
|
||||||
| `docs/master-architecture.md` | インフラ構成図、VPS/DB 定義、全アプリ一覧と URL |
|
| `docs/master-architecture.md` | インフラ構成・全アプリ一覧・URL |
|
||||||
| `docs/design-system.md` | デザインシステム（posimai-ui）、カラートークン、特例色 |
|
| `docs/design-system.md` | カラートークン・デザインシステム |
|
||||||
| `docs/new-app-guide.md` | 新規アプリ作成の手順と各種ダッシュボード更新のチェックリスト |
|
| `docs/new-app-guide.md` | 新規アプリ作成チェックリスト |
|
||||||
| `docs/disaster-recovery.md` | PC 完全消失時の復元手順（posimai-root / claude-memory の clone 手順）|
|
| `docs/disaster-recovery.md` | PC 消失時の復元手順 |
|
||||||
| `posimai-dashboard/src/data/projects.json` | 全アプリのステータス・技術スタック |
|
| `posimai-dashboard/src/data/projects.json` | 全アプリのステータス・スタック |
|
||||||
| `memory/MEMORY.md` | AI 固有の記憶（`claude-memory` リポジトリへも push して同期すること） |
|
| `memory/MEMORY.md` | AI 記憶（変更後は claude-memory リポジトリへも push すること）|
|
||||||
|
|
||||||
## 5. AI が自律で守るメタルール
|
## 5. メタルール
|
||||||
|
|
||||||
**新しい行動ルールが決まったら、その場で CLAUDE.md と AGENTS.md に書くこと。**
|
新しい行動ルールが決まったら即座に **CLAUDE.md と AGENTS.md の両方**に追記してコミットすること。memory は Claude Code 専用補助記憶であり他 AI には読まれない。CLAUDE.md を変更したら必ず AGENTS.md も同内容に更新すること。
|
||||||
|
|
||||||
- memory（`~/.claude/.../memory/`）に feedback/reference 型のルールを書く際、それが「AI がやること・やらないこと」を定めるなら、**同時に** CLAUDE.md と AGENTS.md にも追記してコミットすること。
|
|
||||||
- memory は Claude Code セッション間の補助記憶であり、他 AI ツール（Cursor 等）には読まれない。CLAUDE.md/AGENTS.md が唯一の全 AI 共有ルールソースである。
|
|
||||||
- ユーザーから「ルール化して」と言われなくても自発的に書くこと。
|
|
||||||
|
|
||||||
> **注意**: `CLAUDE.md` を変更した場合は必ず `AGENTS.md` の更新も確認すること。
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue