create-ai-project 1.24.0 → 1.24.1

package/.claude/skills-en/coding-standards/SKILL.md

@@ -33,7 +33,8 @@ Immediately stop and reconsider design when detecting the following patterns:
 
 ## Comment Writing Rules
 
-- **Function Description Focus**: Describe what the code "does"
+- **Code first**: Names, types, and structure are the primary medium; add a comment only when it carries what the code cannot express. When in doubt, improve the name instead of commenting
+- **Comment the "why", not the "what"**: Explain reasoning, trade-offs, constraints/edge cases, or public API contracts
 - **No Historical Information**: Do not record development history
 - **Timeless**: Write only content that remains valid whenever read
 - **Conciseness**: Keep explanations to necessary minimum

package/.claude/skills-en/documentation-criteria/SKILL.md

@@ -12,8 +12,8 @@ description: Guides PRD, ADR, Design Doc, UI Spec, and Work Plan creation. Use w
 | New Feature Addition (backend) | PRD -> [ADR] -> Design Doc -> Work Plan | After PRD approval |
 | New Feature Addition (frontend/fullstack) | PRD -> **UI Spec** -> [ADR] -> Design Doc -> Work Plan | UI Spec before Design Doc |
 | ADR Conditions Met (see below) | ADR -> Design Doc -> Work Plan | Start immediately |
-| 6+ Files | ADR -> Design Doc -> Work Plan (Required) | Start immediately |
-| 3-5 Files | Design Doc -> Work Plan (Recommended) | Start immediately |
+| 6+ Files | [ADR if conditions apply] -> Design Doc -> Work Plan (Design Doc + Work Plan required) | Start immediately |
+| 3-5 Files | Design Doc -> Work Plan (Required) | Start immediately |
 | 1-2 Files | None | Implementation cycle without work plan |
 
 ## ADR Creation Conditions (Required if Any Apply)
@@ -190,7 +190,7 @@ description: Guides PRD, ADR, Design Doc, UI Spec, and Work Plan creation. Use w
 `Proposed` -> `Accepted` -> `Deprecated`/`Superseded`/`Rejected`
 
 ## AI Automation Rules
-- 5+ files: Suggest ADR creation
+- 6+ files: Evaluate ADR Creation Conditions; suggest ADR only when a condition applies
 - Type/data flow change detected: ADR mandatory
 - Check existing ADRs before implementation
 

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

@@ -49,7 +49,7 @@ const response = await fetch('/api/data') // Backend handles API key authenticat
 ### Frontend Architecture Patterns
 
 **React Component Architecture**:
-- **Function Components**: Mandatory, class components deprecated
+- **Function Components**: Mandatory; class components allowed solely for Error Boundaries (no hook equivalent)
 - **Custom Hooks**: For logic reuse and dependency injection
 - **Component Hierarchy**: Atoms -> Molecules -> Organisms -> Templates -> Pages
 - **Props-driven**: Components receive all necessary data via props

package/.claude/skills-ja/coding-standards/SKILL.md

@@ -33,7 +33,8 @@ description: コードの品質問題、アンチパターン、可読性を検
 
 ## コメント記述ルール
 
-- **機能説明重視**: コードが「何をするか」を記述
+- **コードファースト**: 命名・型・構造を第一の表現手段とし、コードで表現できない情報を持つときだけコメントを書く。迷ったらコメントを足す前に命名を見直す
+- **「なぜ」を説明し「何を」は書かない**: 判断の理由、トレードオフ、制約・エッジケース、公開APIの契約を説明する
 - **履歴情報禁止**: 開発履歴は記載しない
 - **タイムレス**: いつ読んでも有効な内容のみ記述
 - **簡潔性**: 必要最小限の説明にとどめる

package/.claude/skills-ja/documentation-criteria/SKILL.md

@@ -12,8 +12,8 @@ description: PRD、ADR、Design Doc、UI Spec、作業計画書の作成を支
 | 新機能追加（バックエンド） | PRD → [ADR] → Design Doc → 作業計画書 | PRD承認後 |
 | 新機能追加（フロントエンド/フルスタック） | PRD → **UI Spec** → [ADR] → Design Doc → 作業計画書 | Design Doc前にUI Spec |
 | ADR条件該当（下記参照） | ADR → Design Doc → 作業計画書 | 即座に開始 |
-| 6ファイル以上 | ADR → Design Doc → 作業計画書（必須） | 即座に開始 |
-| 3-5ファイル | Design Doc → 作業計画書（推奨） | 即座に開始 |
+| 6ファイル以上 | [条件該当時はADR] → Design Doc → 作業計画書（Design Doc・作業計画書は必須） | 即座に開始 |
+| 3-5ファイル | Design Doc → 作業計画書（必須） | 即座に開始 |
 | 1-2ファイル | なし | 作業計画書なしの実装サイクル |
 
 ## ADR作成条件（いずれか該当で必須）
@@ -206,7 +206,7 @@ description: PRD、ADR、Design Doc、UI Spec、作業計画書の作成を支
 `Proposed` → `Accepted` → `Deprecated`/`Superseded`/`Rejected`
 
 ## AI自動化ルール
-- 5ファイル以上: ADR作成提案
+- 6ファイル以上: ADR作成条件を評価し、いずれかに該当する場合のみADR作成を提案
 - 型・データフロー変更検出: ADR必須化
 - 既存ADR確認してから実装
 

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

@@ -49,7 +49,7 @@ const response = await fetch('/api/data') // バックエンドがAPIキー認
 ### フロントエンドアーキテクチャパターン
 
 **Reactコンポーネントアーキテクチャ**:
-- **Function Components**: 必須、class componentsは非推奨
+- **Function Components**: 必須。class components は Error Boundary に限り許可（hook の代替が存在しないため）
 - **Custom Hooks**: ロジック再利用と依存性注入のため
 - **コンポーネント階層**: Atoms → Molecules → Organisms → Templates → Pages
 - **Props-driven**: コンポーネントは必要なすべてのデータをPropsで受け取る

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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.24.1] - 2026-06-21
+
+### Changed
+
+- **Skill rule consistency** (skills) — resolved conflicting rules across skills: aligned the ADR file-count matrix with the automation rule in `documentation-criteria`, unified the comment policy (code-first, comment the "why") between `coding-standards` and `typescript-rules`, and added the Error Boundary exception to the class-component rule in `frontend-technical-spec`. Applied across en/ja.
+
 ## [1.24.0] - 2026-06-18
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ai-project",
-  "version": "1.24.0",
+  "version": "1.24.1",
   "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": [