ai-check-template 0.2.0-alpha.0

package/package-templates/docs/test-design-template.md

@@ -0,0 +1,173 @@
+# Test Design Template
+
+> **Status**: Draft v0.1. Copy this file into your project and fill it before asking AI to implement.
+
+This template turns a requirement into observable tests. It is designed for AI-assisted development, where the model should not start implementation until the expected behavior, edge cases, and verification commands are explicit.
+
+Use it between:
+
+```
+Requirement -> Acceptance Criteria -> Test Design -> AI Implementation -> Quality Check
+```
+
+The goal is Formal Name Match: the "name" is the declared behavior below, and the "form" is the evidence produced by tests and diagnostics.
+
+## How to Use
+
+1. Fill `Requirement` and `Acceptance Criteria` before implementation.
+2. Map each acceptance criterion to at least one test row.
+3. Assign each test to the cheapest reliable verification layer.
+4. Give this completed document to the AI along with the implementation task.
+5. After implementation, run the verification commands exactly as written.
+6. If a command fails, use [`../prompts/diagnostic-repair.md`](../prompts/diagnostic-repair.md) with redacted diagnostic output.
+
+## Requirement
+
+### Summary
+
+Write the user-visible behavior in one or two sentences.
+
+Example:
+
+> Users can update their display name from the profile settings page. Empty names are rejected and successful updates are reflected immediately on the page.
+
+### Scope
+
+- In scope:
+  - [write the files, screens, API routes, or commands that may change]
+  - [write the behaviors that must be implemented]
+- Out of scope:
+  - [write adjacent behaviors that must not change]
+  - [write future work that should not be pulled into this task]
+
+### User / Actor
+
+- Primary actor:
+- Secondary actor:
+- Trust boundary:
+
+### Inputs and Outputs
+
+| Item | Type | Source | Expected shape | Notes |
+|---|---|---|---|---|
+| input_name | string | UI / API / CLI | 1-50 visible characters | Example row |
+| output_state | object | API response / UI state | public fields only | Example row |
+
+## Acceptance Criteria
+
+Write acceptance criteria before implementation. They should be stable even if the implementation approach changes.
+
+| AC ID | Criterion | Verification command or test | Layer |
+|---|---|---|---|
+| AC-01 | Happy path behavior succeeds | `pnpm test path/to/test` | unit / integration |
+| AC-02 | Invalid input is rejected | `pnpm test path/to/test` | unit |
+| AC-03 | Unauthorized or out-of-scope access is blocked | `pnpm test path/to/test` | integration / security |
+| AC-04 | Existing behavior does not regress | `pnpm ai:check` | full gate |
+
+Rules:
+
+- Each AC must have a command, test name, or explicit manual evidence.
+- At least one AC should cover an error path.
+- Security or trust boundary changes must have a negative test.
+- Do not rewrite AC after implementation just to match the code.
+
+## Test Matrix
+
+Use this table to map behavior to the cheapest reliable test layer.
+
+| Test ID | AC ID | Scenario | Given | When | Then | Layer | Command | Owner |
+|---|---|---|---|---|---|---|---|---|
+| T-001 | AC-01 | valid happy path | valid precondition | user performs allowed action | expected output appears | unit | `pnpm test path/to/test` | AI |
+| T-002 | AC-02 | boundary input | input at minimum / maximum | validation runs | accepted or rejected per rule | unit | `pnpm test path/to/test` | AI |
+| T-003 | AC-03 | trust boundary / security | actor lacks permission or data is private | actor requests protected action | request is rejected and private data is not exposed | integration / security | `pnpm test path/to/test` | AI |
+| T-004 | AC-04 | regression guard | existing fixture or workflow exists | full check runs | no unrelated failure appears | full gate | `pnpm ai:check` | human + AI |
+
+Layer guidance:
+
+- Static: types, lint, dependency boundaries, dead code.
+- Unit: pure logic, validation, formatting, permission predicates.
+- Integration: API route, database boundary, service boundary, auth context.
+- E2E: core user path only; avoid using E2E for cheap unit-observable behavior.
+- Security: RLS, authorization, private field exposure, injection, secret handling.
+
+## Given-When-Then
+
+Convert the most important rows into Given-When-Then statements. This makes the expected behavior easier for both humans and AI to follow.
+
+```gherkin
+Scenario: valid display name update
+  Given a signed-in user with an existing profile
+  When the user submits a display name within the allowed length
+  Then the profile is updated
+  And the updated display name is visible in the response or UI
+```
+
+```gherkin
+Scenario: empty display name is rejected
+  Given a signed-in user with an existing profile
+  When the user submits an empty display name
+  Then the request is rejected
+  And the existing profile remains unchanged
+```
+
+```gherkin
+Scenario: private data does not cross the trust boundary
+  Given a public API response for another user
+  When the response is serialized
+  Then private fields are not included
+  And the test asserts the exact public field allowlist
+```
+
+## Verification Commands
+
+List commands in the order they should run. Prefer fast checks first.
+
+```bash
+pnpm typecheck
+pnpm lint
+pnpm test path/to/changed-area
+pnpm ai:check:fast
+pnpm ai:check
+```
+
+If a command is not available in your project, replace it before implementation. Do not leave placeholder commands in the final task.
+
+## Risks and Gaps
+
+| Risk / Gap | Why it matters | Mitigation | Follow-up trigger |
+|---|---|---|---|
+| Missing negative test | AI may implement happy path only | Add an invalid input or unauthorized actor row | Any permission or validation change |
+| Overusing E2E | Slow and brittle checks hide simple logic failures | Move cheap checks to unit / integration | E2E test duplicates pure logic |
+| Private data exposure | AI may return full records by convenience | Use exact public allowlist assertions | API response crosses trust boundary |
+| Unclear rollback | Failed implementation may spread unrelated edits | Record files in scope and rollback path | More than one layer changes |
+
+## AI Implementation Brief
+
+After this template is filled, give the AI this instruction:
+
+```
+Implement the task using the Requirement, Acceptance Criteria, Test Matrix, and Verification Commands above.
+
+Constraints:
+- Do not change the acceptance criteria.
+- Do not add files outside the declared scope.
+- Add or update tests before or together with implementation.
+- Run the verification commands and report exact output.
+- If a command fails, stop and provide the failing output instead of claiming success.
+```
+
+## Review Checklist
+
+- [ ] Every AC maps to at least one test row.
+- [ ] At least one error path is tested.
+- [ ] Trust boundary or security behavior has a negative test when applicable.
+- [ ] Verification commands are executable in this project.
+- [ ] The AI is not allowed to change AC after implementation.
+- [ ] Remaining gaps are explicit and assigned to follow-up work.
+
+## Related Philosophy
+
+- [`./philosophy/formal-name-match.md`](./philosophy/formal-name-match.md) — Declare the expected name before comparing the actual form.
+- [`./philosophy/test-pyramid.md`](./philosophy/test-pyramid.md) — Put each check at the cheapest reliable layer.
+- [`./philosophy/given-when-then.md`](./philosophy/given-when-then.md) — Express behavior as Given / When / Then.
+- [`./philosophy/qa-techniques.md`](./philosophy/qa-techniques.md) — Use equivalence classes, boundary values, decision tables, and state transitions.

