{
  "markdown": "# ブラウザゲームテンプレート\n\nAI エージェントを活用した開発を前提とする、ブラウザゲーム開発用テンプレートです。\ncanvas ベースのゲームと HTML 要素（フォーム等）中心のゲームの両方を想定しています。\n\n## 機能一覧\n\n### ゲーム開発\n\n- Vite + React + TanStack Router + Panda CSS + Ark UI のクライアント基盤（サンプルゲーム 2 種同梱: canvas のボール避け / フォームの計算クイズ）\n- 自作の薄いゲームループ（固定タイムステップ・pause/step/timeScale・シード付き乱数 — `src/game/`、ライブラリ非依存）\n- Hono API サーバー同梱（開発時は Vite が `/api` を proxy、本番は SPA 配信 + API の単一プロセス）\n- デバッグパネル（開発時のみ）: ゲームパラメーターと Panda CSS デザイントークンをランタイム調整 → 調整値をエクスポートしてエージェントがコードへ反映\n- フィードバックユーティリティ: プレイ中の気づきを `feedback/*.md` に保存し、AI エージェントへの申し送りに\n- GitHub Issue 発行ユーティリティ: ゲーム状態スナップショット付きで Issue 作成画面を開く\n- AI テストプレイの窓口 `window.__GAME_DEBUG__`: シード固定・入力注入・フレーム送りで決定論的にテストプレイ（手順: [docs/knowledge/runbooks/agent-playtest.md](docs/knowledge/runbooks/agent-playtest.md)）\n\n### 開発基盤\n\n- TypeScript による型安全な開発環境\n- Biome による高速なフォーマット・リント\n- テスト・ベンチマーク・カバレッジ計測（vitest projects — node / happy-dom, しきい値 80%）\n- pre-commit hooks による品質保証（biome / typecheck / secretlint）\n- GitHub Actions による CI（Node 24/25 マトリクス、Actions は commit SHA・Dev Container Features と Docker ベースイメージは sha256 digest で固定、依存自動更新）\n- PR 自動ラベリング（actions/labeler — ハーネス変更 PR に `meta` ラベル）とラベル定義の同期（`.github/labels.yml`）\n- セキュリティスキャン（secretlint / pnpm audit / Trivy — CRITICAL/HIGH 検出で CI を fail）\n- SBOM 生成（CycloneDX、cdxgen）\n- Dockerfile / GitHub Actions 自体のリント（hadolint / actionlint / zizmor）\n- VS Code Dev Containers: AI エージェントツールチェーン（Claude Code CLI、Codex CLI、GitHub CLI、共通ユーティリティ）を [Dev Container Features](https://containers.dev/implementors/features/) と post-create セットアップで重ねて注入\n- Chrome DevTools MCP + headless Chromium: エージェントがコンテナ内で画面の見た目をデバッグ（スクリーンショット・コンソール・ネットワーク確認）\n\n## このテンプレートの導入手順\n\nテンプレートからリポジトリを作成したら:\n\n1. `package.json` の `name` をプロジェクト名に変更する（必要なら `description` 等のメタデータも追加）。\n2. `LICENSE` のプレースホルダ（`[yyyy]`、`[name of copyright owner]`）を記入する — もしくはライセンスごと差し替える。\n3. `.github/CODEOWNERS` の `@REPLACE-ME` を実在の GitHub ユーザー / チームに置き換える。\n4. `docs/knowledge/` のサンプルドキュメントを実プロジェクトの知識で差し替える（運用ルールは `docs/knowledge/index.md` を参照）。\n5. Issue 発行ユーティリティを使う場合は `.env.example` を `.env` にコピーして `VITE_REPO_URL` を設定する。\n6. `corepack enable && pnpm install && pnpm release-check` を実行し、セットアップ後のプロジェクトが健全なことを確認する。\n\n## セットアップ\n\n```bash\ncorepack enable\npnpm install\n```\n\n`pnpm` は `package.json` の `packageManager` フィールド経由で corepack が自動的に正しいバージョンを使用します。\n\n### pre-commit hooks（任意）\n\n[prek](https://github.com/j178/prek) を[インストール](https://github.com/j178/prek?tab=readme-ov-file#installation)した後：\n\n```bash\nprek install\n```\n\n## 主なコマンド\n\n```bash\npnpm dev            # Vite (:5173) + Hono API (:3000) を並行起動\npnpm test           # テスト（panda codegen を内包）\npnpm test:cov       # カバレッジ計測\npnpm bench          # ベンチマーク\npnpm fmt            # フォーマット適用\npnpm lint           # リント\npnpm check          # biome check + typecheck\npnpm release-check  # CI 相当の一括チェック（biome ci + typecheck + test）\npnpm scan:secrets   # シークレット検出\npnpm build          # panda codegen → vite build → tsc（dist/client + dist/server）\npnpm start          # 本番モードで起動（:3000、SPA 配信 + API）\n```\n\n開発サーバー起動後、`http://localhost:5173` でサンプルゲームを遊べます。\n画面右下の🐞ボタン（または `Ctrl+Shift+D`）でデバッグパネルが開きます。\n\n詳細は [AGENTS.md](AGENTS.md) を参照。\n\n## プロジェクト構造\n\nディレクトリ構成・設定ファイルの詳細は [AGENTS.md](AGENTS.md) を参照してください。\n\n## AI Agent Dev Container\n\nVS Code Dev Container を AI コーディングエージェント（Claude Code / Codex 等）の実行環境としても利用できます。同梱ツール・認証手順・ホスト設定の継承・サンドボックスのモード・PAT 運用などの詳細は [.devcontainer/README.md](.devcontainer/README.md) を参照してください。\n\n## リリースチェックリスト\n\n1. `pnpm release-check` を実行してすべてのチェックが通ることを確認\n2. `CHANGELOG.md` を更新\n3. バージョンタグを作成\n\n## ライセンス\n\n[MIT](LICENSE)。`LICENSE` 内の `[yyyy] [name of copyright owner]` は派生先で年と著作権者名に置換してください。\n",
  "bytes": 3568,
  "sha": "b8288daf4793788ca9e86c2c1dc76ff911d33b8a5f74e9ad963f5fbd40220f89",
  "repo_slug": "hanamizuno/spider",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_hanamizuno_spider_docs_knowledge_index_m_36ab33a3/readme"
}