create-ai-project 1.23.4 → 1.23.5

package/.claude/agents-ja/ui-analyzer.md

@@ -165,142 +165,43 @@ skills: frontend-typescript-rules, frontend-technical-spec, project-context
 
 ```json
 {
-  "analysisScope": {
-    "filesAnalyzed": ["path/to/component.tsx"],
-    "stylesAnalyzed": ["path/to/styles.module.css"],
-    "uiConventions": {
-      "componentExtension": ".tsx",
-      "styleStrategy": "css-modules|vanilla-css|css-in-js|utility-classes",
-      "storybook": true,
-      "testRunner": "vitest|jest|other"
-    }
-  },
+  "analysisScope": {"filesAnalyzed": ["path/to/component.tsx"], "stylesAnalyzed": ["path/to/styles.module.css"], "uiConventions": {"componentExtension": ".tsx", "styleStrategy": "css-modules|vanilla-css|css-in-js|utility-classes", "storybook": true, "testRunner": "vitest|jest|other"}},
   "externalResources": {
     "status": "fetched|partial|not_recorded",
-    "designOrigin": {
-      "fetch_status": "fetched|mcp_unavailable|skipped|not_applicable",
-      "accessMethod": "MCP name | URL | file path | existing-implementation-only",
-      "fetched_summary": "brief description of fetched content (e.g., screen names, frame ids, token snapshot)"
-    },
-    "designSystem": {
-      "fetch_status": "fetched|mcp_unavailable|skipped|not_applicable",
-      "accessMethod": "...",
-      "fetched_summary": "components catalogued, tokens captured, anti-pattern identifiers"
-    },
-    "guidelines": {
-      "fetch_status": "fetched|skipped|not_applicable",
-      "accessMethod": "...",
-      "fetched_summary": "rule categories captured (CSS, accessibility, i18n, etc.)"
-    },
-    "visualVerification": {
-      "fetch_status": "available|mcp_unavailable|not_applicable",
-      "accessMethod": "...",
-      "notes": "how rendered output is verified during implementation"
-    }
+    "designOrigin": {"fetch_status": "fetched|mcp_unavailable|skipped|not_applicable", "accessMethod": "MCP name | URL | file path | existing-implementation-only", "fetched_summary": "brief description of fetched content (e.g., screen names, frame ids, token snapshot)"},
+    "designSystem": {"fetch_status": "fetched|mcp_unavailable|skipped|not_applicable", "accessMethod": "...", "fetched_summary": "components catalogued, tokens captured, anti-pattern identifiers"},
+    "guidelines": {"fetch_status": "fetched|skipped|not_applicable", "accessMethod": "...", "fetched_summary": "rule categories captured (CSS, accessibility, i18n, etc.)"},
+    "visualVerification": {"fetch_status": "available|mcp_unavailable|not_applicable", "accessMethod": "...", "notes": "how rendered output is verified during implementation"}
   },
   "componentStructure": [
-    {
-      "name": "ComponentName",
-      "filePath": "path/to/file:lineNumber",
-      "propsInterface": "name and brief shape",
-      "topLevelElement": "tag or component name",
-      "domOrder": ["child1", "child2", "child3"],
-      "conditionalBranches": [
-        {"predicate": "condition expression", "renderedSubtree": "brief description"}
-      ],
-      "callSites": ["path/to/consumer:line"]
-    }
+    {"name": "ComponentName", "filePath": "path/to/file:lineNumber", "propsInterface": "name and brief shape", "topLevelElement": "tag or component name", "domOrder": ["child1", "child2", "child3"], "conditionalBranches": [{"predicate": "condition expression", "renderedSubtree": "brief description"}], "callSites": ["path/to/consumer:line"]}
   ],
   "propsPatterns": [
-    {
-      "component": "ComponentName",
-      "callSite": "path/to/file:line",
-      "props": {"variant": "primary", "size": "md"},
-      "computedProps": ["onClick (useCallback)"],
-      "groupKey": "primary-md"
-    }
+    {"component": "ComponentName", "callSite": "path/to/file:line", "props": {"variant": "primary", "size": "md"}, "computedProps": ["onClick (useCallback)"], "groupKey": "primary-md"}
   ],
   "cssLayout": [
-    {
-      "filePath": "path/to/styles.module.css",
-      "classNamingConvention": "camelCase|kebab-case|BEM",
-      "baseClass": "root",
-      "layouts": [
-        {
-          "selector": ".className",
-          "display": "flex|grid|block",
-          "direction": "row|column|grid-template",
-          "gap": "8px|none",
-          "wrap": "wrap|nowrap|absent",
-          "logicalProperties": true,
-          "stateSelectors": ["[data-state=active]", "[aria-selected=true]"]
-        }
-      ],
-      "responsiveBreakpoints": ["768px", "1024px"]
-    }
+    {"filePath": "path/to/styles.module.css", "classNamingConvention": "camelCase|kebab-case|BEM", "baseClass": "root", "layouts": [{"selector": ".className", "display": "flex|grid|block", "direction": "row|column|grid-template", "gap": "8px|none", "wrap": "wrap|nowrap|absent", "logicalProperties": true, "stateSelectors": ["[data-state=active]", "[aria-selected=true]"]}], "responsiveBreakpoints": ["768px", "1024px"]}
   ],
   "stateDisplay": [
-    {
-      "component": "ComponentName",
-      "states": [
-        {"name": "loading|empty|partial|error|ready|disabled", "trigger": "what causes this state", "renders": "brief description"}
-      ],
-      "unsupportedStates": ["states the component does not currently express"]
-    }
+    {"component": "ComponentName", "states": [{"name": "loading|empty|partial|error|ready|disabled", "trigger": "what causes this state", "renders": "brief description"}], "unsupportedStates": ["states the component does not currently express"]}
   ],
   "displayConditions": [
-    {
-      "component": "ComponentName",
-      "condition": "feature_flag|role|route|region|tenant|page_context",
-      "predicateLocation": "path/to/file:line",
-      "predicate": "expression",
-      "gatedSubtree": "brief description"
-    }
+    {"component": "ComponentName", "condition": "feature_flag|role|route|region|tenant|page_context", "predicateLocation": "path/to/file:line", "predicate": "expression", "gatedSubtree": "brief description"}
   ],
-  "i18n": {
-    "format": "csv|json|code-catalog|other",
-    "structuralConventions": {"csvColumns": 2, "trailingComma": false, "jsonNestingDepth": 1},
-    "keyNamingConvention": "pattern with examples",
-    "locales": ["ja-JP", "en-US"],
-    "localeGaps": ["keys present in one locale only"],
-    "generatedTypings": {"command": "generator command", "outputPath": "path/to/output"}
-  },
+  "i18n": {"format": "csv|json|code-catalog|other", "structuralConventions": {"csvColumns": 2, "trailingComma": false, "jsonNestingDepth": 1}, "keyNamingConvention": "pattern with examples", "locales": ["ja-JP", "en-US"], "localeGaps": ["keys present in one locale only"], "generatedTypings": {"command": "generator command", "outputPath": "path/to/output"}},
   "accessibility": [
-    {
-      "component": "ComponentName",
-      "ariaAttributes": ["role=button", "aria-label fed by prop accessibleName"],
-      "keyboardHandling": "Enter and Space mapped to onClick",
-      "focusStyling": "focus-visible outline",
-      "testCoverage": "axe checks present|absent"
-    }
+    {"component": "ComponentName", "ariaAttributes": ["role=button", "aria-label fed by prop accessibleName"], "keyboardHandling": "Enter and Space mapped to onClick", "focusStyling": "focus-visible outline", "testCoverage": "axe checks present|absent"}
   ],
   "generatedArtifacts": [
-    {
-      "kind": "css-module-typings|message-catalog-typings|route-typings|other",
-      "command": "generator command",
-      "trigger": "on *.module.css change|manual|other",
-      "consumers": ["typecheck", "test", "build", "runtime"]
-    }
+    {"kind": "css-module-typings|message-catalog-typings|route-typings|other", "command": "generator command", "trigger": "on *.module.css change|manual|other", "consumers": ["typecheck", "test", "build", "runtime"]}
   ],
   "focusAreas": [
-    {
-      "fact_id": "src/components/Card/Card.tsx:Card",
-      "area": "Brief UI area name",
-      "evidence": "componentStructure[name=Card] | cssLayout[selector=.root] | propsPatterns[groupKey=...] | externalResources.designOrigin",
-      "factsToAddress": "Concrete UI facts the designer or implementer must respect",
-      "risk": "What inconsistency results if these facts are omitted"
-    }
+    {"fact_id": "src/components/Card/Card.tsx:Card", "area": "Brief UI area name", "evidence": "componentStructure[name=Card] | cssLayout[selector=.root] | propsPatterns[groupKey=...] | externalResources.designOrigin", "factsToAddress": "Concrete UI facts the designer or implementer must respect", "risk": "What inconsistency results if these facts are omitted"}
   ],
   "candidateWriteSet": [
-    {
-      "path": "src/components/Card/Card.tsx",
-      "reasonRef": "focusAreas[fact_id=src/components/Card/Card.tsx:Card]",
-      "confidence": "high|medium|low"
-    }
+    {"path": "src/components/Card/Card.tsx", "reasonRef": "focusAreas[fact_id=src/components/Card/Card.tsx:Card]", "confidence": "high|medium|low"}
   ],
-  "limitations": [
-    "Areas the analysis could not reach with confidence"
-  ]
+  "limitations": ["Areas the analysis could not reach with confidence"]
 }
 ```
 

