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` ツールで確認してから答える
新アプリ作成時に「Giteaリポジトリは手動で作成してください」と案内する	credential store に認証情報あり。AI が自律で curl + gh を使って作成まで完結させること

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

Supabase Edge Function のデプロイ: posimai-together/supabase/functions/ 以下を変更したら、必ず以下を実行すること。

bash deploy-edge.sh  # ~/.supabase-token からトークンを読み込み自律デプロイ

posimai-dev（Ubuntu PC サービス）のデプロイ: posimai-dev/ 以下のファイルを変更したら、必ず以下を実行すること。

npm run deploy:dev  # = git push + scp転送 + systemctl restart posimai-dev

git push だけでは Ubuntu PC に反映されない（Syncthing の同期遅延があるため）。

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

既存アプリ修正時：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 して同期すること）

新しい行動ルールが決まったら、その場で 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 の更新も確認すること。