57 lines
2.9 KiB
Markdown
57 lines
2.9 KiB
Markdown
# 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. デプロイパイプライン
|
||
|
||
```bash
|
||
# フロントエンド（全アプリ共通）
|
||
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 Function（posimai-together/supabase/functions/ 変更時）
|
||
bash deploy-edge.sh # ~/.supabase-token からトークン読込
|
||
|
||
# Ubuntu PC サービス（posimai-dev/ 変更時）
|
||
npm run deploy:dev # git push + scp + systemctl restart（git 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 も同内容に更新すること。
|