posimai-root/CLAUDE.md

# Posimai Project — AI 規約

全 AI ツール（Claude Code, Cursor 等）が遵守すること。詳細は `docs/` を参照。

## 1. 禁止事項（違反時は即修正）

| 禁止 | 理由 |
|------|------|
| 絵文字（コード・ファイル・コミット）| デザインルール違反 |
| `lucide@latest` | バージョン固定必須。React 18 以前は `0.344.0`、React 19 プロジェクトは `0.471.0` 固定（キャレットなし）|
| CDN バージョン未固定（`@latest` 等）| SW キャッシュ破壊リスク |
| `vercel --prod` 直接実行 | GitHub push で自動デプロイが二重になる |
| `git push origin` | gitea/github の2リモート構成のため |
| デザイントークン外の色直接使用 | テーマ切替が壊れる。`var(--accent)` を使うこと |
| manifest.json / sw.js のないアプリ | 全アプリ PWA 必須 |
| クロスオリジン GET の SW キャッシュ | API データ消失バグの原因 |
| `target="_blank"` に `rel="noopener"` なし | Tabnabbing 対策必須 |
| AI 訓練データのみでバージョン回答 | `WebSearch` で確認してから答える |
| 新アプリ作成時に Gitea を手動案内 | credential store 認証あり。curl + gh で自律作成すること |

## 2. デプロイパイプライン

```bash
# フロントエンド（全アプリ共通）
git add . && git commit -m "feat/fix/chore: ..." && npm run deploy
# = git push gitea main && git push github main → Vercel 自動デプロイ

# VPS バックエンド（server.js 変更時）
bash deploy-server.sh

# Ubuntu PC サービス（posimai-dev/ 変更時）
npm run deploy:dev  # git push + scp + systemctl restart（git push だけでは反映されない）
```

## 3. アプリ追加・更新時（自律で実施）

- 既存アプリ修正時：`posimai-dashboard/src/app/timeline/page.tsx` を更新
- 新規アプリ作成時：上記に加え以下を**必ず全部**更新（詳細: `docs/new-app-guide.md`）
  1. `posimai-dashboard/src/data/projects.json`
  2. `posimai-dashboard/src/app/apps/page.tsx`（APP_CATEGORIES の該当カテゴリの projectIds に追加）
  3. `posimai-dashboard/src/app/ecosystem/page.tsx`（NODES + EDGES）
  4. `posimai-dashboard/src/app/timeline/page.tsx`（EVENTS 先頭に追加）
  5. `posimai-roadmap/roadmap.json`
  6. `posimai-atlas/atlas.json`（posimai-apps の count と description を更新、必要ならエッジ追加）
- **カスタムドメイン設定（必須）**: `vercel domains add <subdomain>.posimai.soar-enrich.com` の後、必ず `vercel alias set <deployment-url> <subdomain>.posimai.soar-enrich.com` を実行すること。`domains add` だけでは URL が割り当たらない（2026-04-18 実証済み）。サブドメイン = APP_ID から `posimai-` を除いた部分。
- **完了後に必ず確認**: `node scripts/check-registrations.js <app-id>` を実行し [OK] になるまで修正する

## 4. AI 実行権限（確認不要 / 要確認の境界線）

### 確認なしで自動実行してよい
- `npm run deploy` / `npm run deploy:dev` / `bash deploy-server.sh`
- VPS への読み取り系 SSH（ログ確認・ステータス確認）
- git add / commit / push
- ファイルの作成・編集

### 必ず mai に確認してから実行する
- DB スキーマ変更（ALTER TABLE / DROP TABLE）
- 本番データの削除・更新を伴う SQL
- VPS の Docker コンテナ停止・削除
- Stripe の本番モード切り替え

## 5. 参照ドキュメント

| ドキュメント | 内容 |
|-------------|------|
| `STATUS.md` | **今何をしている最中か（毎セッション参照・更新）** |
| `DESIGN.md` | **UI 生成時はここの値のみ使うこと。色・クラス名・アイコン・spacing の正** |
| `docs/master-architecture.md` | インフラ構成・全アプリ一覧・URL |
| `docs/design-system.md` | カラートークン詳細（DESIGN.md の補足） |
| `docs/new-app-guide.md` | 新規アプリ作成チェックリスト |
| `docs/disaster-recovery.md` | PC 消失時の復元手順 |
| `docs/server-refactor-plan.md` | server.js 分割設計・実施タイミング・手順 |
| `posimai-dashboard/src/data/projects.json` | 全アプリのステータス・スタック |
| `memory/MEMORY.md` | AI 記憶（変更後は claude-memory リポジトリへも push すること）|

## 6. コードの「正」はどこか

| 何 | 正 | 役割 |
|----|-----|------|
| コード | **GitHub** | Vercel がここを参照。確認はここ |
| フロント本番 | **Vercel** | GitHub push で自動デプロイ |
| バックエンド本番 | **VPS** | `bash deploy-server.sh` で更新 |
| Gitea | バックアップのみ | push するだけ・確認先にしない |

## 7. メタルール

新しい行動ルールが決まったら即座に **CLAUDE.md と AGENTS.md の両方**に追記してコミットすること。memory は Claude Code 専用補助記憶であり他 AI には読まれない。CLAUDE.md を変更したら必ず AGENTS.md も同内容に更新すること。