create-ai-project 1.23.2 → 1.23.4

package/.claude/skills-ja/frontend-typescript-testing/SKILL.md

@@ -5,6 +5,13 @@ description: React Testing Library、MSW、Playwright E2Eでテストを設計
 
 # TypeScript テストルール（フロントエンド）
 
+## 参照
+
+| テスト種別 | 参照先 | 用途 |
+|-----------|--------|------|
+| **ユニット / 統合** | 本ドキュメント | RTL + Vitest + MSW での React コンポーネントテスト |
+| **E2E** | [references/e2e.md](references/e2e.md) | Playwright によるブラウザレベル E2E テスト |
+
 ## テストフレームワーク
 - **Vitest**: このプロジェクトではVitestを使用
 - **React Testing Library**: コンポーネントテスト用
@@ -131,75 +138,12 @@ describe('Button', () => {
 })
 ```
 
-## テスト品質基準
-
-### 境界値・異常系の網羅
-正常系に加え、境界値と異常系を含める。
-```typescript
-it('renders empty state for empty array', () => {
-  render(<UserList users={[]} />)
-  expect(screen.getByText('ユーザーがいません')).toBeInTheDocument()
-})
-
-it('displays error message on API failure', async () => {
-  server.use(rest.get('/api/users', (req, res, ctx) => res(ctx.status(500))))
-  render(<UserList />)
-  expect(await screen.findByText('エラーが発生しました')).toBeInTheDocument()
-})
-```
-
-### ユーザー中心のクエリ
-
-```typescript
-// 良い: アクセシブルなクエリ
-screen.getByRole('button', { name: 'Submit' })
-screen.getByLabelText('Email')
-screen.getByText('Welcome')
-
-// 悪い: 実装詳細への依存
-screen.getByTestId('submit-btn')
-container.querySelector('.btn-primary')
-```
-
-### 非同期処理のテスト
-
-```typescript
-it('loads and displays user data', async () => {
-  render(<UserProfile userId="1" />)
-
-  // ローディング状態を確認
-  expect(screen.getByText('Loading...')).toBeInTheDocument()
-
-  // データ表示を待機
-  expect(await screen.findByText('John Doe')).toBeInTheDocument()
-
-  // ローディングが消えていることを確認
-  expect(screen.queryByText('Loading...')).not.toBeInTheDocument()
-})
-```
-
-### フォームテスト
-
-```typescript
-it('submits form with valid data', async () => {
-  const onSubmit = vi.fn()
-  render(<LoginForm onSubmit={onSubmit} />)
-
-  await userEvent.type(screen.getByLabelText('Email'), 'test@example.com')
-  await userEvent.type(screen.getByLabelText('Password'), 'password123')
-  await userEvent.click(screen.getByRole('button', { name: 'Login' }))
-
-  expect(onSubmit).toHaveBeenCalledWith({
-    email: 'test@example.com',
-    password: 'password123'
-  })
-})
-```
-
 ## テスト設計パターン
 
+実装詳細ではなくユーザーから見える結果を検証する。クエリはアクセシビリティ優先（`getByRole`/`getByLabelText`/`getByText`）で、`getByTestId` や `container.querySelector` に依存しない。正常系だけでなく空・エラー・ローディング/非同期の状態も網羅し、非同期UIは `findBy*` で待機する。
+
 ```typescript
