From f6488eaf4387131219b7db43e5606288f4fbf445 Mon Sep 17 00:00:00 2001 From: posimai Date: Sun, 22 Mar 2026 18:28:10 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20update=20new=20app=20checklist=20?= =?UTF-8?q?=E2=80=94=20add=20git/Vercel=20steps,=20fix=20categories,=20log?= =?UTF-8?q?o.png=20step?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add numbered steps 1 (git init/Gitea/GitHub push) and 2 (Vercel connect) - Fix Step 0 categories to match actual APP_CATEGORIES ids/labels (add routine, business, ideas; fix create label) - Add Step 10: logo.png deploy after user provides the file - Renumber downstream steps accordingly (1→3, 2→4, etc.) - Same changes applied to AGENTS.md Co-Authored-By: Claude Sonnet 4.6 --- AGENTS.md | 53 ++++++++++++++++++++++++++++++++++++++++++----------- CLAUDE.md | 53 ++++++++++++++++++++++++++++++++++++++++++----------- 2 files changed, 84 insertions(+), 22 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 660775d3..727d3182 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -290,7 +290,7 @@ npm run deploy 新しいアプリを作ったら、**コード実装の完了直後に必ずこの順番で実行する**こと: 0. **【実装前】アクセントカラーを宣言する** - - このアプリのカテゴリを確認(インプット/作成・編集/ツール/共有/インフラ) + - このアプリのカテゴリを確認(`input` インプット / `routine` 日次ルーティン / `create` 作成・記録 / `tools` ツール / `business` ビジネス / `infra` インフラ / `ideas` アイデア) - デフォルト Teal で問題なければ何もしない - Sky Blue 等に変える場合は AGENTS.md の「アプリ別アクセントカラー」テーブルに**先に追記**してから実装を開始する @@ -298,7 +298,6 @@ npm run deploy - コード実装と並行して、ユーザーが Gemini Image に貼れるプロンプトを提示する - 構成: 以下の共通プロンプト + アプリ固有の追加プロンプト - アプリ固有部分はアプリの**目的・体験・隠喩**を視覚化する(機能の説明ではなく感覚的な表現) - - ユーザーが logo.png を配置後、git add して deploy する **共通プロンプト(全アプリ固定):** ``` @@ -328,28 +327,54 @@ npm run deploy catching the orb's inner glow at the lifted corner. ``` -1. **Dashboard カード追加** +1. **Git 初期化・リポジトリ作成・初回 push** + ```bash + cd posimai-[app-name] + git init && git add . && git commit -m "feat: initial commit" + + # Gitea リポジトリ作成(AI が必ず実行。手動案内は禁止) + GITEA_PASS=$(git credential fill <<< $'protocol=http\nhost=100.76.7.3:3000' | grep password | cut -d= -f2) + curl -s -X POST "http://100.76.7.3:3000/api/v1/user/repos" \ + -H "Content-Type: application/json" \ + -u "mai:$GITEA_PASS" \ + -d "{\"name\":\"posimai-[app-name]\",\"private\":false,\"auto_init\":false}" + git remote add gitea http://100.76.7.3:3000/mai/posimai-[app-name].git + + # GitHub リポジトリ作成(AI が必ず実行) + gh repo create posimai/posimai-[app-name] --private --source=. --remote=github + npm run deploy # = git push gitea main && git push github main + ``` + +2. **Vercel に接続して初回デプロイをトリガーする** + ```bash + echo "https://github.com/posimai/posimai-[app-name].git" | vercel git connect --yes + git commit --allow-empty -m "ci: trigger initial Vercel deployment" + npm run deploy + ``` + これを省略すると Vercel にプロジェクトが登録されず自動デプロイが走らない。 + +3. **Dashboard カード追加** - `posimai-dashboard/src/data/projects.json` の `projects` 配列にエントリを追加 - 適切な `category` を設定(`posimai-pwa` / `active` / `flagship` / `micro` / `infra` など) -2. **App Browser カテゴリに追加** +4. **App Browser カテゴリに追加** - `posimai-dashboard/src/app/apps/page.tsx` の `APP_CATEGORIES` 配列から適切なカテゴリを選び `projectIds` に追加 - - カテゴリ: `input`(インプット)/ `routine`(日次ルーティン)/ `create`(作成・記録)/ `tools`(ツール)/ `business`(ビジネス)/ `infra`(インフラ) - - ここに追加しないと App Browser に表示されない(Asset Map には出るが App Browser は別管理) + - カテゴリ: `input`(インプット)/ `routine`(日次ルーティン)/ `create`(作成・記録)/ `tools`(ツール)/ `business`(ビジネス)/ `infra`(インフラ)/ `ideas`(アイデア) + - ここに追加しないと App Browser に表示されない(Ecosystem Map には出るが App Browser は別管理) -3. **Ecosystem Map 追加** +5. **Ecosystem Map 追加** - `posimai-dashboard/src/app/ecosystem/page.tsx` の `NODES` 配列にノードを追加 - 関連する `EDGES`(依存関係)も追加 -4. **Development Timeline に追記** +6. **Development Timeline に追記** - `posimai-dashboard/src/app/timeline/page.tsx` の `EVENTS` 配列に今日の日付でエントリを追加 - type: `launch`(新規公開)/ `feature`(機能追加)/ `fix`(修正)/ `infra`(インフラ) -5. **Access Guide に追記** +7. **Access Guide に追記** - `posimai-dashboard/src/app/access/page.tsx` の `APPS` 配列にエントリを追加 - `accessLevel` / `codevAccess` / `authDetail` / `codevNote` を正確に記入する -6. **Dashboard をデプロイ** +8. **Dashboard をデプロイ** ```bash cd posimai-dashboard git add src/data/projects.json src/app/apps/page.tsx src/app/ecosystem/page.tsx src/app/timeline/page.tsx src/app/access/page.tsx @@ -357,7 +382,13 @@ npm run deploy npm run deploy ``` -7. **プロジェクト構成テーブルを AGENTS.md に追記**(このファイル) +9. **プロジェクト構成テーブルを AGENTS.md に追記**(このファイル) + +10. **logo.png をデプロイする**(ユーザーが logo.png を配置した後) + ```bash + cd posimai-[app-name] + git add logo.png && git commit -m "chore: add logo" && npm run deploy + ``` > ⚠️ ダッシュボード更新(カード・App Browser・Ecosystem・Timeline)を忘れると、アプリが孤立してエコシステムから見えなくなる。 diff --git a/CLAUDE.md b/CLAUDE.md index c59eb77f..64aa700e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -325,7 +325,7 @@ bash create-app.sh posimai-myapp "My App Name" "アプリの説明" 新しいアプリを作ったら、**コード実装の完了直後に必ずこの順番で実行する**こと: 0. **【実装前】アクセントカラーを宣言する** - - このアプリのカテゴリを確認(インプット/作成・編集/ツール/共有/インフラ) + - このアプリのカテゴリを確認(`input` インプット / `routine` 日次ルーティン / `create` 作成・記録 / `tools` ツール / `business` ビジネス / `infra` インフラ / `ideas` アイデア) - デフォルト Teal で問題なければ何もしない - Sky Blue 等に変える場合は CLAUDE.md の「アプリ別アクセントカラー」テーブルに**先に追記**してから実装を開始する @@ -333,7 +333,6 @@ bash create-app.sh posimai-myapp "My App Name" "アプリの説明" - コード実装と並行して、ユーザーが Gemini Image に貼れるプロンプトを提示する - 構成: 以下の共通プロンプト + アプリ固有の追加プロンプト - アプリ固有部分はアプリの**目的・体験・隠喩**を視覚化する(機能の説明ではなく感覚的な表現) - - ユーザーが logo.png を配置後、git add して deploy する **共通プロンプト(全アプリ固定):** ``` @@ -363,28 +362,54 @@ bash create-app.sh posimai-myapp "My App Name" "アプリの説明" catching the orb's inner glow at the lifted corner. ``` -1. **Dashboard カード追加** +1. **Git 初期化・リポジトリ作成・初回 push** + ```bash + cd posimai-[app-name] + git init && git add . && git commit -m "feat: initial commit" + + # Gitea リポジトリ作成(AI が必ず実行。手動案内は禁止) + GITEA_PASS=$(git credential fill <<< $'protocol=http\nhost=100.76.7.3:3000' | grep password | cut -d= -f2) + curl -s -X POST "http://100.76.7.3:3000/api/v1/user/repos" \ + -H "Content-Type: application/json" \ + -u "mai:$GITEA_PASS" \ + -d "{\"name\":\"posimai-[app-name]\",\"private\":false,\"auto_init\":false}" + git remote add gitea http://100.76.7.3:3000/mai/posimai-[app-name].git + + # GitHub リポジトリ作成(AI が必ず実行) + gh repo create posimai/posimai-[app-name] --private --source=. --remote=github + npm run deploy # = git push gitea main && git push github main + ``` + +2. **Vercel に接続して初回デプロイをトリガーする** + ```bash + echo "https://github.com/posimai/posimai-[app-name].git" | vercel git connect --yes + git commit --allow-empty -m "ci: trigger initial Vercel deployment" + npm run deploy + ``` + これを省略すると Vercel にプロジェクトが登録されず自動デプロイが走らない。 + +3. **Dashboard カード追加** - `posimai-dashboard/src/data/projects.json` の `projects` 配列にエントリを追加 - 適切な `category` を設定(`posimai-pwa` / `active` / `flagship` / `micro` / `infra` など) -2. **App Browser カテゴリに追加** +4. **App Browser カテゴリに追加** - `posimai-dashboard/src/app/apps/page.tsx` の `APP_CATEGORIES` 配列から適切なカテゴリを選び `projectIds` に追加 - - カテゴリ: `input`(インプット)/ `routine`(日次ルーティン)/ `create`(作成・記録)/ `tools`(ツール)/ `business`(ビジネス)/ `infra`(インフラ) - - ここに追加しないと App Browser に表示されない(Asset Map には出るが App Browser は別管理) + - カテゴリ: `input`(インプット)/ `routine`(日次ルーティン)/ `create`(作成・記録)/ `tools`(ツール)/ `business`(ビジネス)/ `infra`(インフラ)/ `ideas`(アイデア) + - ここに追加しないと App Browser に表示されない(Ecosystem Map には出るが App Browser は別管理) -3. **Ecosystem Map 追加** +5. **Ecosystem Map 追加** - `posimai-dashboard/src/app/ecosystem/page.tsx` の `NODES` 配列にノードを追加 - 関連する `EDGES`(依存関係)も追加 -4. **Development Timeline に追記** +6. **Development Timeline に追記** - `posimai-dashboard/src/app/timeline/page.tsx` の `EVENTS` 配列に今日の日付でエントリを追加 - type: `launch`(新規公開)/ `feature`(機能追加)/ `fix`(修正)/ `infra`(インフラ) -5. **Access Guide に追記** +7. **Access Guide に追記** - `posimai-dashboard/src/app/access/page.tsx` の `APPS` 配列にエントリを追加 - `accessLevel` / `codevAccess` / `authDetail` / `codevNote` を正確に記入する -6. **Dashboard をデプロイ** +8. **Dashboard をデプロイ** ```bash cd posimai-dashboard git add src/data/projects.json src/app/apps/page.tsx src/app/ecosystem/page.tsx src/app/timeline/page.tsx src/app/access/page.tsx @@ -392,7 +417,13 @@ bash create-app.sh posimai-myapp "My App Name" "アプリの説明" npm run deploy ``` -7. **プロジェクト構成テーブルを CLAUDE.md に追記**(このファイル) +9. **プロジェクト構成テーブルを CLAUDE.md に追記**(このファイル) + +10. **logo.png をデプロイする**(ユーザーが logo.png を配置した後) + ```bash + cd posimai-[app-name] + git add logo.png && git commit -m "chore: add logo" && npm run deploy + ``` > ⚠️ ダッシュボード更新(カード・App Browser・Ecosystem・Timeline)を忘れると、アプリが孤立してエコシステムから見えなくなる。