docs: update new app checklist — add git/Vercel steps, fix categories, logo.png step

- 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 <noreply@anthropic.com>
This commit is contained in:
posimai 2026-03-22 18:28:10 +09:00
parent df0e1b66ad
commit f6488eaf43
2 changed files with 84 additions and 22 deletions

View File

@ -290,7 +290,7 @@ npm run deploy
新しいアプリを作ったら、**コード実装の完了直後に必ずこの順番で実行する**こと: 新しいアプリを作ったら、**コード実装の完了直後に必ずこの順番で実行する**こと:
0. **【実装前】アクセントカラーを宣言する** 0. **【実装前】アクセントカラーを宣言する**
- このアプリのカテゴリを確認(インプット/作成・編集/ツール/共有/インフラ - このアプリのカテゴリを確認(`input` インプット / `routine` 日次ルーティン / `create` 作成・記録 / `tools` ツール / `business` ビジネス / `infra` インフラ / `ideas` アイデア
- デフォルト Teal で問題なければ何もしない - デフォルト Teal で問題なければ何もしない
- Sky Blue 等に変える場合は AGENTS.md の「アプリ別アクセントカラー」テーブルに**先に追記**してから実装を開始する - Sky Blue 等に変える場合は AGENTS.md の「アプリ別アクセントカラー」テーブルに**先に追記**してから実装を開始する
@ -298,7 +298,6 @@ npm run deploy
- コード実装と並行して、ユーザーが Gemini Image に貼れるプロンプトを提示する - コード実装と並行して、ユーザーが Gemini Image に貼れるプロンプトを提示する
- 構成: 以下の共通プロンプト + アプリ固有の追加プロンプト - 構成: 以下の共通プロンプト + アプリ固有の追加プロンプト
- アプリ固有部分はアプリの**目的・体験・隠喩**を視覚化する(機能の説明ではなく感覚的な表現) - アプリ固有部分はアプリの**目的・体験・隠喩**を視覚化する(機能の説明ではなく感覚的な表現)
- ユーザーが logo.png を配置後、git add して deploy する
**共通プロンプト(全アプリ固定):** **共通プロンプト(全アプリ固定):**
``` ```
@ -328,28 +327,54 @@ npm run deploy
catching the orb's inner glow at the lifted corner. 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` 配列にエントリを追加 - `posimai-dashboard/src/data/projects.json``projects` 配列にエントリを追加
- 適切な `category` を設定(`posimai-pwa` / `active` / `flagship` / `micro` / `infra` など) - 適切な `category` を設定(`posimai-pwa` / `active` / `flagship` / `micro` / `infra` など)
2. **App Browser カテゴリに追加** 4. **App Browser カテゴリに追加**
- `posimai-dashboard/src/app/apps/page.tsx``APP_CATEGORIES` 配列から適切なカテゴリを選び `projectIds` に追加 - `posimai-dashboard/src/app/apps/page.tsx``APP_CATEGORIES` 配列から適切なカテゴリを選び `projectIds` に追加
- カテゴリ: `input`(インプット)/ `routine`(日次ルーティン)/ `create`(作成・記録)/ `tools`(ツール)/ `business`(ビジネス)/ `infra`(インフラ) - カテゴリ: `input`(インプット)/ `routine`(日次ルーティン)/ `create`(作成・記録)/ `tools`(ツール)/ `business`(ビジネス)/ `infra`(インフラ)/ `ideas`(アイデア)
- ここに追加しないと App Browser に表示されないAsset Map には出るが App Browser は別管理) - ここに追加しないと App Browser に表示されない(Ecosystem Map には出るが App Browser は別管理)
3. **Ecosystem Map 追加** 5. **Ecosystem Map 追加**
- `posimai-dashboard/src/app/ecosystem/page.tsx``NODES` 配列にノードを追加 - `posimai-dashboard/src/app/ecosystem/page.tsx``NODES` 配列にノードを追加
- 関連する `EDGES`(依存関係)も追加 - 関連する `EDGES`(依存関係)も追加
4. **Development Timeline に追記** 6. **Development Timeline に追記**
- `posimai-dashboard/src/app/timeline/page.tsx``EVENTS` 配列に今日の日付でエントリを追加 - `posimai-dashboard/src/app/timeline/page.tsx``EVENTS` 配列に今日の日付でエントリを追加
- type: `launch`(新規公開)/ `feature`(機能追加)/ `fix`(修正)/ `infra`(インフラ) - type: `launch`(新規公開)/ `feature`(機能追加)/ `fix`(修正)/ `infra`(インフラ)
5. **Access Guide に追記** 7. **Access Guide に追記**
- `posimai-dashboard/src/app/access/page.tsx``APPS` 配列にエントリを追加 - `posimai-dashboard/src/app/access/page.tsx``APPS` 配列にエントリを追加
- `accessLevel` / `codevAccess` / `authDetail` / `codevNote` を正確に記入する - `accessLevel` / `codevAccess` / `authDetail` / `codevNote` を正確に記入する
6. **Dashboard をデプロイ** 8. **Dashboard をデプロイ**
```bash ```bash
cd posimai-dashboard 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 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 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を忘れると、アプリが孤立してエコシステムから見えなくなる。 > ⚠️ ダッシュボード更新カード・App Browser・Ecosystem・Timelineを忘れると、アプリが孤立してエコシステムから見えなくなる。

View File

@ -325,7 +325,7 @@ bash create-app.sh posimai-myapp "My App Name" "アプリの説明"
新しいアプリを作ったら、**コード実装の完了直後に必ずこの順番で実行する**こと: 新しいアプリを作ったら、**コード実装の完了直後に必ずこの順番で実行する**こと:
0. **【実装前】アクセントカラーを宣言する** 0. **【実装前】アクセントカラーを宣言する**
- このアプリのカテゴリを確認(インプット/作成・編集/ツール/共有/インフラ - このアプリのカテゴリを確認(`input` インプット / `routine` 日次ルーティン / `create` 作成・記録 / `tools` ツール / `business` ビジネス / `infra` インフラ / `ideas` アイデア
- デフォルト Teal で問題なければ何もしない - デフォルト Teal で問題なければ何もしない
- Sky Blue 等に変える場合は CLAUDE.md の「アプリ別アクセントカラー」テーブルに**先に追記**してから実装を開始する - Sky Blue 等に変える場合は CLAUDE.md の「アプリ別アクセントカラー」テーブルに**先に追記**してから実装を開始する
@ -333,7 +333,6 @@ bash create-app.sh posimai-myapp "My App Name" "アプリの説明"
- コード実装と並行して、ユーザーが Gemini Image に貼れるプロンプトを提示する - コード実装と並行して、ユーザーが 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. 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` 配列にエントリを追加 - `posimai-dashboard/src/data/projects.json``projects` 配列にエントリを追加
- 適切な `category` を設定(`posimai-pwa` / `active` / `flagship` / `micro` / `infra` など) - 適切な `category` を設定(`posimai-pwa` / `active` / `flagship` / `micro` / `infra` など)
2. **App Browser カテゴリに追加** 4. **App Browser カテゴリに追加**
- `posimai-dashboard/src/app/apps/page.tsx``APP_CATEGORIES` 配列から適切なカテゴリを選び `projectIds` に追加 - `posimai-dashboard/src/app/apps/page.tsx``APP_CATEGORIES` 配列から適切なカテゴリを選び `projectIds` に追加
- カテゴリ: `input`(インプット)/ `routine`(日次ルーティン)/ `create`(作成・記録)/ `tools`(ツール)/ `business`(ビジネス)/ `infra`(インフラ) - カテゴリ: `input`(インプット)/ `routine`(日次ルーティン)/ `create`(作成・記録)/ `tools`(ツール)/ `business`(ビジネス)/ `infra`(インフラ)/ `ideas`(アイデア)
- ここに追加しないと App Browser に表示されないAsset Map には出るが App Browser は別管理) - ここに追加しないと App Browser に表示されない(Ecosystem Map には出るが App Browser は別管理)
3. **Ecosystem Map 追加** 5. **Ecosystem Map 追加**
- `posimai-dashboard/src/app/ecosystem/page.tsx``NODES` 配列にノードを追加 - `posimai-dashboard/src/app/ecosystem/page.tsx``NODES` 配列にノードを追加
- 関連する `EDGES`(依存関係)も追加 - 関連する `EDGES`(依存関係)も追加
4. **Development Timeline に追記** 6. **Development Timeline に追記**
- `posimai-dashboard/src/app/timeline/page.tsx``EVENTS` 配列に今日の日付でエントリを追加 - `posimai-dashboard/src/app/timeline/page.tsx``EVENTS` 配列に今日の日付でエントリを追加
- type: `launch`(新規公開)/ `feature`(機能追加)/ `fix`(修正)/ `infra`(インフラ) - type: `launch`(新規公開)/ `feature`(機能追加)/ `fix`(修正)/ `infra`(インフラ)
5. **Access Guide に追記** 7. **Access Guide に追記**
- `posimai-dashboard/src/app/access/page.tsx``APPS` 配列にエントリを追加 - `posimai-dashboard/src/app/access/page.tsx``APPS` 配列にエントリを追加
- `accessLevel` / `codevAccess` / `authDetail` / `codevNote` を正確に記入する - `accessLevel` / `codevAccess` / `authDetail` / `codevNote` を正確に記入する
6. **Dashboard をデプロイ** 8. **Dashboard をデプロイ**
```bash ```bash
cd posimai-dashboard 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 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 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を忘れると、アプリが孤立してエコシステムから見えなくなる。 > ⚠️ ダッシュボード更新カード・App Browser・Ecosystem・Timelineを忘れると、アプリが孤立してエコシステムから見えなくなる。