package/.claude/agents-ja/verifier.md

@@ -61,7 +61,8 @@ skills: project-context, technical-spec, coding-standards
 
 1. **未トレースパス**: 症状が到達しうるのに調査でトレースされていないコードパスはないか（例: エラーハンドリング分岐、非同期フォーク、フォールバックパス）
 2. **未チェックノード**: トレース済みパス上でチェックされていないノードはないか
-3. **追加の障害点**: 未トレースパスや未チェックノードから新たな障害が見つかった場合は記録する
+3. **隣接ケース**: 調査が `bug-fix` / `regression` / `state-change` / `boundary-change` に関わる場合（デバッグフローには Change Category フィールドが無いため、調査自体から判断する）、同一の経路・契約・永続状態・外部境界を共有し同じ障害を抱えうるケースはないか。妥当な隣接ケースをすべてトレースするか、トレースしないものは明示的に正当化する
+4. **追加の障害点**: 未トレースパス・未チェックノード・隣接ケースから新たな障害が見つかった場合は記録する
 
 目的は、調査のパスカバレッジが十分であるかを検証すること。
 
@@ -115,78 +116,33 @@ skills: project-context, technical-spec, coding-standards
     "identifiedGaps": ["未トレースパスや未チェックノード"]
   },
   "triangulationSupplements": [
-    {
-      "source": "追加で調査した情報源",
-      "findings": "発見した内容",
-      "impactOnFailurePoints": "既存の障害点への影響"
-    }
+    {"source": "追加で調査した情報源", "findings": "発見した内容", "impactOnFailurePoints": "既存の障害点への影響"}
   ],
   "externalResearch": [
-    {
-      "query": "検索したクエリ",
-      "source": "情報源",
-      "findings": "発見した関連情報",
-      "impactOnFailurePoints": "障害点への影響"
-    }
+    {"query": "検索したクエリ", "source": "情報源", "findings": "発見した関連情報", "impactOnFailurePoints": "障害点への影響"}
   ],
   "coverageCheck": {
     "missingPaths": ["調査入力でトレースされていないパス"],
     "uncheckedNodes": ["トレース済みパス上の未チェックノード"],
     "additionalFailurePoints": [
-      {
-        "id": "AFP1",
-        "nodeId": "ノード参照",
-        "symptomId": "症状参照",
-        "description": "新たに発見された障害",
-        "checkStatus": "supported|weakened|blocked|not_reached",
-        "evidence": [
-          {"type": "supporting", "detail": "証拠の詳細", "source": "file:line"}
-        ]
-      }
+      {"id": "AFP1", "nodeId": "ノード参照", "symptomId": "症状参照", "description": "新たに発見された障害", "checkStatus": "supported|weakened|blocked|not_reached", "evidence": [{"type": "supporting", "detail": "証拠の詳細", "source": "file:line"}]}
     ]
   },
   "devilsAdvocateFindings": [
-    {
-      "targetFailurePoint": "FP1",
-      "alternativeExplanation": "正常な動作である可能性は？",
-      "hiddenAssumptions": ["暗黙の前提"],
-      "potentialCounterEvidence": ["見落とされている可能性のある反証"]
-    }
+    {"targetFailurePoint": "FP1", "alternativeExplanation": "正常な動作である可能性は？", "hiddenAssumptions": ["暗黙の前提"], "potentialCounterEvidence": ["見落とされている可能性のある反証"]}
   ],
   "failurePointEvaluation": [
-    {
-      "failurePointId": "FP1またはAFP1",
-      "description": "障害点の記述",
-      "originalCheckStatus": "調査入力のcheckStatus（検証段階で発見されたAFPはnull）",
-      "finalStatus": "supported|weakened|blocked|not_reached",
-      "statusChangeReason": "ステータスが変更された理由（変更があった場合）",
-      "remainingUncertainty": ["残る不確実性"]
-    }
+    {"failurePointId": "FP1またはAFP1", "description": "障害点の記述", "originalCheckStatus": "調査入力のcheckStatus（検証段階で発見されたAFPはnull）", "finalStatus": "supported|weakened|blocked|not_reached", "statusChangeReason": "ステータスが変更された理由（変更があった場合）", "remainingUncertainty": ["残る不確実性"]}
   ],
   "conclusion": {
     "confirmedFailurePoints": [
-      {
-        "failurePointId": "FP1",
-        "description": "障害の内容",
-        "location": "file:line",
-        "symptomId": "S1",
-        "symptomExplained": "この障害が観察された症状にどうつながるか",
-        "causeCategory": "typo|logic_error|missing_constraint|design_gap|external_factor",
-        "finalStatus": "supported|weakened",
-        "causalChain": ["現象", "→ 直接原因", "→ 根本原因"],
-        "impactScope": ["影響を受けるファイルパス"],
-        "recurrenceRisk": "low|medium|high"
-      }
+      {"failurePointId": "FP1", "description": "障害の内容", "location": "file:line", "symptomId": "S1", "symptomExplained": "この障害が観察された症状にどうつながるか", "causeCategory": "typo|logic_error|missing_constraint|design_gap|external_factor", "finalStatus": "supported|weakened", "causalChain": ["現象", "→ 直接原因", "→ 根本原因"], "impactScope": ["影響を受けるファイルパス"], "recurrenceRisk": "low|medium|high"}
     ],
     "refutedFailurePoints": [
       {"failurePointId": "FP2", "reason": "反証された理由"}
     ],
     "failurePointRelationships": [
-      {
-        "points": ["FP1", "FP3"],
-        "relationship": "independent|dependent|same_chain",
-        "detail": "障害点間の関係の説明"
-      }
+      {"points": ["FP1", "FP3"], "relationship": "independent|dependent|same_chain", "detail": "障害点間の関係の説明"}
     ],
     "coverageAssessment": "sufficient|partial|insufficient",
     "unresolvedSymptoms": ["確認された障害点で完全に説明できない症状"],

package/.claude/skills-en/documentation-criteria/references/plan-template.md

@@ -212,7 +212,7 @@ This phase is required for ALL implementation approaches.
 - [ ] Security review: Verify security considerations from Design Doc are implemented
 - [ ] Quality checks (types, lint, format)
 - [ ] Execute all tests (including integration/E2E from test skeletons, when provided)
-- [ ] Coverage 70%+
+- [ ] Coverage reviewed as a gap signal on critical paths (any enforced threshold per project CI config)
 - [ ] Document updates
 
 ### Quality Assurance

package/.claude/skills-en/documentation-criteria/references/task-template.md

@@ -17,6 +17,13 @@ Metadata:
 Files to read before starting implementation (file path, with optional search hint):
 - [e.g., src/orders/checkout (processOrder function) — determined during task decomposition based on task nature]
 
+## Change Category
+(Include this field only when the task is a bug fix, regression, state-change, or boundary-change — populated during task decomposition. Omit otherwise.)
+
+`Change Category: <one or more of bug-fix, regression, state-change, boundary-change — comma-separated>`
+
+When present, the implementation sweeps the cases sharing the same path, contract, persisted state, or external boundary for the same class of defect (see Implementation Steps Red Phase).
+
 ## Binding Decisions
 (Include this section when the work plan's ADR Bindings table covers this task. Omit otherwise.)
 
@@ -32,6 +39,7 @@ Each row is an ADR decision the implementation in this task must comply with.
 ## Implementation Steps (TDD: Red-Green-Refactor)
 ### 1. Red Phase
 - [ ] Read all Investigation Targets and record key observations
+- [ ] (When Change Category is set) Sweep the adjacent cases sharing the same path/contract/state/boundary for the same class of defect; fold any found within scope into the failing tests
 - [ ] Review dependency deliverables (if any)
 - [ ] Verify/create contract definitions
 - [ ] Write failing tests

package/.claude/skills-en/frontend-technical-spec/SKILL.md

@@ -133,14 +133,10 @@ Quality checks are mandatory upon implementation completion:
 - `test:coverage:fresh` - Coverage measurement
 - `check:all` - Overall integrated check
 
-### Coverage Requirements
-- **Mandatory**: Unit test coverage must be 60% or higher
-- **Component-specific targets**:
-  - Atoms: 70% or higher
-  - Molecules: 65% or higher
-  - Organisms: 60% or higher
-  - Custom Hooks: 65% or higher
-  - Utils: 70% or higher
+### Coverage
+- Treat coverage as a diagnostic signal for finding untested areas, not a target (a target gets gamed into trivial tests — Goodhart's Law)
+- Concentrate test rigor on foundational, high-reuse units (shared components, custom hooks, utils) whose regression has the widest blast radius; higher-composition surfaces (organisms, pages) lean on integration/E2E coverage instead
+- Any enforced numeric threshold is the project's CI/coverage config, not a goal in itself
 
 ### Non-functional Requirements
 - **Browser Compatibility**: Chrome/Firefox/Safari/Edge (latest 2 versions)

package/.claude/skills-en/frontend-typescript-rules/SKILL.md

@@ -34,6 +34,7 @@ const user = raw // narrowed to User
 - **Custom hooks** are the unit of logic reuse and dependency injection (inject collaborators through the hook for testability).
 - **Function parameters:** 0-2 positional; for 3+ take a single options object.
 - **State shape:** type state explicitly; for multi-field state with discrete transitions, use `useReducer` with a discriminated-union action type rather than many `useState` calls.
+- **Server/Client boundary** (RSC frameworks only — e.g. Next.js App Router): default to server components for data fetching/rendering and isolate interactivity behind a `"use client"` boundary at the smallest scope that needs it; keep browser-only APIs (`window`, `localStorage`, event handlers) inside client components, since calling them in a server component breaks the render. N/A for client-only SPAs (e.g. Vite) — skip when the project has no server-component runtime.
 
 ## Error Handling
 - Surface every error: log and handle, or propagate — never swallow.
@@ -41,6 +42,7 @@ const user = raw // narrowed to User
 - Represent expected failures as values with a `Result` type; reserve `throw` for unexpected/unrecoverable cases.
 - Use purpose-specific error classes extending a base `AppError` carrying a `code` (e.g. ValidationError, ApiError, NotFoundError).
 - **Layer responsibilities:** the API layer converts transport errors into domain errors; hooks propagate `AppError` upward; an Error Boundary catches render-time errors and shows fallback UI.
+- **Effect race/cleanup:** guard `useEffect` data fetches against out-of-order responses and post-unmount state updates — abort or ignore stale results (`AbortController` or a mounted flag), or use a server-state library (React Query/SWR) that cancels and dedupes. `try-catch` alone does not cover this.
 - Never log secrets (password, token, apiKey, creditCard).
 
 ```typescript
@@ -63,8 +65,8 @@ class ErrorBoundary extends React.Component<{ children: React.ReactNode; fallbac
 ```
 
 ## Project Conventions
-- **Environment variables:** read through the build tool's env system (`process.env` is absent in the browser). Keep all secrets server-side — frontend code ships to the client.
-- **Bundle & performance:** monitor with the `build` script, keep under 500KB; memoize expensive components (`React.memo`); code-split with `React.lazy` + `Suspense`; structure state to minimize re-renders.
+- **Environment variables:** read client-side env through the bundler's exposed accessor — only vars carrying its public prefix reach the browser; an unprefixed var is `undefined` there. Match the project's bundler: Vite `import.meta.env.VITE_*`, Next.js public `process.env.NEXT_PUBLIC_*`, CRA `process.env.REACT_APP_*`. Keep all secrets server-side — frontend code ships to the client.
+- **Bundle & performance:** monitor bundle size with the `build` script against the project's budget; code-split with `React.lazy` + `Suspense`; structure state to minimize re-renders. Memoization: when React Compiler is enabled, rely on it; reach for manual `React.memo`/`useMemo`/`useCallback` only as a profiler- or identity-justified escape hatch (a measured bottleneck, or stable reference identity for third-party APIs / effect dependencies).
 - **Naming:** components/types `PascalCase`; variables/functions `camelCase`; hooks `use`-prefixed; constants `SCREAMING_SNAKE_CASE`.
 - **Imports:** absolute paths from `src/`; order: React → external libs → internal (absolute) → internal (relative) → type-only → styles/assets.
 - **Formatting:** follow Biome (semicolons and style come from project config).

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

@@ -24,21 +24,15 @@ description: Designs tests with React Testing Library, MSW, and Playwright E2E.
 ## Basic Testing Policy
 
 ### Quality Requirements
-- **Coverage**: Unit test coverage must be 60% or higher (Frontend standard 2025)
+- **Coverage**: prioritize meaningful assertions on critical paths and high-reuse components; treat coverage as a signal for gaps, not a target (a target gets gamed into trivial tests — Goodhart's Law). Any numeric threshold is the project's CI config
 - **Independence**: Each test can run independently without depending on other tests
 - **Reproducibility**: Tests are environment-independent and always return the same results
 - **Readability**: Test code maintains the same quality as production code
 
-### Coverage Requirements (ADR-0002 Compliant)
-**Mandatory**: Unit test coverage must be 60% or higher
-**Component-specific targets**:
-- Atoms (Button, Text, etc.): 70% or higher
-- Molecules (FormField, etc.): 65% or higher
-- Organisms (Header, Footer, etc.): 60% or higher
-- Custom Hooks: 65% or higher
-- Utils: 70% or higher
+### Where to concentrate test rigor
+Test foundational, high-reuse units the hardest — shared components, custom hooks, and utils reused across many features carry the widest blast radius. Higher-composition surfaces (organisms, pages) lean on integration/E2E coverage instead. Any numeric threshold is the project's CI config.
 
-**Metrics**: Statements, Branches, Functions, Lines
+**Metrics** (what coverage reports break down): Statements, Branches, Functions, Lines
 
 ### Test Types and Scope
 1. **Unit Tests (React Testing Library)**
@@ -74,7 +68,7 @@ src/
 
 **Rationale**:
 - React Testing Library best practice
-- ADR-0002 Co-location principle
+- Co-location principle: tests live alongside the implementation they cover
 - Easy to find and maintain tests alongside implementation
 
 ### Naming Conventions

package/.claude/skills-en/technical-spec/SKILL.md

@@ -92,6 +92,7 @@ Quality checks are mandatory upon implementation completion:
 - **Cache issues**: Run the `test:coverage:fresh` script
 - **Dependency errors**: Clean reinstall dependencies
 
-### Coverage Requirements
-- **MANDATORY**: Unit test coverage MUST be 70% or higher
-- **Metrics**: Statements, Branches, Functions, Lines
+### Coverage
+- Treat coverage as a diagnostic signal for finding untested areas, not a target (a target gets gamed into trivial tests — Goodhart's Law). Concentrate tests on critical paths and business logic whose regression would matter
+- Any enforced numeric threshold is the project's CI/coverage config, not a goal in itself
+- **Metrics** (what coverage reports break down): Statements, Branches, Functions, Lines

package/.claude/skills-en/typescript-testing/SKILL.md

@@ -14,14 +14,14 @@ description: Applies Vitest test design and quality standards. Provides coverage
 ## Basic Testing Policy
 
 ### Quality Requirements
-- **Coverage**: Unit test coverage must be 70% or higher
+- **Coverage**: treat coverage as a diagnostic signal for finding untested areas, not a target (a target gets gamed into trivial tests — Goodhart's Law). Concentrate tests on critical paths, business logic, and behavior whose regression would matter. Any numeric threshold is the project's CI config
 - **Independence**: Each test can run independently without depending on other tests
 - **Reproducibility**: Tests are environment-independent and always return the same results
 - **Readability**: Test code maintains the same quality as production code
 
-### Coverage Requirements
-**Mandatory**: Unit test coverage must be 70% or higher
-**Metrics**: Statements, Branches, Functions, Lines
+### Coverage
+- Prioritize meaningful assertions over the coverage number; raise coverage where a gap leaves a real regression unguarded, not to hit a percentage
+- **Metrics** (what coverage reports break down): Statements, Branches, Functions, Lines
 
 ### Test Types and Scope
 1. **Unit Tests**

package/.claude/skills-ja/documentation-criteria/references/plan-template.md

@@ -212,7 +212,7 @@ Design Docの実装アプローチに基づいてフェーズ構成をひとつ
 - [ ] セキュリティレビュー: Design Docのセキュリティ考慮事項が実装されていることを確認
 - [ ] 品質チェック（型、lint、format）
 - [ ] 全テスト実行（テストスケルトン提供時は統合/E2Eテスト含む）
-- [ ] カバレッジ70%以上
+- [ ] クリティカルパスのギャップシグナルとしてカバレッジを確認（強制しきい値はプロジェクトの CI 設定に従う）
 - [ ] ドキュメント更新
 
 ### 品質保証

package/.claude/skills-ja/documentation-criteria/references/task-template.md

@@ -17,6 +17,13 @@ Metadata:
 実装開始前に読むべきファイル（ファイルパス、任意でサーチヒント付き）:
 - [例: src/orders/checkout (processOrder関数) — タスクの性質に基づきタスク分解時に決定]
 
+## Change Category
+（タスクがバグ修正・リグレッション・状態変更・境界変更の場合のみ本フィールドを記載する — タスク分解時に設定。それ以外は省略する。）
+
+`Change Category: <bug-fix, regression, state-change, boundary-change のうち該当するものをカンマ区切りで>`
+
+記載がある場合、実装は同一の経路・契約・永続状態・外部境界を共有するケースを、同一クラスの欠陥について走査する（Implementation Steps の Red Phase 参照）。
+
 ## Binding Decisions
 （作業計画書のADR Bindings表がこのタスクをカバーする場合に本セクションを記載する。それ以外は省略する。）
 
@@ -32,6 +39,7 @@ Metadata:
 ## Implementation Steps (TDD: Red-Green-Refactor)
 ### 1. Red Phase
 - [ ] 全ての Investigation Targets を読み、主要な所見を記録
+- [ ] （Change Category が設定されている場合）同一の経路/契約/状態/境界を共有する隣接ケースを同一クラスの欠陥について走査し、スコープ内で見つかったものを失敗するテストに取り込む
 - [ ] Dependencies の成果物を確認（ある場合）
 - [ ] 契約定義を確認・作成
 - [ ] 失敗するテストを書く

package/.claude/skills-ja/frontend-technical-spec/SKILL.md

@@ -133,14 +133,10 @@ package.jsonの`packageManager`フィールドに応じた実行コマンドを
 - `test:coverage:fresh` - カバレッジ測定
 - `check:all` - 全体統合チェック
 
-### カバレッジ要件
-- **必須**: 単体テストのカバレッジは60%以上
-- **コンポーネント別目標**:
-  - Atoms: 70%以上
-  - Molecules: 65%以上
-  - Organisms: 60%以上
-  - Custom Hooks: 65%以上
-  - Utils: 70%以上
+### カバレッジ
+- カバレッジは目標ではなく未テスト領域を見つける診断シグナルとして扱う（目標化すると自明なテストに歪む — グッドハートの法則）
+- 基盤的で再利用度の高いユニット（共有コンポーネント、カスタムフック、utils）にテストの重点を置く — リグレッション時の影響範囲が最も広い。合成度の高い面（organisms、ページ）は統合/E2Eのカバレッジに委ねる
+- 強制する数値しきい値はプロジェクトの CI / カバレッジ設定であり、それ自体が目的ではない
 
 ### 非機能要件
 - **ブラウザ互換性**: Chrome/Firefox/Safari/Edge（最新2バージョン）

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

@@ -34,6 +34,7 @@ const user = raw // User に絞り込み済み
 - **Custom hook** をロジック再利用と依存注入の単位とする（テスト容易性のため、協調オブジェクトは hook 経由で注入する）。
 - **関数引数:** 位置引数は 0〜2 個。3 個以上は単一の options オブジェクトで受ける。
 - **状態の形:** 状態は明示的に型付けする。複数フィールドかつ離散的な遷移を持つ状態は、複数の `useState` ではなく discriminated union の action 型を用いた `useReducer` にする。
+- **Server/Client 境界**（RSC フレームワークのみ — 例: Next.js App Router）: データ取得とレンダリングは既定でサーバーコンポーネントに置き、インタラクティブ性は必要最小のスコープで `"use client"` 境界の内側に隔離する。ブラウザ専用 API（`window`、`localStorage`、イベントハンドラ）はクライアントコンポーネント内に留める — サーバーコンポーネントで呼ぶとレンダリングが壊れる。クライアントのみの SPA（例: Vite）では N/A — サーバーコンポーネントランタイムが無いプロジェクトではスキップする。
 
 ## エラーハンドリング
 - すべてのエラーを表に出す: ログして処理するか伝播する — 握り潰さない。
@@ -41,6 +42,7 @@ const user = raw // User に絞り込み済み
 - 想定内の失敗は `Result` 型で値として表現する。`throw` は想定外/回復不能なケースに限る。
 - 目的別のエラークラスは `code` を持つ基底 `AppError` を継承する（例: ValidationError, ApiError, NotFoundError）。
 - **層の責務:** API 層は transport エラーをドメインエラーへ変換する。hook は `AppError` を上位へ伝播する。Error Boundary はレンダリング時のエラーを捕捉しフォールバック UI を表示する。
+- **Effect の競合/クリーンアップ:** `useEffect` 内のデータ取得は、順序が入れ替わった応答とアンマウント後の状態更新に対してガードする — `AbortController` か mounted フラグで stale な結果を中断・無視するか、キャンセルと重複排除を行うサーバー状態ライブラリ（React Query/SWR）を使う。`try-catch` だけではこれをカバーできない。
 - 機微情報（password, token, apiKey, creditCard）をログに出さない。
 
 ```typescript
@@ -63,8 +65,8 @@ class ErrorBoundary extends React.Component<{ children: React.ReactNode; fallbac
 ```
 
 ## プロジェクト規約
-- **環境変数:** ビルドツールの環境変数システム経由で読む（ブラウザに `process.env` は存在しない）。秘密情報はすべてサーバーサイドに置く — フロントエンドのコードはクライアントに配信される。
-- **バンドルとパフォーマンス:** `build` スクリプトで監視し 500KB 未満に保つ。高コストなコンポーネントは `React.memo` でメモ化する。`React.lazy` + `Suspense` でコード分割する。再レンダリングを最小化する状態構造にする。
+- **環境変数:** クライアント側の環境変数はバンドラが公開するアクセサ経由で読む — 公開プレフィックスを持つ変数だけがブラウザに届き、プレフィックスの無い変数はブラウザでは `undefined` になる。プロジェクトのバンドラに合わせる: Vite は `import.meta.env.VITE_*`、Next.js の公開変数は `process.env.NEXT_PUBLIC_*`、CRA は `process.env.REACT_APP_*`。秘密情報はすべてサーバーサイドに置く — フロントエンドのコードはクライアントに配信される。
+- **バンドルとパフォーマンス:** バンドルサイズは `build` スクリプトでプロジェクトの予算に対して監視する。`React.lazy` + `Suspense` でコード分割する。再レンダリングを最小化する状態構造にする。メモ化: React Compiler が有効なときはそれに任せる。手動の `React.memo`/`useMemo`/`useCallback` は、プロファイラまたは参照同一性で正当化される逃げ道としてのみ用いる（実測されたボトルネック、またはサードパーティ API や effect 依存に対する安定した参照同一性）。
 - **命名:** コンポーネント/型は `PascalCase`、変数/関数は `camelCase`、hook は `use` 接頭辞、定数は `SCREAMING_SNAKE_CASE`。
 - **インポート:** `src/` からの絶対パス。順序: React → 外部ライブラリ → 内部（絶対）→ 内部（相対）→ 型のみ → スタイル/アセット。
 - **フォーマット:** Biome に従う（セミコロンやスタイルはプロジェクト設定に従う）。

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

@@ -24,21 +24,15 @@ description: React Testing Library、MSW、Playwright E2Eでテストを設計
 ## テストの基本方針
 
 ### 品質要件
-- **カバレッジ**: 単体テストのカバレッジは60%以上を必須（フロントエンド標準 2025）
+- **カバレッジ**: クリティカルパスと高再利用コンポーネントに対する意味のあるアサーションを優先する。カバレッジは目標ではなくギャップ検出のシグナルとして扱う（目標化すると自明なテストに歪む — グッドハートの法則）。数値しきい値はプロジェクトの CI 設定に委ねる
 - **独立性**: 各テストは他のテストに依存せず実行可能
 - **再現性**: テストは環境に依存せず、常に同じ結果を返す
 - **可読性**: テストコードも製品コードと同様の品質を維持
 
-### カバレッジ要件
-**必須**: 単体テストのカバレッジは60%以上
-**コンポーネント別目標**:
-- Atoms（Button、Text等）: 70%以上
-- Molecules（FormField等）: 65%以上
-- Organisms（Header、Footer等）: 60%以上
-- Custom Hooks: 65%以上
-- Utils: 70%以上
+### テストの重点配分
+基盤的で再利用度の高いユニット（共有コンポーネント、カスタムフック、utils）を最も厚くテストする — 多くの機能から再利用されるものほど、リグレッション時の影響範囲が広い。合成度の高い面（organisms、ページ）は統合/E2Eのカバレッジに委ねる。数値しきい値はプロジェクトの CI 設定に委ねる。
 
-**指標**: Statements（文）、Branches（分岐）、Functions（関数）、Lines（行）
+**指標**（カバレッジレポートの内訳）: Statements（文）、Branches（分岐）、Functions（関数）、Lines（行）
 
 ### テストの種類と範囲
 1. **単体テスト（React Testing Library）**
@@ -74,7 +68,7 @@ src/
 
 **理由**:
 - React Testing Libraryのベストプラクティス
-- ADR-0002 Co-location原則
+- Co-location原則: テストはそれがカバーする実装と同じ場所に置く
 - 実装と一緒にテストを見つけやすく、保守しやすい
 
 ### 命名規則

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

@@ -51,7 +51,7 @@ skills:
   typescript-testing:
     skill: "typescript-testing"
     tags: [quality, testing, coverage, vitest, backend, implementation]
-    typical-use: "バックエンドテスト作成、Vitest設定、70%カバレッジ要件、テスト品質基準"
+    typical-use: "バックエンドテスト作成、Vitest設定、カバレッジ方針、テスト品質基準"
     size: small
     key-references:
       - "Vitest公式ドキュメント"
@@ -200,12 +200,12 @@ skills:
   frontend-typescript-testing:
     skill: "frontend-typescript-testing"
     tags: [frontend, react, quality, testing, coverage, vitest, react-testing-library, msw, component-testing, implementation, playwright, e2e]
-    typical-use: "Reactコンポーネントのテスト作成、React Testing Library、MSW、60%カバレッジ要件、Co-location、Playwright E2Eテスト"
+    typical-use: "Reactコンポーネントのテスト作成、React Testing Library、MSW、カバレッジ方針、Co-location、Playwright E2Eテスト"
     size: small
     key-references:
       - "React Testing Library - Kent C. Dodds"
       - "MSW (Mock Service Worker) - API Mocking"
-      - "ADR-0002 Co-location原則"
+      - "Co-location原則"
       - "references/e2e.md - Playwright E2Eパターン"
     sections:
       - "参照"

package/.claude/skills-ja/technical-spec/SKILL.md

@@ -92,6 +92,7 @@ package.jsonの`packageManager`フィールドに応じた実行コマンドを
 - **キャッシュ問題**: `test:coverage:fresh` スクリプトを実行
 - **依存関係エラー**: 依存関係のクリーンインストールを実行
 
-### カバレッジ要件
-- **必須**: ユニットテストカバレッジは70%以上
-- **メトリクス**: Statements、Branches、Functions、Lines
+### カバレッジ
+- カバレッジは目標ではなく未テスト領域を見つける診断シグナルとして扱う（目標化すると自明なテストに歪む — グッドハートの法則）。クリティカルパスとビジネスロジックなど、リグレッションが問題になる箇所にテストを集中させる
+- 強制する数値しきい値はプロジェクトの CI / カバレッジ設定であり、それ自体が目的ではない
+- **メトリクス**（カバレッジレポートの内訳）: Statements、Branches、Functions、Lines

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

@@ -14,14 +14,14 @@ description: Vitestテスト設計と品質基準を適用。カバレッジ要
 ## テストの基本方針
 
 ### 品質要件
-- **カバレッジ**: 単体テストのカバレッジは70%以上を必須
+- **カバレッジ**: カバレッジは目標ではなく未テスト領域を見つける診断シグナルとして扱う（目標化すると自明なテストに歪む — グッドハートの法則）。クリティカルパス・ビジネスロジック・リグレッションが問題になる振る舞いにテストを集中させる。数値しきい値はプロジェクトの CI 設定に委ねる
 - **独立性**: 各テストは他のテストに依存せず実行可能
 - **再現性**: テストは環境に依存せず、常に同じ結果を返す
 - **可読性**: テストコードも製品コードと同様の品質を維持
 
-### カバレッジ要件
-**必須**: 単体テストのカバレッジは70%以上
-**指標**: Statements（文）、Branches（分岐）、Functions（関数）、Lines（行）
+### カバレッジ
+- カバレッジ数値よりも意味のあるアサーションを優先する。パーセンテージ達成のためではなく、ギャップが実際のリグレッションを無防備にしている箇所でカバレッジを上げる
+- **指標**（カバレッジレポートの内訳）: Statements（文）、Branches（分岐）、Functions（関数）、Lines（行）
 
 ### テストの種類と範囲
 1. **単体テスト（Unit Tests）**

package/CHANGELOG.md

@@ -5,6 +5,14 @@ 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.5] - 2026-06-14
+
+### Changed
+
+- **Adjacent-case sweep** (agents, skills) — bug-fix / regression / state-change / boundary-change tasks carry a `Change Category` that drives a scoped sweep of sibling cases sharing the change's path, contract, state, or boundary: `task-decomposer` extends Investigation Targets, `task-executor` / `-frontend` fold in-scope residuals into tests and escalate confirmed out-of-scope siblings, `code-reviewer` adds an `adjacent_residual` finding (with optional `taskFiles` input and a self-classification fallback), and `verifier` / `solver` trace adjacent cases. Applied across en/ja.
+- **Frontend rules modernization** (skills) — `frontend-typescript-rules` adopts bundler-agnostic env access (Vite / Next.js / CRA prefixes), React Compiler-aware memoization, a `useEffect` race/cleanup guard, RSC Server/Client boundary guidance, and a project-defined bundle budget in place of a fixed size.
+- **Coverage reframed as a signal** (agents, skills) — coverage is a diagnostic signal rather than a target (Goodhart's Law), with any threshold deferred to the project's CI config; removed an invented standard label and a dangling ADR reference across the testing/spec skills.
+
 ## [1.23.4] - 2026-06-09
 
 ### Changed