create-ai-project 1.11.2

package/README.ja.md

@@ -0,0 +1,233 @@
+# AI コーディングプロジェクト ボイラープレート 🤖
+
+*他の言語で読む: [English](README.md)*
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?logo=typescript)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green?logo=node.js)](https://nodejs.org/)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-Optimized-purple)](https://claude.ai/code)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/shinpr/ai-coding-project-boilerplate/pulls)
+
+⚡ **このボイラープレートは以下のような開発者のためのツールです**
+- AIを活用して**プロダクション品質のTypeScriptプロジェクト**を開発したい
+- 長時間のAIコーディングで起きる**コンテキスト枯渇**を回避したい
+- **専門AIエージェント**で開発のワークフローを標準化したい
+
+## 📖 目次
+1. [クイックスタート（3ステップ）](#-クイックスタート3ステップ)
+2. [なぜサブエージェント？](#-なぜサブエージェント)
+3. [実プロジェクトの成果](#-実プロジェクトの成果)
+4. [ドキュメント＆ガイド](#-ドキュメントガイド)
+5. [スラッシュコマンド](#-スラッシュコマンド)
+6. [開発ワークフロー](#-claude-code-ワークフロー)
+7. [プロジェクト構成](#-プロジェクト構成)
+8. [パッケージマネージャーの設定](#-パッケージマネージャーの設定)
+9. [多言語対応](#-多言語対応)
+10. [よくある質問](#-よくある質問)
+
+> **どれを使うべき？**
+> - **このボイラープレート**を使う → **Claude Code**で**TypeScript × サブエージェント**に最適化し、**精度を最大化**したい場合
+> - **[claude-code-workflows](https://github.com/shinpr/claude-code-workflows)**を使う → **Claude Code**で**どんなプロジェクトでも2コマンドで始められる**、**プログラミング言語非依存**のワークフロー
+> - **[Agentic Code](https://github.com/shinpr/agentic-code)**を使う → **設定不要**で**どんなツール**でも**プログラミング言語の指定なく**開発したい場合（Codex CLI/Cursor/Aider等）
+
+## ⚡ クイックスタート（3ステップ）
+
+```bash
+# 1. プロジェクト作成（30秒）
+npx create-ai-project my-project --lang=ja
+
+# 2. 依存関係インストール（自動）
+cd my-project && npm install
+
+# 3. Claude Codeを起動して設定
+claude                         # Claude Codeを起動
+/project-inject                # プロジェクトコンテキストを設定
+/implement <あなたの作りたい機能> # 開発開始！
+```
+
+> 💡 **初めての方は？** [クイックスタートガイド](docs/guides/ja/quickstart.md)で詳細なセットアップ手順を確認
+
+## 🚀 なぜサブエージェント？
+
+**従来のAIコーディングの問題**
+- ❌ 長時間のセッションでコンテキストを失う
+- ❌ 時間とともにコード品質が低下
+- ❌ 大規模タスクで頻繁なセッション再起動が必要
+
+**サブエージェントによる解決**
+- ✅ 専門的な単一の役割に分割（設計、実装、レビュー）
+- ✅ コンテキストを常に新鮮に保ち、品質を一定に維持
+- ✅ 品質低下なしで規模感のあるタスクを処理
+
+各サブエージェントは1つのタスクに集中します。その結果、コンテキストは枯渇せず、品質も維持されます。
+
+👉 [サブエージェントについて詳しく（Anthropic docs）](https://docs.anthropic.com/en/docs/claude-code/sub-agents)
+
+### 📸 デモ
+
+![Demo](./.github/assets/demo.gif)
+
+*サブエージェントが連携してプロダクション品質のTypeScriptプロジェクトを構築する様子*
+
+## 🎯 実プロジェクトの成果
+
+### [Sub agents MCP Server](https://github.com/shinpr/sub-agents-mcp)
+**内容**: Claude Code/Cursor CLIをサブエージェント化するMCPサーバー  
+**時間**: 2日間 → **TypeScript 30ファイル、フルテストカバレッジ**  
+**結果**: プロダクション環境にデプロイ済み、3分でセットアップ可能
+
+### [MCP Image Generator](https://github.com/shinpr/mcp-image)
+**内容**: Gemini API経由のAI画像生成  
+**時間**: 1.5日間 → **高度な機能を持つクリエイティブツール**  
+**結果**: マルチ画像ブレンディング、キャラクター一貫性、ワンコマンド統合
+
+> 💡 **ポイント**: 適切なルール + サブエージェント = 素早くプロダクション品質のコードを生成できる
+
+## 📚 ドキュメント＆ガイド
+
+- **[クイックスタートガイド](docs/guides/ja/quickstart.md)** - 5分で動かす
+- **[ユースケース＆コマンド](docs/guides/ja/use-cases.md)** - 日常ワークフローのリファレンス
+- **[ルール編集ガイド](docs/guides/ja/rule-editing-guide.md)** - プロジェクトに合わせてカスタマイズ
+- **[設計思想](https://qiita.com/shinpr/items/98771c2b8d2e15cafcd5)** - なぜこれが機能するのか
+
+## 📝 スラッシュコマンド
+
+Claude Codeで利用できる主要なコマンド：
+
+| コマンド | 目的 | 使用場面 |
+|---------|------|----------|
+| `/implement` | 要件から実装までの一貫した開発 | 新機能開発（Backend） |
+| `/task` | ルールに基づいた単一タスクの実行 | バグ修正、小規模な変更 |
+| `/design` | 設計書の作成 | アーキテクチャの計画時（Backend） |
+| `/plan` | 設計書から作業計画書を作成 | 設計承認後（Backend） |
+| `/build` | 既存の計画から実行 | 作業の再開時（Backend） |
+| `/review` | コードの準拠性確認 | 実装完了後 |
+| `/front-design` | フロントエンド設計書の作成 | React/Viteアーキテクチャ計画時 |
+| `/front-plan` | フロントエンド作業計画書を作成 | フロントエンド設計承認後 |
+| `/front-build` | フロントエンド実装の実行 | Reactコンポーネント開発 |
+
+[コマンドの詳細はこちら →](docs/guides/ja/use-cases.md)
+
+## 🤖 Claude Code ワークフロー
+
+```mermaid
+graph LR
+    A[要件] --> B[規模判定]
+    B -->|小規模| C[直接実装]
+    B -->|中規模| D[設計 → 実装]
+    B -->|大規模| E[PRD → 設計 → 実装]
+    
+    C --> F[品質チェック → コミット]
+    D --> F
+    E --> F
+```
+
+### 動作の仕組み
+
+1. **要件分析**: `/implement`コマンドがタスクの規模を判断します
+2. **ドキュメント生成**: 必要に応じてドキュメント（PRD、Design Doc、Work Plan）を作成します
+3. **タスク実行**: 専門のエージェントが各フェーズを担当します
+4. **品質保証**: テスト、型チェック、必要に応じた修正を行います
+5. **コミット**: タスクごとに整理されたコミットを作成します
+
+## 📂 プロジェクト構成
+
+```
+ai-coding-project-boilerplate/
+├── .claude/               # AIエージェント設定
+│   ├── agents/           # 専門サブエージェント定義
+│   └── commands/         # スラッシュコマンド定義
+├── docs/
+│   ├── rules/            # 開発ルール＆パターン
+│   ├── guides/           # ユーザードキュメント
+│   ├── adr/              # アーキテクチャ決定
+│   ├── design/           # 設計ドキュメント
+│   └── prd/              # 製品要件
+├── src/                  # あなたのソースコード
+├── scripts/              # ユーティリティスクリプト
+└── CLAUDE.md             # Claude Code設定
+```
+
+## 🔧 パッケージマネージャーの設定
+
+このボイラープレートはデフォルトでnpmを使用しますが、bunやpnpmなど好みのパッケージマネージャーに切り替えることができます。
+
+`package.json`には2つの環境依存設定があります：
+
+- **`packageManager`**: 使用するパッケージマネージャーとバージョン
+- **`scripts`**: 各スクリプトの実行コマンド
+
+これらを変更すると、Claude Codeがそれを認識し、適切なコマンドで実行します。
+
+### bunに切り替える場合
+
+```json
+{
+  "packageManager": "bun@1.3.3",
+  "scripts": {
+    "build": "bun run tsc && tsc-alias",
+    "dev": "bun run src/index.ts",
+    "test": "bun test",
+    "check": "bunx @biomejs/biome check src",
+    "check:all": "bun run check && bun run lint && bun run format:check && bun run check:unused && bun run check:deps && bun run build && bun test"
+  }
+}
+```
+
+上記は代表例です。ルールやサブエージェント定義で言及されているスクリプトは以下の通りです。必要に応じて書き換えてください：
+
+`build`, `build:frontend`, `dev`, `preview`, `type-check`, `test`, `test:coverage`, `test:coverage:fresh`, `test:safe`, `cleanup:processes`, `check`, `check:fix`, `check:code`, `check:unused`, `check:deps`, `check:all`, `format`, `format:check`, `lint`, `lint:fix`
+
+## 🌐 多言語対応
+
+日本語と英語に対応しています：
+
+```bash
+npm run lang:ja         # 日本語に切り替え
+npm run lang:en         # 英語に切り替え
+npm run lang:status     # 現在の言語設定を確認
+```
+
+言語を切り替えると、設定ファイル、ルール、エージェント定義が自動的に更新されます。
+
+## 🤔 よくある質問
+
+**Q: サブエージェントはどのように動作しますか？**  
+A: `/implement`や`/task`コマンドを使用すると、タスクに応じて適切なエージェントが自動的に選択され、実行されます。
+
+**Q: エラーが発生した場合の対処法は？**  
+A: quality-fixerが多くの問題を自動的に検出・修正します。自動修正できない場合は、具体的な対処方法をご案内します。
+
+**Q: プロジェクトに合わせたカスタマイズは可能ですか？**  
+A: はい、可能です。`/project-inject`コマンドを実行して、プロジェクト固有の設定を行ってください。
+
+**Q: 基本的な開発の流れを教えてください。**  
+A: 初回は`/project-inject`でプロジェクト設定を行い、その後は`/implement`で機能開発、品質チェック、コミットという流れになります。
+
+**Q: GitHub CopilotやCursorとはどう違いますか？**  
+A: これらのツールはコード記述の支援に特化していますが、本ボイラープレートは開発プロセス全体をサポートする仕組みを提供しています。
+
+## 🤖 サブエージェント一覧
+
+| エージェント | 担当領域 | 使用されるタイミング |
+|------------|---------|------------------|
+| **requirement-analyzer** | タスク規模の判定 | `/implement`コマンド実行時 |
+| **technical-designer** | 設計ドキュメントの作成 | 中規模・大規模機能の開発時 |
+| **document-reviewer** | ドキュメント品質チェック | ドキュメント作成後 |
+| **design-sync** | Design Doc間の整合性検証 | Design Doc作成後 |
+| **acceptance-test-generator** | ACからテストスケルトン生成 | 設計承認後 |
+| **work-planner** | タスクの分解と計画 | 設計完了後 |
+| **task-executor** | 実装作業 | 開発フェーズ |
+| **quality-fixer** | 品質問題の修正 | エラーや警告の検出時 |
+| **code-reviewer** | コードレビュー | `/review`コマンド実行時 |
+| **integration-test-reviewer** | テスト実装品質の検証 | テスト実装後 |
+
+[エージェントの詳細 →](.claude/agents-ja/)
+
+## 📄 ライセンス
+
+MIT License - 自由に使用・改変・配布可能
+
+## 🎯 このプロジェクトについて
+
+AI Coding Project Boilerplateは、AIを活用した開発において、コード品質と開発効率のバランスを重視して設計されています。サブエージェントによる役割分担とコンテキスト管理により、TypeScriptプロジェクトの効率的な開発をサポートします。

package/README.md

@@ -0,0 +1,243 @@
+# AI Coding Project Boilerplate 🤖
+
+*Read this in other languages: [日本語](README.ja.md)*
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?logo=typescript)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green?logo=node.js)](https://nodejs.org/)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-Optimized-purple)](https://claude.ai/code)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/shinpr/ai-coding-project-boilerplate/pulls)
+
+⚡ **This boilerplate is for developers who want to:**
+- Build **production-ready TypeScript projects** faster with AI
+- Avoid **context exhaustion** in long AI coding sessions
+- Standardize team workflows with **specialized AI agents**
+
+## 📖 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)
+
+> **Which one should you use?**
+> - **Use this Boilerplate** if you want to **maximize precision** with **TypeScript × Sub-agent** setup optimized for **Claude Code**.
+> - **Use [claude-code-workflows](https://github.com/shinpr/claude-code-workflows)** if you're on **Claude Code** and want to **start with any project** in **2 commands** and **language-agnostic** workflows.
+> - **Use [Agentic Code](https://github.com/shinpr/agentic-code)** if you want **zero-config**, **tool-agnostic** workflows **without language restrictions** (Codex CLI/Cursor/Aider etc.).
+
+## ⚡ Quick Start (3 Steps)
+
+```bash
+# 1. Create your project (30 seconds)
+npx create-ai-project my-project
+
+# 2. Install dependencies (automatic)
+cd my-project && npm install
+
+# 3. Launch Claude Code and configure
+claude                    # Launch Claude Code
+/project-inject          # Configure project context
+/implement <your feature> # Start building!
+```
+
+> 💡 **First time?** Check the [Quick Start Guide](docs/guides/en/quickstart.md) for detailed setup instructions
+
+## 🚀 Why Sub Agents?
+
+**Traditional AI coding struggles with:**
+- ❌ Losing context in long sessions
+- ❌ Declining code quality over time  
+- ❌ Frequent session restarts for large tasks
+
+**Sub agents solve this by:**
+- ✅ Splitting work into specialized roles (design, implementation, review)
+- ✅ Keeping context fresh and quality consistent
+- ✅ Handling large projects without degradation
+
+Each agent focuses on one thing and does it well. No context exhaustion, no quality drop.
+
+👉 [Learn more about Sub Agents (Anthropic docs)](https://docs.anthropic.com/en/docs/claude-code/sub-agents)
+
+### 📸 Demo
+
+![Demo](./.github/assets/demo.gif)
+
+*Sub agents working together to build a production-ready TypeScript project*
+
+## 🎯 Real-World Results
+
+### ⏱️ Time Comparison
+- **Without this boilerplate**: ~1 week for setup + infrastructure
+- **With this boilerplate**: ~2 days to production-ready application
+
+### Success Stories
+
+#### [Sub agents MCP Server](https://github.com/shinpr/sub-agents-mcp)
+**What**: MCP server enabling Claude Code/Cursor CLI as sub agents  
+**Time**: 2 days → **30 TypeScript files with full test coverage**  
+**Result**: Production-deployed, 3-minute setup
+
+#### [MCP Image Generator](https://github.com/shinpr/mcp-image)
+**What**: AI image generation via Gemini API  
+**Time**: 1.5 days → **Complete creative tool with advanced features**  
+**Result**: Multi-image blending, character consistency, one-command integration
+
+> 💡 **Key Insight**: Proper rules + sub agents = production-quality code at AI speed
+
+## 📚 Documentation & Guides
+
+- **[Quick Start Guide](docs/guides/en/quickstart.md)** - Get running in 5 minutes
+- **[Use Cases & Commands](docs/guides/en/use-cases.md)** - Daily workflow reference
+- **[Rule Editing Guide](docs/guides/en/rule-editing-guide.md)** - Customize for your project
+- **[Design Philosophy](https://dev.to/shinpr/zero-context-exhaustion-building-production-ready-ai-coding-teams-with-claude-code-sub-agents-31b)** - Why it works (770K tokens without exhaustion)
+
+## 📝 Slash Commands
+
+Essential commands for Claude Code:
+
+| Command | Purpose | When to Use |
+|---------|---------|-------------|
+| `/implement` | End-to-end feature development | New features (Backend) |
+| `/task` | Single task with rule precision | Bug fixes, small changes |
+| `/design` | Create design docs only | Architecture planning (Backend) |
+| `/plan` | Create work plan from design | After design approval (Backend) |
+| `/build` | Execute from existing plan | Resume work (Backend) |
+| `/review` | Check code compliance | Post-implementation |
+| `/front-design` | Create frontend design docs | React/Vite architecture planning |
+| `/front-plan` | Create frontend work plan | After frontend design approval |
+| `/front-build` | Execute frontend implementation | React component development |
+
+[Full command reference →](docs/guides/en/use-cases.md)
+
+## 🤖 Claude Code Workflow
+
+```mermaid
+graph LR
+    A[Requirements] --> B[Scale Detection]
+    B -->|Small| C[Direct Implementation]
+    B -->|Medium| D[Design → Implementation]
+    B -->|Large| E[PRD → Design → Implementation]
+    
+    C --> F[Quality Check → Commit]
+    D --> F
+    E --> F
+```
+
+### How It Works
+
+1. **Requirement Analysis**: `/implement` command analyzes task scale
+2. **Document Generation**: Creates necessary docs (PRD, Design Doc, Work Plan)
+3. **Task Execution**: Specialized agents handle each phase
+4. **Quality Assurance**: Automatic testing, type checking, and fixes
+5. **Commit & Continue**: Clean commits for each completed task
+
+## 📂 Project Structure
+
+```
+ai-coding-project-boilerplate/
+├── .claude/               # AI agent configurations
+│   ├── agents/           # Specialized sub-agent definitions
+│   └── commands/         # Slash command definitions
+├── docs/
+│   ├── rules/            # Development rules & patterns
+│   ├── guides/           # User documentation
+│   ├── adr/              # Architecture decisions
+│   ├── design/           # Design documents
+│   └── prd/              # Product requirements
+├── src/                  # Your source code
+├── scripts/              # Utility scripts
+└── CLAUDE.md             # Claude Code configuration
+```
+
+## 🔧 Package Manager Configuration
+
+This boilerplate uses npm by default, but you can switch to your preferred package manager like bun or pnpm.
+
+There are two environment-dependent settings in `package.json`:
+
+- **`packageManager`**: The package manager and version to use
+- **`scripts`**: The execution commands for each script
+
+When you change these, Claude Code will recognize them and execute with the appropriate commands.
+
+### Switching to bun
+
+```json
+{
+  "packageManager": "bun@1.3.3",
+  "scripts": {
+    "build": "bun run tsc && tsc-alias",
+    "dev": "bun run src/index.ts",
+    "test": "bun test",
+    "check": "bunx @biomejs/biome check src",
+    "check:all": "bun run check && bun run lint && bun run format:check && bun run check:unused && bun run check:deps && bun run build && bun test"
+  }
+}
+```
+
+The above are representative examples. The following scripts are referenced in rules and sub-agent definitions. Update them as needed:
+
+`build`, `build:frontend`, `dev`, `preview`, `type-check`, `test`, `test:coverage`, `test:coverage:fresh`, `test:safe`, `cleanup:processes`, `check`, `check:fix`, `check:code`, `check:unused`, `check:deps`, `check:all`, `format`, `format:check`, `lint`, `lint:fix`
+
+## 🌐 Multilingual Support
+
+Full support for English and Japanese:
+
+```bash
+npm run lang:en         # Switch to English
+npm run lang:ja         # Switch to Japanese
+npm run lang:status     # Check current language
+```
+
+Automatically updates all configurations, rules, and agent definitions.
+
+## 🤔 FAQ
+
+**Q: How do sub agents work?**  
+A: Just use `/implement` or `/task`. The right agents activate automatically.
+
+**Q: What if there are errors?**  
+A: quality-fixer auto-fixes most issues. If not, it provides clear instructions.
+
+**Q: Can I customize for my project?**  
+A: Yes! Run `/project-inject` to configure project-specific context.
+
+**Q: What's the typical workflow?**  
+A: `/project-inject` (once) → `/implement` (features) → auto quality checks → commit
+
+**Q: How is this different from Copilot/Cursor?**  
+A: Those help write code. This manages entire development lifecycle with specialized agents.
+
+## 🤖 Complete Sub Agents Roster
+
+| Agent | Specialization | Activation |
+|-------|---------------|------------|
+| **requirement-analyzer** | Scale assessment | Start of `/implement` |
+| **technical-designer** | Design documentation | Medium/large features |
+| **document-reviewer** | Document quality check | After document creation |
+| **design-sync** | Design Doc consistency | After Design Doc creation |
+| **acceptance-test-generator** | Test skeleton from ACs | After design approval |
+| **work-planner** | Task breakdown | After design approval |
+| **task-executor** | Implementation | During build phase |
+| **quality-fixer** | Automated fixes | On any quality issue |
+| **code-reviewer** | Compliance check | `/review` command |
+| **integration-test-reviewer** | Test implementation quality | After test implementation |
+
+[Full agent list →](.claude/agents-en/)
+
+## 📄 License
+
+MIT License - Free to use, modify, and distribute
+
+## 🎯 About This Project
+
+The AI Coding Project Boilerplate is engineered to maximize AI coding productivity while maintaining human-level code quality. By leveraging specialized sub agents and context engineering, it enables teams to build production-ready TypeScript applications at unprecedented speed.
+
+---
+
+Happy Coding with Claude Code! 🤖✨

package/bin/create-project.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+
+if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+  console.log(`
+🚀 AI Coding Project Boilerplate
+
+Usage:
+  npx create-ai-project <project-name> [options]
+  npm init ai-project <project-name> [options]
+
+Options:
+  --lang=<language>  Set the project language (ja or en, default: en)
+  --help, -h         Show this help message
+
+Examples:
+  npx create-ai-project my-project
+  npx create-ai-project my-project --lang=ja
+  npm init ai-project my-project --lang=ja
+  `);
+  process.exit(0);
+}
+
+const projectName = args[0];
+const options = args.slice(1);
+
+// Parse language option
+let language = 'en'; // default
+for (const opt of options) {
+  if (opt.startsWith('--lang=')) {
+    language = opt.split('=')[1];
+    if (!['ja', 'en'].includes(language)) {
+      console.error(`❌ Invalid language: ${language}. Supported languages are: ja, en`);
+      process.exit(1);
+    }
+  }
+}
+
+// Validate project name
+const validNamePattern = /^[a-z0-9-._]+$/;
+if (!validNamePattern.test(projectName)) {
+  console.error(`❌ Invalid project name: ${projectName}`);
+  console.error('   Project name must contain only lowercase letters, numbers, hyphens, dots, and underscores.');
+  process.exit(1);
+}
+
+// Check if directory already exists
+const projectPath = path.resolve(process.cwd(), projectName);
+if (fs.existsSync(projectPath)) {
+  console.error(`❌ Directory already exists: ${projectPath}`);
+  process.exit(1);
+}
+
+console.log(`\n🎉 Creating new AI coding project: ${projectName}`);
+console.log(`📍 Location: ${projectPath}`);
+console.log(`🌐 Language: ${language}\n`);
+
+// Run setup script
+const setupScript = path.join(__dirname, '..', 'scripts', 'setup-project.js');
+const setupProcess = spawn('node', [setupScript, projectName, language], {
+  stdio: 'inherit',
+  cwd: process.cwd()  // 現在の作業ディレクトリを使用
+});
+
+setupProcess.on('close', (code) => {
+  if (code !== 0) {
+    console.error(`\n❌ Setup failed with exit code ${code}`);
+    process.exit(code);
+  }
+  
+  console.log(`\n✅ Project created successfully!`);
+  console.log(`\n📖 Next steps:`);
+  console.log(`   cd ${projectName}`);
+  console.log(`   npm install`);
+  console.log(`   npm run dev\n`);
+});
+
+setupProcess.on('error', (err) => {
+  console.error(`\n❌ Failed to execute setup script: ${err.message}`);
+  process.exit(1);
+});

package/biome.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "organizeImports": {
+    "enabled": true
+  },
+  "formatter": {
+    "enabled": true,
+    "formatWithErrors": false,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "style": {
+        "noNonNullAssertion": "off"
+      },
+      "suspicious": {
+        "noExplicitAny": "warn"
+      },
+      "complexity": {
+        "useLiteralKeys": "off"
+      }
+    }
+  },
+  "overrides": [
+    {
+      "include": ["**/__tests__/**/*.ts", "**/*.test.ts", "**/*.spec.ts"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noExplicitAny": "off"
+          }
+        }
+      }
+    }
+  ],
+  "javascript": {
+    "formatter": {
+      "semicolons": "asNeeded",
+      "quoteStyle": "single",
+      "trailingCommas": "es5"
+    }
+  },
+  "files": {
+    "include": ["src/**/*.ts", "src/**/*.js"],
+    "ignore": ["node_modules/**", "dist/**"]
+  }
+}

package/docs/adr/template-en.md

@@ -0,0 +1,64 @@
+# [ADR Number] [Title]
+
+## Status
+
+[Proposed | Accepted | Deprecated | Superseded]
+
+## Context
+
+[Describe the background and reasons why this decision is needed. Include the essence of the problem, current challenges, and constraints]
+
+## Decision
+
+[Describe the actual decision made. Aim for specific and clear descriptions]
+
+### Decision Details
+
+| Item | Content |
+|------|---------|
+| **Decision** | [The decision in one sentence] |
+| **Why now** | [Why this needs to happen now (timing rationale)] |
+| **Why this** | [Why this option over alternatives (1-3 lines)] |
+| **Known unknowns** | [At least one uncertainty at this point] |
+| **Kill criteria** | [One signal that should trigger reversal of this decision] |
+
+## Rationale
+
+[Explain why this decision was made and why it is the best option compared to alternatives]
+
+### Options Considered
+
+1. **Option 1**: [Description]
+   - Pros: [List advantages]
+   - Cons: [List disadvantages]
+
+2. **Option 2**: [Description]
+   - Pros: [List advantages]
+   - Cons: [List disadvantages]
+
+3. **Option 3 (Selected)**: [Description]
+   - Pros: [List advantages]
+   - Cons: [List disadvantages]
+
+## Consequences
+
+### Positive Consequences
+
+- [List positive impacts on the project or system]
+
+### Negative Consequences
+
+- [List negative impacts or trade-offs that need to be accepted]
+
+### Neutral Consequences
+
+- [List changes that are neither good nor bad]
+
+## Implementation Guidance
+
+[Principled direction only. Implementation procedures go to Design Doc]
+Example: "Use dependency injection" ✓, "Implement in Phase 1" ✗
+
+## Related Information
+
+- [Links to related ADRs, documents, issues, PRs, etc.]