Merge pull request #58 from shinpr/feat/project-context-update-command

feat: add project-inject command for streamlined project context setup

Author: shinpr

.claude/commands-en/project-inject.md

@@ -0,0 +1,76 @@
+---
+description: Inject project-specific context into project-context.md
+---
+
+**Command Context**: When using the boilerplate, collect project-specific context and update project-context.md.
+
+## Execution Process
+
+### 1. Current State Verification
+! ls -la docs/rules/project-context.md
+! cat package.json | grep -E '"name":|"description":'
+
+### 2. Project Context Collection
+
+Interact with the user to collect the following information:
+
+```
+【Core Project Information】
+1. What problem does your project solve?
+   Examples: "Manual time tracking is inefficient" "Inventory management is person-dependent"
+
+2. Who is the system for?
+   Examples: "50-member sales team" "E-commerce site operators"
+
+3. In what situations will it be used?
+   Examples: "Field staff entering daily reports" "Month-end aggregation tasks"
+
+【Development Structure】
+- Individual development / Team development (number of members)
+- Development phase (Prototype / Production development / In operation)
+
+【Critical Business Constraints】(Maximum 3)
+Examples: "7-year audit log retention" "Mandatory approval workflow" "Real-time synchronization"
+```
+
+**Think deeply** From the collected information, understand the project's essence and construct context focused on single responsibility.
+
+### 3. Generate project-context.md
+
+## AI Execution Accuracy Maximization Criteria
+
+Generated project-context.md must follow these criteria:
+
+### Principles of Description
+1. **Minimal yet maximally efficient**: Essential information only, eliminate redundancy
+2. **AI-decidable**: Use only measurable and verifiable criteria ("quickly" → "within 5 seconds")
+3. **Eliminate ambiguity**: Include specific numbers, conditions, and examples
+4. **Preferred format**: Describe in "do this" form rather than "don't do that"
+
+### Responsibility Boundaries
+project-context.md's single responsibility is "project-specific contextual information" only:
+- ✅ Include: Project objectives, target users, business constraints
+- ❌ Exclude: Tech stack (→technical-spec.md), implementation principles (→typescript.md), architecture (→technical-spec.md)
+
+### Structure
+```markdown
+# Project Context
+
+## Project Overview
+- **Problem being solved**: [Specific challenge]
+- **Target users**: [Include number and attributes]
+- **Usage scenarios**: [Specific situations]
+
+## Development Structure
+- **Team composition**: [Number and roles]
+- **Development phase**: [Current stage]
+
+## Business Constraints
+1. [Measurable constraint]
+2. [Verifiable requirement]
+```
+
+### 4. Update rules-index.yaml
+Update the typical-use in the project-context section to match the project.
+
+**Scope**: Update project-context.md only. Technology choices are the responsibility of other rule files.

.claude/commands-ja/project-inject.md

@@ -0,0 +1,76 @@
+---
+description: プロジェクト固有のコンテキストをproject-context.mdに注入
+---
+
+**コマンドコンテキスト**: ボイラープレート利用時にプロジェクト固有のコンテキストを収集し、project-context.mdを更新します。
+
+## 実行プロセス
+
+### 1. 現状確認
+! ls -la docs/rules/project-context.md
+! cat package.json | grep -E '"name":|"description":'
+
+### 2. プロジェクトコンテキストの収集
+
+ユーザーと対話し、以下の情報を収集：
+
+```
+【プロジェクトの本質】
+1. プロジェクトが解決する問題は何ですか？
+   例: "社内の勤怠管理が煩雑" "在庫管理が属人化している"
+
+2. 誰のためのシステムですか？
+   例: "社内営業チーム50名" "ECサイト運営者"
+
+3. どのような状況で使用されますか？
+   例: "外出先から日報入力" "月末の集計作業時"
+
+【開発体制】
+- 個人開発 / チーム開発（人数）
+- 開発フェーズ（プロトタイプ / 本番開発 / 運用中）
+
+【ビジネス上の重要な制約】（最大3つ）
+例: "監査ログ7年保存" "承認フロー必須" "リアルタイム反映"
+```
+
+**Think deeply** 収集した情報から、プロジェクトの本質を理解し、単一責務に集中したコンテキストを構築します。
+
+### 3. project-context.md生成
+
+## AI実行精度最大化の基準
+
+生成するproject-context.mdは以下の基準に従う：
+
+### 記述の原則
+1. **最小で最大効率**: 本質的な情報のみ、冗長性を排除
+2. **AI判断可能**: 測定・検証可能な基準のみ使用（「迅速に」→「5秒以内」）
+3. **曖昧さの排除**: 具体的な数値・条件・例示を含める
+4. **推奨形式**: 「〜しない」より「〜する」の形で記述
+
+### 責務の境界
+project-context.mdの単一責務は「プロジェクト固有の文脈情報」のみ：
+- ✅ 含める: プロジェクトの目的、ターゲット、ビジネス制約
+- ❌ 含めない: 技術スタック（→technical-spec.md）、実装原則（→typescript.md）、アーキテクチャ（→technical-spec.md）
+
+### 構造化
+```markdown
+# プロジェクトコンテキスト
+
+## プロジェクト概要
+- **解決する問題**: [具体的な課題]
+- **ターゲットユーザー**: [人数・属性を含む]
+- **利用シーン**: [具体的な状況]
+
+## 開発体制
+- **チーム構成**: [人数と役割]
+- **開発フェーズ**: [現在の段階]
+
+## ビジネス制約
+1. [測定可能な制約]
+2. [検証可能な要件]
+```
+
+### 4. rules-index.yaml更新
+project-contextセクションのtypical-useをプロジェクトに合わせて更新。
+
+**スコープ**: project-context.mdの更新のみ。技術選択は他のルールファイルの責務。