-// Correct: test user-visible results
+// ユーザーから見える結果を検証
 it('increments count when clicked', async () => {
   const user = userEvent.setup()
   render(<Counter />)
@@ -207,10 +151,10 @@ it('increments count when clicked', async () => {
   expect(screen.getByText('Count: 1')).toBeInTheDocument()
 })
 
-// Avoid: testing implementation details
-it('calls setState', () => {
-  const setState = vi.spyOn(React, 'useState')
-  render(<Counter />)
-  // ...
+// エラー状態: 1テストだけハンドラを上書き
+it('shows an error message on API failure', async () => {
+  server.use(http.get('/api/users', () => new HttpResponse(null, { status: 500 })))
+  render(<UserList />)
+  expect(await screen.findByText('エラーが発生しました')).toBeInTheDocument()
 })
 ```

package/.claude/skills-ja/integration-e2e-testing/SKILL.md

@@ -45,6 +45,8 @@ description: 統合テストとE2Eテストを設計。モック境界と振る
 
 ### 必須コメント形式
 
+コミットするスケルトンは、テストフレームワーク（`describe`/`it`/`it.todo` 用）のみを import する。テスト対象モジュールは実装タスクが import するものであり、スケルトンでは import しない — まだ作成されていないモジュールを参照するスケルトンは、テストファイルを型チェック・コンパイル・ロードするゲートが実装着手前に失敗し得る。
+
 各テストに以下のアノテーションを含めること。
 
 ```typescript

package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md

@@ -211,14 +211,9 @@ quality-fixerが `status: "blocked"` を返した場合、`reason`で判別：
 
 注: 小規模スケールでも実装ステップは task-executor を介して標準の4ステップサイクル（`task-executor → エスカレーション判定 → quality-fixer → commit`）で実行する。オーケストレーターによる直接編集は行わない。
 
-### Implementation Readinessマーカー
+### 任意の事前検証（Optional Preflight）
 
-Medium / Large規模では、一括承認後、作業計画書のヘッダに `Implementation Readiness:` 行が含まれる（work-plannerが`pending`を出力する。`ready` または `escalated` への昇格は外部オーケストレーションの関心事である）。マーカーは以下3値のいずれかを取る:
-- `pending` — work-plannerが設定する初期状態
-- `ready` — readiness検証が完了し残存ギャップなし。タスク実行サイクルを安全に開始できる
-- `escalated` — readiness検証は完了したが残存ギャップが存在し、実行前にユーザー判断が必要
-
-`pending`から先へマーカーを昇格させるプロデューサと、task-executor呼び出し前にマーカーを読むコンシューマは、いずれも外部オーケストレーションが所有する。本ガイドはエージェント層の上位にあるオーケストレーターを呼び出さない。エージェントは明示的に依頼された場合にのみマーカーを読み書きする。
+Medium / Large規模では、一括承認後、実装はそのまま進行する。計画がエンドツーエンドで実装可能か（検証戦略の参照、fixture、UI 描画面、E2E/ローカルレーン環境）の検証は、ユーザーが任意に prepare-implementation レシピで実行する事前検証であり、readiness 基準が既に満たされていれば no-op で終了する。本ガイドはエージェント層の上位にあるオーケストレーターを呼び出さない。
 
 ## レイヤー横断オーケストレーション
 

package/.claude/skills-ja/task-analyzer/references/skills-index.yaml

@@ -183,20 +183,19 @@ skills:
   # フロントエンド固有スキル
   frontend-typescript-rules:
     skill: "frontend-typescript-rules"
-    tags: [frontend, react, implementation, type-safety, props-driven, hooks, component-design, vite, error-boundary]
-    typical-use: "React/Viteでのフロントエンド開発、コンポーネント設計、Props設計、環境変数管理"
+    tags: [frontend, react, implementation, type-safety, component-design, props-driven, hooks, error-handling, conventions]
+    typical-use: "Reactコンポーネント実装、Props/状態設計、エラーハンドリング、frontend TypeScript実装ルール"
     size: small
     key-references:
-      - "React公式ドキュメント - Function Components"
-      - "Props-driven開発 - React Patterns"
+      - "React Function Components - React docs"
+      - "Type guards at external boundaries (unknown narrowing)"
+      - "Result type and Error Boundary error handling"
     sections:
-      - "型システム"
-      - "Reactコンポーネント設計"
-      - "状態管理"
+      - "アンチパターンとしきい値"
+      - "境界での型安全性"
+      - "コンポーネントと状態の設計"
       - "エラーハンドリング"
-      - "イベントハンドリング"
-      - "コーディング規約"
-      - "アンチパターン"
+      - "プロジェクト規約"
 
   frontend-typescript-testing:
     skill: "frontend-typescript-testing"
@@ -209,12 +208,12 @@ skills:
       - "ADR-0002 Co-location原則"
       - "references/e2e.md - Playwright E2Eパターン"
     sections:
+      - "参照"
       - "テストフレームワーク"
       - "テストの基本方針"
       - "テストの実装規約"
       - "モックの型安全性の徹底"
       - "React Testing Libraryの基本例"
-      - "テスト品質基準"
       - "テスト設計パターン"
 
   frontend-technical-spec:

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.23.4] - 2026-06-09
+
+### Changed
+
+- **Implementation Readiness gate → optional preflight** (agents, commands, skills) — The work plan no longer carries an `Implementation Readiness` marker and the build / front-build / implement recipes no longer halt on it. Verifying a plan is implementable end-to-end is now an optional, user-invoked preflight via `prepare-implementation`, which presents its Readiness Report in-session (instead of persisting it into the plan or promoting a header marker) and records committed Phase 0 tasks as done so `task-decomposer` does not regenerate them. `plan` surfaces the preflight as a conditional suggestion; `subagents-orchestration-guide` describes it as optional. Applied across en/ja.
+- **Test skeletons stay green under static gates** (agents, skills) — `acceptance-test-generator` and `integration-e2e-testing` bound skeleton generation so a committed skeleton imports only the test framework (no module under test, assertions, or mocks); the implementing task adds executable code alongside the implementation, keeping a freshly committed skeleton green under typecheck / compile / test-load gates.
+- **Removed decorative emojis** (agents, commands) — Stripped pictographic emojis from prompt files and simplified `task-executor` progress states to `[ ] → [x]`. Functional symbols (`[ ]` / `[x]` checkboxes, `→` flow arrows, check / cross marks) are retained.
+
+## [1.23.3] - 2026-06-06
+
+### Added
+
+- **Requirement-boundary fidelity gates** (agents) — Behavior changes are specified, proven, and verified at the requirement boundaries where regressions hide (a behavior can hold on the main path while regressing on a separate branch / state / input / lifecycle / fallback dimension). `technical-designer` / `-frontend` draft each AC value-first and expand it across requirement boundaries before scoping; `acceptance-test-generator` records a boundary-path proof obligation so the generated test traverses the path that would otherwise stay green through a regression; `task-executor` / `-frontend` add a Step 4 Core Mechanism Preservation Check that escalates `design_compliance_violation` when a required mechanism would be replaced by a weaker substitute or is infeasible; `code-reviewer` verifies boundary-path evidence, core-mechanism preservation, and publication-boundary state at AC verification
+
+### Changed
+
+- **technical-designer prompt trimming** (agents) — Compressed the Gate Ordering section to a single serial-gate line, with gate membership and applicability conditions retained in each subsection's `[Gate N — ...]` heading; removed the inline React implementation sample from `technical-designer-frontend` in favor of the loaded `frontend-typescript-rules` skill
+- **Frontend skill alignment across en/ja** (skills) — `frontend-typescript-rules` is a rules-first, self-contained rewrite (thresholds, boundary type safety, component/state rules, and `Result` / `AppError` / Error Boundary idioms; generic syntax examples and `React.FC` dropped); `frontend-typescript-testing` unifies the en/ja structure, routes E2E to `references/e2e.md`, and uses MSW v2 (`http` / `HttpResponse`); `frontend-technical-spec` uses the `VITE_` prefix for client-exposed environment variables
+
 ## [1.23.2] - 2026-06-01
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ai-project",
-  "version": "1.23.2",
+  "version": "1.23.4",
   "packageManager": "npm@10.8.2",
   "description": "TypeScript boilerplate with skills and sub-agents for Claude Code. Prevents context exhaustion through role-based task splitting.",
   "keywords": [