package/package-templates/package.scripts.fragment.json

@@ -0,0 +1,6 @@
+{
+  "scripts": {
+    "ai:check": "pnpm typecheck && pnpm lint && pnpm test && pnpm test:e2e:smoke",
+    "ai:check:fast": "pnpm typecheck && pnpm lint && pnpm test:unit"
+  }
+}

package/package-templates/profiles/README.md

@@ -0,0 +1,89 @@
+# profiles/
+
+技術スタック別の typical 構成を提供する profile ライブラリ。利用者は自プロジェクトに合う profile を 1 つ選び、必要なら addon profile（supabase-rls）と組み合わせる。
+
+> **ステータス**: Draft v0.1（Phase 0 では README のみ配布、実体ファイルは Phase 2 で）
+
+## 5 profile 一覧
+
+| profile | 対象スタック | 主な特徴 | 注意点 |
+|---|---|---|---|
+| [`react-nextjs/`](./react-nextjs/README.md) | Next.js App Router + TS | フル toolchain | 推奨スタート地点 |
+| [`react-vanilla/`](./react-vanilla/README.md) | 純 React + TS（Vite / CRA） | Next.js なし | SSR なしのため SEO 別途 |
+| [`expo-rn/`](./expo-rn/README.md) | Expo / React Native | モバイル特化 | **React Doctor 非対応**、Maestro / Detox 使用 |
+| [`node-cli/`](./node-cli/README.md) | Node CLI / Library | UI なし、Static + Unit 中心 | Playwright 不要 |
+| [`supabase-rls/`](./supabase-rls/README.md)（addon） | Supabase + RLS | 上記 profile に追加適用 | 単独 profile ではない、組み合わせ前提 |
+
+## 選び方フロー
+
+```
+1. UI を持つ？
+   ├─ Yes: Web か モバイルか？
+   │      ├─ Web: Next.js を使う？
+   │      │       ├─ Yes → react-nextjs
+   │      │       └─ No  → react-vanilla
+   │      └─ モバイル → expo-rn
+   └─ No → node-cli
+
+2. Supabase + RLS を使う？
+   ├─ Yes → 上で選んだ profile に supabase-rls を追加
+   └─ No  → 上で選んだ profile のみ
+```
+
+## 組み合わせパターン例
+
+| 組み合わせ | 使うところ |
+|---|---|
+| `react-nextjs` | Next.js + 自前 API |
+| `react-nextjs+supabase-rls` | Next.js + Supabase（最も多い構成） |
+| `react-vanilla` | SPA + 自前 API |
+| `react-vanilla+supabase-rls` | SPA + Supabase |
+| `expo-rn` | モバイル + 自前 API |
+| `expo-rn+supabase-rls` | モバイル + Supabase |
+| `node-cli` | CLI ツール / ライブラリ |
+| `node-cli+supabase-rls` | サーバー側スクリプト + Supabase |
+
+Phase 2 の CLI 実装で `--profile react-nextjs+supabase-rls` 形式を予定。
+
+## Phase 0 ステータス
+
+本ディレクトリは Phase 0 では **README のみ配布**。実体ファイル（profile-specific な scripts / hook / 設定）は以下のフェーズで提供:
+
+| Phase | 内容 |
+|---|---|
+| Phase 0（現状） | profile README のみ |
+| Phase 1 | dogfooding で profile の精度を上げる（README 改訂） |
+| Phase 2 | profile-specific な実体ファイルを CLI で配布（`npx ai-check-template init --profile X`） |
+| Phase 3 | 多 profile / 多プロジェクトでの横展開 |
+
+利用者は現状 README を読んで手動で自プロジェクトを構成する。Phase 2 以降は CLI 統合される。
+
+## 各 profile に共通する構造
+
+| セクション | 内容 |
+|---|---|
+| 目的 | 誰向け・何を解決するか |
+| 対象スタック | フレームワーク・ライブラリ・バージョン |
+| 推奨ツール | 必須 / 推奨 / 任意のテーブル |
+| ai:check カスタマイズ案 | `package.scripts.fragment.json` の差分 |
+| .claude / scripts カスタマイズ案 | hook / scripts の差分 |
+| 注意事項 | profile 固有の落とし穴 |
+| 隣接 profile | 他 profile への参照 |
+| 隣接思想 | philosophy への相互リンク |
+| 出典 | Notion / 公式 docs |
+
+## 新規 profile の追加
+
+新しいスタック（例: rust-cli, python-fastapi）への対応は新規 SPEC で行う。本 SPEC（SPEC-0005）は 5 profile に限定。
+
+## 隣接する思想
+
+- [`../docs/philosophy/test-pyramid.md`](../docs/philosophy/test-pyramid.md) — 各 profile で責務分割の応用が異なる
+- [`../docs/philosophy/formal-name-match.md`](../docs/philosophy/formal-name-match.md) — 形名参同（profile 別の「名」定義）
+- [`../docs/philosophy/qa-techniques.md`](../docs/philosophy/qa-techniques.md) — QA 技法
+- [`../docs/philosophy/given-when-then.md`](../docs/philosophy/given-when-then.md) — GWT
+
+## 出典
+
+- Notion ページ: `c3e549660ca44005a20c4f6fdb54c8d5` — 無料で作る AI エージェント開発診断フロー（参照日 2026-05-13）
+- Notion ページ: `7c531b165bab4b7ea2dce1782469ac52` — Supabase Testing 戦略

