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:
parent
df0e1b66ad
commit
f6488eaf43
53
AGENTS.md
53
AGENTS.md
|
|
@ -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)を忘れると、アプリが孤立してエコシステムから見えなくなる。
|
||||||
|
|
||||||
|
|
|
||||||
53
CLAUDE.md
53
CLAUDE.md
|
|
@ -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)を忘れると、アプリが孤立してエコシステムから見えなくなる。
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue