create-ai-project 1.11.2 → 1.12.1

package/CLAUDE.ja.md

@@ -26,8 +26,8 @@ AI実行精度最大化のための中核ルール。全ての指示はこのフ
 **実行ルール**：
 - `pending → in_progress`時: rule-advisorの出力が必須
 - **rule-advisor実行後**: 必ずTodoWriteを以下の形式で更新
-  1. firstActionGuidanceをTodoの先頭タスクとして追加
-  2. taskEssenceを各タスクの完了判断基準として記録
+  1. metaCognitiveGuidance.firstStepをTodoの先頭タスクとして追加
+  2. metaCognitiveGuidance.taskEssenceを各タスクの完了判断基準として記録
   3. warningPatternsを実行中の確認項目として記録
 - TodoWriteなしでEditツール使用: ルール違反として停止
 - 各タスクのステータス更新時: 実施内容の記録を必須化（空白不可）
@@ -55,15 +55,15 @@ AI実行精度最大化のための中核ルール。全ての指示はこのフ
    - 表面的な作業内容と根本目的の区別
    - 「quick fix」vs「proper solution」の判定
 
-2. **applicableRules（適用ルール）を確認**
-   - 選択されたルールが適切か判断
+2. **selectedSkills（適用スキル）を確認**
+   - 選択されたスキルが適切か判断
    - 必要なセクションを読み込む
 
-3. **pastFailurePatterns（過去の失敗）を認識**
+3. **metaCognitiveGuidance.pastFailures（過去の失敗）を認識**
    - 同じ失敗を繰り返さないよう注意
    - 提示された回避策を意識
 
-4. **firstAction（初動アクション）を実行**
+4. **metaCognitiveGuidance.firstStep（初動アクション）を実行**
    - 推奨されたツールから開始
    - 計画的に進める
 

package/CLAUDE.md

@@ -25,28 +25,28 @@ AI実行精度最大化のための中核ルール。全ての指示はこのフ
 ### TodoWriteとメタ認知の統合
 **実行ルール**：
 - `pending → in_progress`時: rule-advisorの出力が必須
-- **rule-advisor実行後**: 必ずTodoWriteを更新（タスク内容・優先度・分解粒度の見直し）
-  - taskEssenceに基づいてタスク説明を具体化
-  - firstActionGuidanceを最初のタスクに反映
-  - warningPatternsを考慮してタスクを再構成
+- **rule-advisor実行後**: 必ずTodoWriteを以下の形式で更新
+  1. metaCognitiveGuidance.firstStepをTodoの先頭タスクとして追加
+  2. metaCognitiveGuidance.taskEssenceを各タスクの完了判断基準として記録
+  3. warningPatternsを実行中の確認項目として記録
 - TodoWriteなしでEditツール使用: ルール違反として停止
 - 各タスクのステータス更新時: 実施内容の記録を必須化（空白不可）
 
 ### 実行前提条件
-1. **rule-advisorの出力** → JSONレスポンスが存在すること
+1. **rule-advisorエージェント実行(Taskツールで呼び出すこと)** → JSONレスポンスが存在すること
 2. **TodoWriteのタスク** → in_progressステータスが存在すること
 3. **ユーザー承認記録** → Edit/Write前に明示的承認があること
 4. **品質チェック結果** → エラー0でなければ完了不可
 
-### 禁止事項
-- **any型使用** → 型チェックエラーの原因
-  理由：型安全性を破壊し、実行時エラーを引き起こすため
-- **TodoWriteなしのEdit使用** → ルール違反
-  理由：タスク管理なしでは進捗追跡と品質保証ができないため
-- **承認なしEdit/Write/MultiEdit** → 承認待ちに移行
-  理由：最重要原則（調査OK、実装STOP）の違反を防ぐため
-- **品質エラー残存での完了宣言** → 完了条件を満たさない
-  理由：不完全なコードの混入を防ぐため
+### 必須の代替パターン
+- **any型の代わり** → unknown型と型ガードを使用
+  理由：型安全性を確保し、実行時エラーを防止するため
+- **Edit使用時** → 必ずTodoWriteでタスク管理を先行
+  理由：進捗追跡と品質保証を可能にするため
+- **Edit/Write/MultiEdit使用時** → ユーザー承認を取得してから実行
+  理由：最重要原則（調査OK、実装STOP）を遵守するため
+- **完了宣言時** → 品質チェックエラー0を確認してから宣言
+  理由：完全なコードのみをマージするため
 
 ## メタ認知実行（タスク開始時必須）
 
@@ -55,15 +55,15 @@ AI実行精度最大化のための中核ルール。全ての指示はこのフ
    - 表面的な作業内容と根本目的の区別
    - 「quick fix」vs「proper solution」の判定
 
-2. **applicableRules（適用ルール）を確認**
-   - 選択されたルールが適切か判断
+2. **selectedSkills（適用スキル）を確認**
+   - 選択されたスキルが適切か判断
    - 必要なセクションを読み込む
 
-3. **pastFailurePatterns（過去の失敗）を認識**
+3. **metaCognitiveGuidance.pastFailures（過去の失敗）を認識**
    - 同じ失敗を繰り返さないよう注意
    - 提示された回避策を意識
 
-4. **firstAction（初動アクション）を実行**
+4. **metaCognitiveGuidance.firstStep（初動アクション）を実行**
    - 推奨されたツールから開始
    - 計画的に進める
 
@@ -99,13 +99,4 @@ AI実行精度最大化のための中核ルール。全ての指示はこのフ
 - **同一ファイル3回編集**: リファクタリング検討の強制停止
 
 ### 一時ファイル作成ルール
-作業中ファイルは`tmp/`ディレクトリ使用。完了時削除。
-
-### 専門エージェント積極活用（PROACTIVELY）
-- **品質関連キーワード検出時**: プロジェクトタイプに応じたquality-fixer必須実行
-  - **Backend**: quality-fixer使用
-  - **Frontend**: quality-fixer-frontend使用（Lighthouse、Bundle size対応）
-  - 型エラー、ビルドエラー、lintエラー、フォーマット警告
-  - テスト失敗、品質チェック、検証タスク
-- **タスク開始時**: rule-advisor必須実行
-  - TodoWrite作成前に実行し、結果を反映
+作業中ファイルは`tmp/`ディレクトリ使用。完了時削除。

package/README.ja.md