package/package-templates/profiles/expo-rn/README.md

@@ -0,0 +1,80 @@
+# expo-rn profile
+
+> **ステータス**: Draft v0.1（Phase 1 dogfooding 後に改訂予定。実体ファイルは Phase 2 で配布）
+
+## 目的
+
+Expo / React Native 環境の typical stack 向け profile。モバイル特有の制約（Native 連携、E2E ツールの違い、React Doctor の非対応）を考慮した品質ループを構築する。
+
+## 対象スタック
+
+| カテゴリ | 想定 |
+|---|---|
+| Framework | Expo SDK 50+ または素の React Native 0.73+ |
+| Language | TypeScript |
+| Navigation | React Navigation / Expo Router |
+| Package Manager | pnpm / npm / yarn |
+| Node version | 22 LTS |
+| Native | iOS / Android（必要に応じて） |
+| E2E | Maestro / Detox（Playwright は使わない） |
+
+## 推奨ツール
+
+| ツール | 必須/推奨/任意 | 用途 | 備考 |
+|---|---|---|---|
+| TypeScript | 必須 | 型チェック | |
+| ESLint / oxlint | 必須 | lint | |
+| **React Doctor** | **非対応** | — | React Doctor は **モバイル非対応**。代替なし（純 React コンポーネントのみ別途部分検査可） |
+| Knip | 推奨 | 未使用検出 | |
+| Jest / Vitest | 必須 | Unit / Integration | Jest が React Native コミュニティでは主流 |
+| **Maestro** | 推奨 | E2E（モバイル UI） | Playwright の代替。YAML ベースで AI 出力と相性◯ |
+| **Detox** | 任意 | E2E（より高度） | iOS / Android シミュレータ統合 |
+| Semgrep | 推奨 | セキュリティ | |
+
+## ai:check / ai:check:fast カスタマイズ案
+
+```json
+{
+  "scripts": {
+    "ai:check": "pnpm typecheck && pnpm lint && pnpm deadcode && pnpm test && pnpm test:e2e:smoke",
+    "ai:check:fast": "pnpm typecheck && pnpm lint && pnpm test:unit"
+  }
+}
+```
+
+- `test:e2e:smoke`: Maestro で `maestro test .maestro/smoke.yaml` 等
+- React Doctor 関連の script は **入れない**
+
+## .claude / scripts カスタマイズ案
+
+- `.claude/rules/test-rules.md`: Playwright Locator 優先順位の代わりに **Maestro / Detox の selector ルール**を記述
+  - Maestro: `id:my-button` / `text:Submit` の優先順位
+  - Detox: `by.id` > `by.label` > `by.text`
+- hook fragment は基本構造そのまま（コマンドは `pnpm ai:check` / `pnpm ai:check:fast`）
+
+## 注意事項
+
+- **React Doctor 非対応**: 本 profile の最大の特徴。診断スコアによる判定は使えない。代替として静的解析 + 手動レビューに依存
+- **Native module の test 困難**: モック化必須。test:unit でカバーできない範囲は Maestro / 手動確認
+- **iOS / Android 差異**: 両 OS で動かして確認。CI で両 OS を sharding するコストを考慮
+- **Expo Go 制限**: 一部 Native 機能は Expo Go では動かないため、開発ビルド / プロダクションビルドでのテストが必要
+- **キャッシュ問題**: Metro / Babel のキャッシュで「直したつもりが反映されない」事故あり。CI では cache クリアを明示
+
+## 隣接 profile
+
+- [`../react-vanilla/README.md`](../react-vanilla/README.md) — Web の純 React
+- [`../react-nextjs/README.md`](../react-nextjs/README.md) — Web の Next.js
+- [`../node-cli/README.md`](../node-cli/README.md) — サーバー側ロジック
+
+## 隣接思想
+
+- [`../../docs/philosophy/test-pyramid.md`](../../docs/philosophy/test-pyramid.md) — モバイルでは E2E 層のコスト構造が異なる
+- [`../../docs/philosophy/formal-name-match.md`](../../docs/philosophy/formal-name-match.md) — 形名参同（React Doctor を使わない場合は他の「形」で代替）
+- [`../../docs/philosophy/qa-techniques.md`](../../docs/philosophy/qa-techniques.md) — QA 技法
+- [`../../docs/philosophy/given-when-then.md`](../../docs/philosophy/given-when-then.md) — GWT（Maestro / Detox にそのまま使える）
+
+## 出典
+
+- Notion ページ: `c3e549660ca44005a20c4f6fdb54c8d5` — 無料で作る AI エージェント開発診断フロー（参照日 2026-05-13）
+- Maestro 公式 docs
+- Detox 公式 docs

