posimai-root/CLAUDE.md

2.9 KiB
Raw Blame History

Posimai Project — AI 規約

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

1. 禁止事項(違反時は即修正)

禁止 理由
絵文字(コード・ファイル・コミット) デザインルール違反
lucide@latest @0.344.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. デプロイパイプライン

# フロントエンド(全アプリ共通)
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

# Supabase Edge Functionposimai-together/supabase/functions/ 変更時)
bash deploy-edge.sh  # ~/.supabase-token からトークン読込

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

3. アプリ追加・更新時(自律で実施)

  • 既存アプリ修正時:posimai-dashboard/src/app/timeline/page.tsx を更新
  • 新規アプリ作成時:上記に加え projects.json, apps/page.tsx, ecosystem/page.tsx, roadmap.json も更新(詳細: docs/new-app-guide.md

4. 参照ドキュメント

ドキュメント 内容
docs/master-architecture.md インフラ構成・全アプリ一覧・URL
docs/design-system.md カラートークン・デザインシステム
docs/new-app-guide.md 新規アプリ作成チェックリスト
docs/disaster-recovery.md PC 消失時の復元手順
posimai-dashboard/src/data/projects.json 全アプリのステータス・スタック
memory/MEMORY.md AI 記憶(変更後は claude-memory リポジトリへも push すること)

5. メタルール

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