@@ -16,14 +16,15 @@
 ## 📖 目次
 1. [クイックスタート（3ステップ）](#-クイックスタート3ステップ)
 2. [なぜサブエージェント？](#-なぜサブエージェント)
-3. [実プロジェクトの成果](#-実プロジェクトの成果)
-4. [ドキュメント＆ガイド](#-ドキュメントガイド)
-5. [スラッシュコマンド](#-スラッシュコマンド)
-6. [開発ワークフロー](#-claude-code-ワークフロー)
-7. [プロジェクト構成](#-プロジェクト構成)
-8. [パッケージマネージャーの設定](#-パッケージマネージャーの設定)
-9. [多言語対応](#-多言語対応)
-10. [よくある質問](#-よくある質問)
+3. [スキルシステム](#-スキルシステム)
+4. [実プロジェクトの成果](#-実プロジェクトの成果)
+5. [ドキュメント＆ガイド](#-ドキュメントガイド)
+6. [スラッシュコマンド](#-スラッシュコマンド)
+7. [開発ワークフロー](#-claude-code-ワークフロー)
+8. [プロジェクト構成](#-プロジェクト構成)
+9. [パッケージマネージャーの設定](#-パッケージマネージャーの設定)
+10. [多言語対応](#-多言語対応)
+11. [よくある質問](#-よくある質問)
 
 > **どれを使うべき？**
 > - **このボイラープレート**を使う → **Claude Code**で**TypeScript × サブエージェント**に最適化し、**精度を最大化**したい場合
@@ -69,6 +70,27 @@ claude                         # Claude Codeを起動
 
 *サブエージェントが連携してプロダクション品質のTypeScriptプロジェクトを構築する様子*
 
+## 🎨 スキルシステム
+
+このボイラープレートでは、自律的（Agentic）な実装ワークフローで用いられている原理原則を、日常のタスクにおいても必要に応じて参照できるようスキルとして提供しています。
+
+### 適用されるスキル
+
+| スキル | 目的 |
+|--------|------|
+| `coding-standards` | 汎用コーディング原則、アンチパターン、デバッグ |
+| `typescript-rules` | TypeScript型安全性、非同期パターン、リファクタリング |
+| `typescript-testing` | Vitest、TDD、カバレッジ要件 |
+| `documentation-criteria` | PRD、ADR、Design Doc基準 |
+| `technical-spec` | アーキテクチャ、環境設定、ビルドコマンド |
+| `implementation-approach` | 戦略パターン、タスク分解 |
+| `integration-e2e-testing` | 統合/E2Eテスト設計、ROIベース選択 |
+| `project-context` | プロジェクト固有の設定（カスタマイズ可能） |
+
+**フロントエンド専用スキル**も`frontend/`配下で利用可能（例：`frontend/typescript-rules`）。
+
+👉 [スキルの仕組みについて（Claude Code docs）](https://code.claude.com/docs/ja/skills)
+
 ## 🎯 実プロジェクトの成果
 
 ### [Sub agents MCP Server](https://github.com/shinpr/sub-agents-mcp)
@@ -136,9 +158,16 @@ graph LR
 ai-coding-project-boilerplate/
 ├── .claude/               # AIエージェント設定
 │   ├── agents/           # 専門サブエージェント定義
-│   └── commands/         # スラッシュコマンド定義
+│   ├── commands/         # スラッシュコマンド定義
+│   └── skills/           # 自動コンテキスト読み込み用スキル
+│       ├── coding-standards/
+│       ├── typescript-rules/
+│       ├── typescript-testing/
+│       ├── documentation-criteria/
+│       ├── technical-spec/
+│       ├── project-context/
+│       └── frontend/     # フロントエンド専用スキル
 ├── docs/
-│   ├── rules/            # 開発ルール＆パターン
 │   ├── guides/           # ユーザードキュメント
 │   ├── adr/              # アーキテクチャ決定
 │   ├── design/           # 設計ドキュメント

package/README.md

@@ -16,14 +16,15 @@
 ## 📖 Table of Contents
 1. [Quick Start (3 Steps)](#-quick-start-3-steps)
 2. [Why Sub Agents?](#-why-sub-agents)
-3. [Real Projects & Results](#-real-world-results)
-4. [Documentation & Guides](#-documentation--guides)
-5. [Slash Commands](#-slash-commands)
-6. [Development Workflow](#-claude-code-workflow)
-7. [Project Structure](#-project-structure)
-8. [Package Manager Configuration](#-package-manager-configuration)
-9. [Multilingual Support](#-multilingual-support)
-10. [FAQ](#-faq)
+3. [Skills System](#-skills-system)
+4. [Real Projects & Results](#-real-world-results)
+5. [Documentation & Guides](#-documentation--guides)
+6. [Slash Commands](#-slash-commands)
+7. [Development Workflow](#-claude-code-workflow)
+8. [Project Structure](#-project-structure)
+9. [Package Manager Configuration](#-package-manager-configuration)
+10. [Multilingual Support](#-multilingual-support)
+11. [FAQ](#-faq)
 
 > **Which one should you use?**
 > - **Use this Boilerplate** if you want to **maximize precision** with **TypeScript × Sub-agent** setup optimized for **Claude Code**.
@@ -69,6 +70,27 @@ Each agent focuses on one thing and does it well. No context exhaustion, no qual
 
 *Sub agents working together to build a production-ready TypeScript project*
 
+## 🎨 Skills System
+
+This boilerplate provides the principles used in agentic implementation workflows as skills, making them available for reference in everyday tasks as needed.
+
+### Applied Skills
+
+| Skill | Purpose |
+|-------|---------|
+| `coding-standards` | Universal coding principles, anti-patterns, debugging |
+| `typescript-rules` | TypeScript type safety, async patterns, refactoring |
+| `typescript-testing` | Vitest, TDD, coverage requirements |
+| `documentation-criteria` | PRD, ADR, Design Doc standards |
+| `technical-spec` | Architecture, environment, build commands |
+| `implementation-approach` | Strategy patterns, task decomposition |
+| `integration-e2e-testing` | Integration/E2E test design, ROI-based selection |
+| `project-context` | Project-specific configuration (customizable) |
+
+**Frontend-specific skills** are also available under `frontend/` (e.g., `frontend/typescript-rules`).
+
+👉 [Learn how Skills work (Claude Code docs)](https://code.claude.com/docs/en/skills)
+
 ## 🎯 Real-World Results
 
 ### ⏱️ Time Comparison
@@ -142,9 +164,16 @@ graph LR
 ai-coding-project-boilerplate/
 ├── .claude/               # AI agent configurations
 │   ├── agents/           # Specialized sub-agent definitions
-│   └── commands/         # Slash command definitions
+│   ├── commands/         # Slash command definitions
+│   └── skills/           # Skills for automatic context loading
+│       ├── coding-standards/
+│       ├── typescript-rules/
+│       ├── typescript-testing/
+│       ├── documentation-criteria/
+│       ├── technical-spec/
+│       ├── project-context/
+│       └── frontend/     # Frontend-specific skills
 ├── docs/
-│   ├── rules/            # Development rules & patterns
 │   ├── guides/           # User documentation
 │   ├── adr/              # Architecture decisions
 │   ├── design/           # Design documents

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ai-project",
-  "version": "1.11.2",
+  "version": "1.12.1",
   "packageManager": "npm@10.8.2",
   "description": "TypeScript project boilerplate optimized for Claude Code development with comprehensive development rules, architecture patterns, and quality assurance tools",
   "keywords": [

package/scripts/set-language.js

@@ -12,15 +12,6 @@ const LANGUAGE_PATHS = {
     source: (lang) => `CLAUDE.${lang}.md`,
     target: 'CLAUDE.md'
   },
-  rules: {
-    source: (lang) => `docs/rules-${lang}`,
-    target: 'docs/rules'
-  },
-  guides: {
-    source: (lang) => `docs/guides/${lang}`,
-    target: 'docs/guides/sub-agents.md',
-    sourceFile: (lang) => `docs/guides/${lang}/sub-agents.md`
-  },
   commands: {
     source: (lang) => `.claude/commands-${lang}`,
     target: '.claude/commands'
@@ -28,6 +19,10 @@ const LANGUAGE_PATHS = {
   agents: {
     source: (lang) => `.claude/agents-${lang}`,
     target: '.claude/agents'
+  },
+  skills: {
+    source: (lang) => `.claude/skills-${lang}`,
+    target: '.claude/skills'
   }
 };
 
@@ -148,35 +143,7 @@ function switchLanguage(targetLang) {
     hasErrors = true;
   }
 
-  // 2. Switch docs/rules
-  const rulesSource = LANGUAGE_PATHS.rules.source(targetLang);
-  const rulesTarget = LANGUAGE_PATHS.rules.target;
-  
-  if (fs.existsSync(rulesSource)) {
-    removeDirectory(rulesTarget);
-    copyDirectory(rulesSource, rulesTarget);
-    console.log(`✅ Updated ${rulesTarget}`);
-  } else {
-    console.warn(`⚠️  ${rulesSource} does not exist`);
-    hasErrors = true;
-  }
-
-
-  // 3. Switch docs/guides/sub-agents.md
-  const guideSource = LANGUAGE_PATHS.guides.sourceFile(targetLang);
-  const guideTarget = LANGUAGE_PATHS.guides.target;
-  
-  if (fs.existsSync(guideSource)) {
-    if (fs.existsSync(guideTarget)) {
-      fs.unlinkSync(guideTarget);
-    }
-    copyFile(guideSource, guideTarget);
-    console.log(`✅ Updated ${guideTarget}`);
-  } else {
-    console.warn(`⚠️  ${guideSource} does not exist`);
-  }
-
-  // 4. Switch .claude/commands (only if exists)
+  // 2. Switch .claude/commands (only if exists)
   const commandsSource = LANGUAGE_PATHS.commands.source(targetLang);
   const commandsTarget = LANGUAGE_PATHS.commands.target;
   
@@ -186,16 +153,26 @@ function switchLanguage(targetLang) {
     console.log(`✅ Updated ${commandsTarget}`);
   }
 
-  // 5. Switch .claude/agents (only if exists)
+  // 3. Switch .claude/agents (only if exists)
   const agentsSource = LANGUAGE_PATHS.agents.source(targetLang);
   const agentsTarget = LANGUAGE_PATHS.agents.target;
-  
+
   if (fs.existsSync(agentsSource)) {
     removeDirectory(agentsTarget);
     copyDirectory(agentsSource, agentsTarget);
     console.log(`✅ Updated ${agentsTarget}`);
   }
 
+  // 4. Switch .claude/skills (only if exists)
+  const skillsSource = LANGUAGE_PATHS.skills.source(targetLang);
+  const skillsTarget = LANGUAGE_PATHS.skills.target;
+
+  if (fs.existsSync(skillsSource)) {
+    removeDirectory(skillsTarget);
+    copyDirectory(skillsSource, skillsTarget);
+    console.log(`✅ Updated ${skillsTarget}`);
+  }
+
   // Save configuration
   const config = {
     current: targetLang,
@@ -226,25 +203,30 @@ function showStatus() {
   console.log('📁 File existence check:');
   for (const lang of SUPPORTED_LANGUAGES) {
     console.log(`\n  ${lang.toUpperCase()} language files:`);
-    
+
     // CLAUDE.md
     const claudeFile = LANGUAGE_PATHS.claude.source(lang);
     console.log(`    ${claudeFile}: ${fs.existsSync(claudeFile) ? '✅' : '❌'}`);
-    
-    // docs/rules
-    const rulesDir = LANGUAGE_PATHS.rules.source(lang);
-    console.log(`    ${rulesDir}: ${fs.existsSync(rulesDir) ? '✅' : '❌'}`);
-    
-    // docs/guides
-    const guideFile = LANGUAGE_PATHS.guides.sourceFile(lang);
-    console.log(`    ${guideFile}: ${fs.existsSync(guideFile) ? '✅' : '❌'}`);
-    
+
+    // .claude/commands
+    const commandsDir = LANGUAGE_PATHS.commands.source(lang);
+    console.log(`    ${commandsDir}: ${fs.existsSync(commandsDir) ? '✅' : '❌'}`);
+
+    // .claude/agents
+    const agentsDir = LANGUAGE_PATHS.agents.source(lang);
+    console.log(`    ${agentsDir}: ${fs.existsSync(agentsDir) ? '✅' : '❌'}`);
+
+    // .claude/skills
+    const skillsDir = LANGUAGE_PATHS.skills.source(lang);
+    console.log(`    ${skillsDir}: ${fs.existsSync(skillsDir) ? '✅' : '❌'}`);
+
   }
-  
+
   console.log('\n📝 Currently active files:');
   console.log(`   CLAUDE.md: ${fs.existsSync('CLAUDE.md') ? '✅' : '❌'}`);
-  console.log(`   docs/rules: ${fs.existsSync('docs/rules') ? '✅' : '❌'}`);
-  console.log(`   docs/guides/sub-agents.md: ${fs.existsSync('docs/guides/sub-agents.md') ? '✅' : '❌'}`);
+  console.log(`   .claude/commands: ${fs.existsSync('.claude/commands') ? '✅' : '❌'}`);
+  console.log(`   .claude/agents: ${fs.existsSync('.claude/agents') ? '✅' : '❌'}`);
+  console.log(`   .claude/skills: ${fs.existsSync('.claude/skills') ? '✅' : '❌'}`);
 }
 
 /**

package/scripts/setup-project.js

@@ -30,6 +30,7 @@ const excludeList = [
   'docs/guides/sub-agents.md',
   '.claude/commands',
   '.claude/agents',
+  '.claude/skills',
   'bin', // Exclude bin directory for production use
   'templates' // Exclude templates directory for production use
 ];
@@ -137,6 +138,7 @@ docs/guides/ja/
 docs/guides/en/
 .claude/commands-*/
 .claude/agents-*/
+.claude/skills-*/
 `;
 
   // Remove current language-related exclusions and add new ones
@@ -147,7 +149,8 @@ docs/guides/en/
            !trimmed.startsWith('docs/rules/') &&
            !trimmed.startsWith('docs/guides/sub-agents.md') &&
            !trimmed.startsWith('.claude/commands/') &&
-           !trimmed.startsWith('.claude/agents/');
+           !trimmed.startsWith('.claude/agents/') &&
+           !trimmed.startsWith('.claude/skills/');
   });
 
   content = filteredLines.join('\n') + languageExclusions;