package/package-templates/profiles/node-cli/README.md

@@ -0,0 +1,93 @@
+# node-cli profile
+
+> **ステータス**: Draft v0.1（Phase 1 dogfooding 後に改訂予定。実体ファイルは Phase 2 で配布）
+
+## 目的
+
+UI を持たない Node.js CLI / Library / サーバー側コード向け profile。UI / E2E ツールを除外し、Static + Unit + Integration に焦点を絞った品質ループを構築する。
+
+## 対象スタック
+
+| カテゴリ | 想定 |
+|---|---|
+| Runtime | Node.js 22 LTS（20 でも動作） |
+| Language | TypeScript |
+| Build | tsc / esbuild / tsup / unbuild |
+| CLI Framework | commander / oclif / yargs / 自前 |
+| Package Manager | pnpm / npm / yarn / bun |
+| UI | **なし** |
+| E2E | **なし**（必要なら integration test で代替） |
+
+## 推奨ツール
+
+| ツール | 必須/推奨/任意 | 用途 | 備考 |
+|---|---|---|---|
+| TypeScript | 必須 | 型チェック | |
+| ESLint / oxlint | 必須 | lint | |
+| **React Doctor** | **非対応** | — | React なしのため |
+| Knip | 必須 | 未使用検出 | Library は未使用 export の影響大、必須 |
+| Vitest | 必須 | Unit / Integration | |
+| **Playwright** | **不要** | — | UI なし |
+| Semgrep | 推奨 | セキュリティ | 特に CLI 引数 / ファイル I/O 経路 |
+
+## ai:check / ai:check:fast カスタマイズ案
+
+```json
+{
+  "scripts": {
+    "ai:check": "pnpm typecheck && pnpm lint && pnpm deadcode && pnpm test",
+    "ai:check:fast": "pnpm typecheck && pnpm lint && pnpm test:unit"
+  }
+}
+```
+
+- E2E ステップは含まない
+- `test`: integration を含む全テスト
+- `test:unit`: Unit のみ（fast loop 用）
+
+## .claude / scripts カスタマイズ案
+
+- `.claude/rules/test-rules.md`: Playwright Locator 優先順位は **不要**。代わりに **CLI 引数 / stdin / stdout の testing ルール**を記述してもよい（カスタマイズ）
+- hook fragment / scripts はそのまま使える
+
+## 注意事項
+
+- **stdin / stdout**: CLI の入出力をテストする際、`spawn` / `execa` でサブプロセス化 + stdout を assert
+- **環境変数**: `.env` 経由の設定は test で明示的に上書き
+- **path traversal**: ファイル操作する CLI は path traversal 攻撃の検証必須（Semgrep でカバー）
+- **exit code**: 「正常終了 = 0」「エラー = 非 0」を必ずテスト
+- **publish 前の検査**: `npm pack` で配布物に余計なファイルが入らないか確認
+
+## CLI 特有のテストパターン
+
+```typescript
+// CLI 統合テスト例（vitest + execa）
+import { execa } from 'execa';
+
+it('CLI exits 0 on valid input', async () => {
+  const { stdout, exitCode } = await execa('node', ['./dist/cli.js', '--input', 'foo']);
+  expect(exitCode).toBe(0);
+  expect(stdout).toContain('expected output');
+});
+
+it('CLI exits non-zero on invalid input', async () => {
+  await expect(execa('node', ['./dist/cli.js', '--invalid'])).rejects.toMatchObject({ exitCode: 1 });
+});
+```
+
+## 隣接 profile
+
+- [`../react-nextjs/README.md`](../react-nextjs/README.md) — フルスタック Web
+- [`../react-vanilla/README.md`](../react-vanilla/README.md) — Web の SPA
+- [`../supabase-rls/README.md`](../supabase-rls/README.md) — DB 統合がある場合に組み合わせ
+
+## 隣接思想
+
+- [`../../docs/philosophy/test-pyramid.md`](../../docs/philosophy/test-pyramid.md) — E2E 層なしで Static + Unit + Integration が中心
+- [`../../docs/philosophy/formal-name-match.md`](../../docs/philosophy/formal-name-match.md) — 形名参同
+- [`../../docs/philosophy/qa-techniques.md`](../../docs/philosophy/qa-techniques.md) — boundary-value, decision-table が特に有効
+- [`../../docs/philosophy/given-when-then.md`](../../docs/philosophy/given-when-then.md) — GWT
+
+## 出典
+
+- Notion ページ: `c3e549660ca44005a20c4f6fdb54c8d5` — 無料で作る AI エージェント開発診断フロー（参照日 2026-05-13）