README.ja.md

@@ -153,6 +153,7 @@ Claude Codeで使える便利なコマンド一覧
 | `/task` | ルールベース実行 | 単一タスク実行時 |
 | `/review` | Design Doc準拠検証 | 実装完了後の検証 |
 | `/rule-maintenance` | ルール管理 | ルール追加・更新時 |
+| `/project-inject` | プロジェクトコンテキスト注入 | ボイラープレート利用開始時 |
 | `/onboard` | ルール読み込み | プロジェクト開始時 |
 
 詳細は `.claude/commands/` 内の各定義ファイルを参照してください。
@@ -170,22 +171,28 @@ npm install
 
 ### プロジェクト固有の設定
 
+プロジェクトに合わせたコンテキスト設定を行います：
+
+```bash
+# 1. Claude Codeでプロジェクトコンテキストを注入
+/project-inject
+
+# このコマンドが対話的に以下を収集・設定します：
+# - プロジェクトが解決する問題
+# - ターゲットユーザーと利用シーン
+# - ビジネス制約と開発体制
+# → docs/rules/project-context.md を自動更新
+```
+
 ```json
-// package.json
+// 2. package.json の基本情報を更新（必要に応じて）
 {
   "name": "your-project-name",
   "description": "プロジェクトの説明",
   "author": "あなたの名前"
 }
 ```
 
-```bash
-# docs/rules-ja/project-context.md のプレースホルダーを置き換え
-# [プロジェクト名] → 実際のプロジェクト名
-# [プロダクト名をここに記載] → 実際のプロダクト名
-# [ターゲットユーザーの職種をここに記載] → 実際のターゲット
-```
-
 ## 💻 開発コマンド
 
 ### 基本コマンド
@@ -288,10 +295,11 @@ A: quality-fixerが修正を試みます。自動修正できない場合は、
 A: `npm run lang:ja`（日本語）または`npm run lang:en`（英語）で切り替え。
 
 ### Q: カスタマイズ方法は？
-A: `docs/rules/project-context.md`のプレースホルダーを置き換えるだけ。
+A: `/project-inject`コマンドを実行して、対話的にプロジェクトコンテキストを設定。
 
 ### Q: Claude Codeでの開発手順は？
-A: 1) ルールファイルを読み込み → 2) 計画立案・承認 → 3) 実装 → 4) 品質チェック → 5) コミット
+A: 【初回】1) `/project-inject`でコンテキスト設定 → 2) `/onboard`でルール読み込み
+   【開発】3) `/implement`または`/task`で実装 → 4) 品質チェック → 5) コミット
 
 ## 📄 ライセンス
 

README.md

@@ -132,6 +132,7 @@ Powerful commands available in Claude Code
 | `/task` | Rule-based execution | Single task execution |
 | `/review` | Design Doc compliance check | Post-implementation validation |
 | `/rule-maintenance` | Rule management | Adding/updating rules |
+| `/project-inject` | Inject project context | When starting with boilerplate |
 | `/onboard` | Load project rules | Project initialization |
 
 See individual definition files in `.claude/commands/` for details.
@@ -149,22 +150,28 @@ npm install
 
 ### Project Configuration
 
+Configure project-specific context for your project:
+
+```bash
+# 1. Inject project context using Claude Code
+/project-inject
+
+# This command interactively collects and configures:
+# - The problem your project solves
+# - Target users and usage scenarios  
+# - Business constraints and development structure
+# → Automatically updates docs/rules/project-context.md
+```
+
 ```json
-// package.json
+// 2. Update package.json basics (if needed)
 {
   "name": "your-project-name",
   "description": "Your project description",
   "author": "Your name"
 }
 ```
 
-```bash
-# Replace placeholders in docs/rules/project-context.md
-# [Project Name] → Your actual project name
-# [Product Name Here] → Your actual product name
-# [Target User Role Here] → Your actual target users
-```
-
 ## 💻 Development Commands
 
 ### Essential Commands
@@ -290,10 +297,11 @@ A: quality-fixer attempts automatic fixes. If it can't resolve them, it provides
 A: Run `npm run lang:ja` (Japanese) or `npm run lang:en` (English).
 
 ### Q: How do I customize the boilerplate?
-A: Replace placeholders in `docs/rules/project-context.md`.
+A: Run `/project-inject` to interactively configure project context.
 
 ### Q: What's the Claude Code development workflow?
-A: 1) Load rules → 2) Plan & approve → 3) Implement → 4) Quality check → 5) Commit
+A: [Initial] 1) `/project-inject` for context setup → 2) `/onboard` to load rules
+   [Development] 3) `/implement` or `/task` to build → 4) Quality check → 5) Commit
 
 ## 📄 License
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-coding-project-boilerplate",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "description": "TypeScript project boilerplate optimized for Claude Code development with comprehensive development rules, architecture patterns, and quality assurance tools",
   "main": "dist/index.js",
   "keywords": [