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 コマンドのみを実行すること。

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 の更新も確認すること。