package/package-templates/profiles/react-nextjs/README.md

@@ -0,0 +1,82 @@
+# react-nextjs profile
+
+> **ステータス**: Draft v0.1（Phase 1 dogfooding 後に改訂予定。実体ファイルは Phase 2 で配布）
+
+## 目的
+
+Next.js（App Router 想定）+ TypeScript の typical stack で AI 駆動開発の品質ループを構築する利用者向け profile。フル toolchain（型 / lint / 静的解析 / 未使用検出 / E2E / セキュリティ）を組み合わせて、形名参同による品質照合を実装する。
+
+## 対象スタック
+
+| カテゴリ | 想定 |
+|---|---|
+| Framework | Next.js 14+（App Router、Pages Router でも動作するが調整必要） |
+| Language | TypeScript |
+| Package Manager | pnpm（npm / yarn / bun でも可、`PM` 環境変数で切り替え） |
+| Node version | 22 LTS（20 でも動作） |
+| UI Test | Playwright |
+| Style | Tailwind / CSS Modules / styled-components いずれも可 |
+
+## 推奨ツール
+
+| ツール | 必須/推奨/任意 | 用途 | 備考 |
+|---|---|---|---|
+| TypeScript | 必須 | 型チェック | `tsc --noEmit` を `ai:check:fast` に含める |
+| ESLint / oxlint | 必須 | lint | oxlint の高速性で AI 内部ループ向き |
+| React Doctor | 推奨 | React/Next.js 品質診断 | 75 以上目標、50 未満マージ不可 |
+| Knip | 推奨 | 未使用検出 | 1 週間運用後に CI 強制を検討 |
+| Playwright | 必須 | E2E（主要導線のみ） | smoke は PR、full は nightly |
+| Semgrep | 推奨 | セキュリティ | High/Critical でマージブロック |
+
+## ai:check / ai:check:fast カスタマイズ案
+
+`package.scripts.fragment.json` を以下のように調整:
+
+```json
+{
+  "scripts": {
+    "ai:check": "pnpm typecheck && pnpm lint && pnpm doctor && pnpm deadcode && pnpm test && pnpm test:e2e:smoke",
+    "ai:check:fast": "pnpm typecheck && pnpm lint && pnpm test:unit"
+  }
+}
+```
+
+個別ツールの npm script を別途定義:
+- `typecheck`: `tsc --noEmit`
+- `lint`: `next lint` または `oxlint .`
+- `doctor`: `npx -y react-doctor@latest . --fail-on warning`
+- `deadcode`: `knip`
+- `test`: `vitest run`
+- `test:unit`: `vitest run --dir tests/unit`
+- `test:e2e:smoke`: `playwright test --grep smoke`
+
+## .claude / scripts カスタマイズ案
+
+- `.claude/settings.hook-fragment.json`: そのまま使える（hook command が `pnpm ai:check` / `pnpm ai:check:fast`）
+- `.claude/rules/test-rules.md`: Playwright Locator 優先順位を遵守
+- `scripts/ai-check.sh` / `ai-check-fast.sh`: そのまま
+
+## 注意事項
+
+- **Pages Router の場合**: App Router 前提の React Doctor 診断項目が一部対象外。`--ignore-pages` 等の調整を検討
+- **monorepo**: workspace の場合、`pnpm -r ai:check` のような root レベルスクリプトを別途用意
+- **Playwright のフレーキー**: 主要導線のみに絞り、retry 1 回まで許容
+- **Server Actions**: 認可は client 側だけでなく server action 内でも検証（参照: [`../../docs/philosophy/test-pyramid.md`](../../docs/philosophy/test-pyramid.md) §3 Integration）
+
+## 隣接 profile
+
+- [`../react-vanilla/README.md`](../react-vanilla/README.md) — Next.js なしの純 React
+- [`../supabase-rls/README.md`](../supabase-rls/README.md) — Supabase + RLS を追加適用
+- [`../expo-rn/README.md`](../expo-rn/README.md) — モバイル（React Native）
+
+## 隣接思想
+
+- [`../../docs/philosophy/formal-name-match.md`](../../docs/philosophy/formal-name-match.md) — 形名参同
+- [`../../docs/philosophy/test-pyramid.md`](../../docs/philosophy/test-pyramid.md) — 責務分割
+- [`../../docs/philosophy/given-when-then.md`](../../docs/philosophy/given-when-then.md) — 受け入れ条件先出し
+- [`../../docs/philosophy/qa-techniques.md`](../../docs/philosophy/qa-techniques.md) — QA 技法
+
+## 出典
+
+- Notion ページ: `c3e549660ca44005a20c4f6fdb54c8d5` — 無料で作る AI エージェント開発診断フロー（参照日 2026-05-13）
+- Next.js Testing Guide（公式）

