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` ツールで確認してから答える

コードのデプロイは以下の 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 しない）。

エコシステムからの孤立を防ぐため、新規アプリ作成や既存アプリ修正の際は必ずユーザーに言われる前にダッシュボードのリポジトリを更新しデプロイすること。

既存アプリ修正時：posimai-dashboard/src/app/timeline/page.tsx を必ず更新。
新規アプリ作成時：Timeline の他に、projects.json, apps/page.tsx, ecosystem/page.tsx, roadmap.json などをすべて更新する（詳細は docs/new-app-guide.md 参照）。

必要な情報に応じて、以下の外部ドキュメントを参照してください。

ドキュメント	内容
`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 して同期すること）

注意: AGENTS.md は CLAUDE.md と並行稼働しています。基本の読み込みコンテキストとして使用され、詳細ルールは必要に応じて docs/* を読み込んでください。