init-project

name	init-project
description	プロジェクトを Bun + Hono（バックエンド）+ Vite + React（フロントエンド）+ Biome でスキャフォールドする初期化スキル。テンプレートを clone した直後の初回セットアップ時に、ユーザーが明示的に実行する。
allowed-tools	Read, Write, AskUserQuestion, Bash(bun install --ignore-scripts:*), Bash(nr:*)
disable-model-invocation	true

このスキルはプロジェクトの初期化を行う。以下の手順を順番に実行すること。

前提

• ランタイム: Bun
• バックエンド: Hono + TypeScript
• フロントエンド: Vite + React + TypeScript
• リンター/フォーマッター: Biome（ルートの biome.json を共有）
• テスト: bun test

重要なルール

test スクリプトは必ず終了するコマンドを使うこと。 ウォッチモードで起動するコマンドは CI やエージェントをブロックする。

NG（ウォッチモード）	OK（終了する）
vitest	vitest run
vitest watch	vitest run
jest --watch	jest --watchAll=false

ウォッチ用途は別スクリプトとして切り出す。

{
  "test": "bun test",
  "test:watch": "bun test --watch"
}

このテンプレートでは bun test を標準として使用する。vitest を採用する場合は必ず vitest run を test スクリプトに使うこと。

---

手順 1: ユーザーに確認する

まずユーザーに以下を確認する。

1. バックエンドのみ、フロントエンドのみ、フルスタックのどれか。
2. プロジェクト固有の追加依存（例: Prisma, Drizzle, Zod など）があるか。
3. フロントエンドを作る場合、公開 URL、サービス名、description、OGP 画像の絶対 URL。

---

手順 2: packages/backend をスキャフォールドする（バックエンドあり）

packages/backend/package.json

{
  "name": "backend",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "dev": "bun run --watch src/index.ts",
    "start": "bun run src/index.ts",
    "build": "bun build src/index.ts --outdir dist --target bun",
    "test": "bun test",
    "test:watch": "bun test --watch",
    "test:coverage": "bun test --coverage",
    "typecheck": "tsc --noEmit"
  },
  "dependencies": {
    "hono": "^4.0.0"
  },
  "devDependencies": {
    "@types/bun": "latest",
    "typescript": "^5.4.0"
  }
}

packages/backend/tsconfig.json

ルートの tsconfig.base.json (strict + noUncheckedIndexedAccess + verbatimModuleSyntax 等の共有設定) を必ず extends する。各 package で重複した strict 設定を書かない。

{
  "extends": "../../tsconfig.base.json",
  "compilerOptions": {
    "types": ["bun-types"]
  },
  "include": ["src/**/*.ts"]
}

packages/backend/src/index.ts

import { Hono } from 'hono';

const app = new Hono();

app.get('/', (c) => c.json({ status: 'ok' }));

export default app;

packages/backend/src/index.test.ts

import { describe, expect, it } from 'bun:test';
import app from './index';

describe('アプリケーション', () => {
  describe('GET /', () => {
    it('ステータス ok を返すべき', async () => {
      const res = await app.request('/');
      expect(res.status).toBe(200);
      expect(await res.json()).toEqual({ status: 'ok' });
    });
  });
});

Hurl による API テスト

package.json の scripts に以下を追加する。

"test:api": "hurl --test tests/api/*.hurl"

tests/api/health.hurl

GET http://localhost:3000/
HTTP 200
[Asserts]
jsonpath "$.status" == "ok"

Hurl のインストール方法（README に追記する）。

# macOS
brew install hurl
# Linux
cargo install hurl

---

手順 3: packages/frontend をスキャフォールドする（フロントエンドあり）

packages/frontend/package.json

{
  "name": "frontend",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "tsc --noEmit && vite build",
    "preview": "vite preview",
    "test": "bun test",
    "test:watch": "bun test --watch",
    "test:coverage": "bun test --coverage",
    "test:e2e": "playwright test",
    "test:e2e:ui": "playwright test --ui",
    "typecheck": "tsc --noEmit"
  },
  "dependencies": {
    "react": "^18.3.0",
    "react-dom": "^18.3.0"
  },
  "devDependencies": {
    "@playwright/test": "^1.44.0",
    "@types/react": "^18.3.0",
    "@types/react-dom": "^18.3.0",
    "@vitejs/plugin-react": "^4.3.0",
    "typescript": "^5.4.0",
    "vite": "^5.3.0"
  }
}

packages/frontend/playwright.config.ts

import { defineConfig } from '@playwright/test';

export default defineConfig({
  testDir: './e2e',
  use: {
    baseURL: 'http://localhost:5173',
  },
  webServer: {
    command: 'bun run dev',
    url: 'http://localhost:5173',
    reuseExistingServer: !process.env.CI,
  },
});

packages/frontend/e2e/index.spec.ts

import { expect, test } from '@playwright/test';

test.describe('トップページ', () => {
  test('ページが表示されるべき', async ({ page }) => {
    await page.goto('/');
    await expect(page).toHaveTitle(/App/);
  });
});

packages/frontend/tsconfig.json

ルートの tsconfig.base.json を extends する。

{
  "extends": "../../tsconfig.base.json",
  "compilerOptions": {
    "jsx": "react-jsx"
  },
  "include": ["src"]
}

packages/frontend/vite.config.ts

import react from '@vitejs/plugin-react';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [react()],
  server: { port: 5173 },
});

packages/frontend/index.html

<!doctype html>
<html lang="ja">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="<DESCRIPTION>" />
    <link rel="canonical" href="<PUBLIC_URL>" />
    <meta property="og:title" content="<SERVICE_NAME>" />
    <meta property="og:description" content="<DESCRIPTION>" />
    <meta property="og:url" content="<PUBLIC_URL>" />
    <meta property="og:image" content="<OG_IMAGE_URL>" />
    <meta name="twitter:card" content="summary_large_image" />
    <title><SERVICE_NAME></title>
  </head>
  <body>
    <div id="root"></div>
    <script type="module" src="/src/main.tsx"></script>
  </body>
</html>

<PUBLIC_URL>、<SERVICE_NAME>、<DESCRIPTION>、<OG_IMAGE_URL> は 手順 1 で確認した実値に置換する。プレースホルダーのままファイルを作成しない。

packages/frontend/src/main.tsx

import { StrictMode } from 'react';
import { createRoot } from 'react-dom/client';

const root = document.getElementById('root');
if (!root) throw new Error('root element not found');

createRoot(root).render(
  <StrictMode>
    <div>Hello</div>
  </StrictMode>
);

---

手順 4: ファイルを作成する

上記の内容で各ファイルを Write ツールで作成する。ファイル名が .keep の場合は上書きしない。

手順 5: 依存をインストールする

ルートで lifecycle script を無効にして依存をインストールする。

bun install --ignore-scripts

手順 6: 動作確認する

nr test           # 全ワークスペースのユニットテストが通ること
nr typecheck      # 型エラーがないこと
nr test:e2e       # フロントエンドの E2E テストが通ること（packages/frontend）
nr test:api       # バックエンドの API テストが通ること（packages/backend、hurl が必要）
nr check:pre-release # 公開品質 invariant が通ること

手順 7: ユーザーに完了報告する

作成したファイル一覧と次のステップ（機能追加、DB 設定など）を簡潔に報告する。