package/package-templates/profiles/react-vanilla/README.md

@@ -0,0 +1,73 @@
+# react-vanilla profile
+
+> **ステータス**: Draft v0.1（Phase 1 dogfooding 後に改訂予定。実体ファイルは Phase 2 で配布）
+
+## 目的
+
+純 React + TypeScript（Next.js なし、Vite / CRA / 自前 setup）の typical stack 向け profile。Next.js 固有機能を除外し、SPA としての品質ループを構築する。
+
+## 対象スタック
+
+| カテゴリ | 想定 |
+|---|---|
+| Framework | React 18+（Vite / Create React App / 自前 webpack 等） |
+| Language | TypeScript |
+| Routing | React Router / TanStack Router 等 |
+| Package Manager | pnpm（npm / yarn / bun でも可） |
+| Node version | 22 LTS |
+| UI Test | Playwright（任意、SPA のみなら React Testing Library で代替可） |
+
+## 推奨ツール
+
+| ツール | 必須/推奨/任意 | 用途 | 備考 |
+|---|---|---|---|
+| TypeScript | 必須 | 型チェック | |
+| ESLint / oxlint | 必須 | lint | |
+| React Doctor | 任意 | React 品質診断 | Next.js 固有診断項目は対象外、純 React 部分のみ有効 |
+| Knip | 推奨 | 未使用検出 | |
+| Vitest | 必須 | Unit / Integration | |
+| Playwright | 任意 | E2E | SPA で十分な testing-library 等で代替可 |
+| Semgrep | 推奨 | セキュリティ | |
+
+## ai:check / ai:check:fast カスタマイズ案
+
+```json
+{
+  "scripts": {
+    "ai:check": "pnpm typecheck && pnpm lint && pnpm deadcode && pnpm test",
+    "ai:check:fast": "pnpm typecheck && pnpm lint && pnpm test:unit"
+  }
+}
+```
+
+Playwright を使う場合は `ai:check` に `pnpm test:e2e:smoke` を追加。
+
+## .claude / scripts カスタマイズ案
+
+react-nextjs profile と同じ（hook fragment / test-rules / scripts はそのまま使える）。
+ただし test-rules.md の Playwright Locator 優先順位は Playwright を使わない場合は不要。
+
+## 注意事項
+
+- **SPA の SEO 制約**: SSR がないため、SEO 観点のテストは別途検討
+- **react-router の権限制御**: `<ProtectedRoute>` 等の wrapper が server-side 認可と一致するか確認
+- **localStorage / sessionStorage の漏洩**: secret を store しないか lint で検出
+- **CSP**: SPA は inline script を多用しがちなので strict CSP との相性を確認
+
+## 隣接 profile
+
+- [`../react-nextjs/README.md`](../react-nextjs/README.md) — Next.js（推奨：本 profile より広範囲）
+- [`../node-cli/README.md`](../node-cli/README.md) — UI なしの Node
+- [`../supabase-rls/README.md`](../supabase-rls/README.md) — Supabase + RLS を追加
+
+## 隣接思想
+
+- [`../../docs/philosophy/test-pyramid.md`](../../docs/philosophy/test-pyramid.md) — 各層の責務分割
+- [`../../docs/philosophy/formal-name-match.md`](../../docs/philosophy/formal-name-match.md) — 形名参同
+- [`../../docs/philosophy/qa-techniques.md`](../../docs/philosophy/qa-techniques.md) — QA 技法
+- [`../../docs/philosophy/given-when-then.md`](../../docs/philosophy/given-when-then.md) — GWT
+
+## 出典
+
+- Notion ページ: `c3e549660ca44005a20c4f6fdb54c8d5` — 無料で作る AI エージェント開発診断フロー（参照日 2026-05-13）
+- Testing Library Guiding Principles（公式）