5.2 KiB

Raw Blame History

Posimai Project — AI 規約

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

1. 禁止事項（違反時は即修正）

禁止	理由
絵文字（コード・ファイル・コミット）	デザインルール違反
`lucide@latest`	バージョン固定必須。React 18 以前は `0.344.0`、React 19 プロジェクトは `0.471.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 で自律作成すること
UI に左ボーダーライン（`border-left`）でレベル区別	AI っぽく見える。badge + カード枠色（`border-color`）で表現すること

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

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

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

既存アプリ修正時：posimai-dashboard/src/app/timeline/page.tsx を更新
新規アプリ作成時：上記に加え以下を必ず全部更新（詳細: docs/new-app-guide.md）
1. posimai-dashboard/src/data/projects.json
2. posimai-dashboard/src/app/apps/page.tsx（APP_CATEGORIES の該当カテゴリの projectIds に追加）
3. posimai-dashboard/src/app/ecosystem/page.tsx（NODES + EDGES）
4. posimai-dashboard/src/app/timeline/page.tsx（EVENTS 先頭に追加）
5. posimai-roadmap/roadmap.json
6. posimai-atlas/atlas.json（posimai-apps の count と description を更新、必要ならエッジ追加）
カスタムドメイン設定（必須）: vercel domains add <subdomain>.posimai.soar-enrich.com の後、必ず vercel alias set <deployment-url> <subdomain>.posimai.soar-enrich.com を実行すること。domains add だけでは URL が割り当たらない（2026-04-18 実証済み）。サブドメイン = APP_ID から posimai- を除いた部分。
完了後に必ず確認: node scripts/check-registrations.js <app-id> を実行し [OK] になるまで修正する

4. AI 実行権限（確認不要 / 要確認の境界線）

確認なしで自動実行してよい

npm run deploy / npm run deploy:dev / bash deploy-server.sh
VPS への読み取り系 SSH（ログ確認・ステータス確認）
git add / commit / push
ファイルの作成・編集

必ず mai に確認してから実行する

DB スキーマ変更（ALTER TABLE / DROP TABLE）
本番データの削除・更新を伴う SQL
VPS の Docker コンテナ停止・削除
Stripe の本番モード切り替え

5. 参照ドキュメント

ドキュメント	内容
`STATUS.md`	今何をしている最中か（毎セッション参照・更新）
`DESIGN.md`	UI 生成時はここの値のみ使うこと。色・クラス名・アイコン・spacing の正
`docs/master-architecture.md`	インフラ構成・全アプリ一覧・URL
`docs/design-system.md`	カラートークン詳細（DESIGN.md の補足）
`docs/new-app-guide.md`	新規アプリ作成チェックリスト
`docs/disaster-recovery.md`	PC 消失時の復元手順
`docs/server-refactor-plan.md`	server.js 分割設計・実施タイミング・手順
`posimai-dashboard/src/data/projects.json`	全アプリのステータス・スタック
`memory/MEMORY.md`	AI 記憶（変更後は claude-memory リポジトリへも push すること）

6. コードの「正」はどこか

何	正	役割
コード	GitHub	Vercel がここを参照。確認はここ
フロント本番	Vercel	GitHub push で自動デプロイ
バックエンド本番	VPS	`bash deploy-server.sh` で更新
Gitea	バックアップのみ	push するだけ・確認先にしない

7. メタルール

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

5.2 KiB Raw Blame History Unescape Escape