posimai-root/CLAUDE.md

# Posimai Project — AI 規約 (Core Rules)

これは `posimai-project` の全 AI ツール（Claude Code, Cursor, Antigravity 等）が**必ず遵守すべき絶対の掟**です。
詳細な仕様や手順は `docs/` ディレクトリ内の外部ドキュメントを参照してください。

## 1. 絶対の禁止事項・コーディング規約（違反時は即修正）

| 禁止事項 | 理由 |
|---------|------|
| **絵文字の使用**（コード・ファイル・コミット）| デザインルール違反 |
| **`lucide@latest` の使用** | バージョン固定済み（`@0.344.0`） |
| **CDN のバージョン未固定**（`@latest` 等） | SW キャッシュ破壊・予期せぬ破壊的変更のリスク |
| **`vercel --prod` の直接実行** | GitHub push で Vercel 自動デプロイが走るため二重になる |
| **`git push origin` の使用** | `gitea` と `github` の2つのリモートを使うアーキテクチャのため |
| **デザインシステム外の色の直接使用** | ダーク/ライトテーマ切り替えが壊れる。`var(--accent)` を使うこと |
| manifest.json / sw.js のないアプリ | 全アプリ PWA 必須 |
| クロスオリジン GET リクエストの SW キャッシュ | API データが古くなる・消失バグの原因 |
| 外部リンクに `rel="noopener"` なし | Tabnabbing 攻撃の温床。`target="_blank"` には必ず付ける |
| AI 訓練データのみによるバージョン回答 | 情報が古い可能性があるため、`WebSearch` ツールで確認してから答える |

## 2. 必須のデプロイ・パイプライン

コードのデプロイは**以下の Git コマンドのみ**を実行すること。

```bash
git add .
git commit -m "feat/fix/chore: 変更内容"
npm run deploy  # = git push gitea main && git push github main
```

ローカル（Gitea）とクラウド（GitHub → Vercel トリガー）の2箇所へプッシュします。

**VPS バックエンド（server.js）のデプロイ:**
`bash deploy-server.sh` を実行する（完全無人。手動で `scp` しない）。

## 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/design-system.md` | デザインシステム（posimai-ui）、カラートークン、特例色 |
| `docs/new-app-guide.md` | 新規アプリ作成の手順と各種ダッシュボード更新のチェックリスト |
| `docs/disaster-recovery.md` | PC 完全消失時の復元手順（posimai-root / claude-memory の clone 手順）|
| `posimai-dashboard/src/data/projects.json` | 全アプリのステータス・技術スタック |
| `memory/MEMORY.md` | AI 固有の記憶（`claude-memory` リポジトリへも push して同期すること） |

> **注意**: `CLAUDE.md` を変更した場合は必ず `AGENTS.md` の更新も確認すること。