cursor-sdd 1.0.12 → 1.0.14

package/README.md

@@ -5,23 +5,42 @@ Cursor IDE 向けの Spec-Driven Development (SDD) テンプレート、ルー
 ## インストール
 
 ```bash
-npx install cursor-sdd
+# 推奨（都度実行・インストール不要）
+npx cursor-sdd@latest
+
+# 依存に入れたい場合（必要な時に自分で実行する）
+npm i -D cursor-sdd
 ```
 
-インストール時に自動的にプロジェクトの `.cursor/` フォルダにファイルがコピーされます。対話可能な環境では「新規のPJを立ち上げる / 既存PJにアサインする」を選択できます。
+実行時にプロジェクトの `.cursor/` フォルダにファイルがコピーされます。対話可能な環境では「新規のPJを立ち上げる / 既存PJにアサインする」を選択できます。
 
 ### モード指定
 
-- 対話プロンプト: `npx install cursor-sdd` 実行時に `new` / `assign` を選択
-- 非対話や CI: `npx install cursor-sdd --mode assign` または環境変数 `CURSOR_SDD_MODE=assign`
+- 明示指定（おすすめ）:
+
+```bash
+npx cursor-sdd@latest --mode new
+npx cursor-sdd@latest --mode assign
+```
+
+- 対話プロンプト: `npx cursor-sdd@latest` 実行時に `new` / `assign` を選択
+- 非対話や CI: `npx cursor-sdd@latest --mode assign` または環境変数 `CURSOR_SDD_MODE=assign`
 - 省略時デフォルト: `new`
 
+### 依存として入れた場合の実行
+
+`npm i -D cursor-sdd` しただけでは `.cursor/` は変更しません。セットアップは明示的に実行してください：
+
+```bash
+npx cursor-sdd --mode new
+```
+
 ### 手動セットアップ
 
 既存の `.cursor/` がある場合は自動コピーがスキップされます。強制上書きする場合：
 
 ```bash
-npx cursor-sdd --force
+npx cursor-sdd@latest --force
 ```
 
 ## 使い方
@@ -95,10 +114,3 @@ assign モード時に配布したいファイルはリポジトリ直下の `as
 4. `/tasks` - 実装タスクを生成
 5. `/impl` - タスクを実装
 6. `/status` - 進捗を確認
-
-## License
-
-MIT
-
-# cursor-sdd-package
-

package/assign/README.md

@@ -6,4 +6,11 @@
 - `assign/rules` … アサイン時専用のルール
 - `assign/templates` … アサイン時専用のテンプレート
 
-`npm install cursor-sdd --mode assign` あるいは対話選択で `assign` を選ぶと、このフォルダ配下が `.cursor/` にコピーされます。
+`npx cursor-sdd@latest --mode assign` あるいは対話選択で `assign` を選ぶと、このフォルダ配下が `.cursor/` にコピーされます。
+
+依存に入れる場合は、インストール後にセットアップを実行してください：
+
+```bash
+npm i -D cursor-sdd
+npx cursor-sdd --mode assign
+```

package/bin/setup.ts

@@ -7,6 +7,7 @@ const readline = require('readline');
 
 const isAuto = process.argv.includes('--auto');
 const isForce = process.argv.includes('--force');
+const isHelp = process.argv.includes('--help') || process.argv.includes('-h');
 
 // パッケージのルートディレクトリを取得
 const packageRoot = path.resolve(__dirname, '..');
@@ -83,6 +84,26 @@ function normalizeMode(value) {
   return null;
 }
 
+function printHelp() {
+  console.log(`
+cursor-sdd - Cursor SDD セットアップ
+
+使い方:
+  npx cursor-sdd@latest [--mode new|assign] [--force]
+
+オプション:
+  --mode <new|assign>   コピーするテンプレートのモード（省略時: 対話可能なら選択 / 非対話は new）
+  --force               既存の .cursor/ があっても上書き
+  --auto                対話を無効化（npm install の postinstall など向け）
+  -h, --help            ヘルプ表示
+
+例:
+  npx cursor-sdd@latest --mode new
+  npx cursor-sdd@latest --mode assign
+  npx cursor-sdd@latest --mode assign --force
+`.trim());
+}
+
 function hasTTY() {
   if (process.stdout.isTTY && process.stdin.isTTY) return true;
   // npm install 時に stdin がパイプ扱いになる場合のため /dev/tty を確認
@@ -110,7 +131,8 @@ function createTTYInterface() {
 }
 
 function shouldPromptForMode(explicitMode) {
-  return !explicitMode && hasTTY() && !process.env.CI;
+  // --auto 時はプロンプトを出さず default(new) に寄せる
+  return !explicitMode && !isAuto && hasTTY() && !process.env.CI;
 }
 
 async function askMode() {
@@ -123,7 +145,16 @@ async function askMode() {
 }
 
 function resolveMode() {
-  const explicitMode = normalizeMode(getArgValue('--mode') || process.env.CURSOR_SDD_MODE);
+  const rawModeArg = getArgValue('--mode');
+  const rawMode = rawModeArg || process.env.CURSOR_SDD_MODE;
+  const explicitMode = normalizeMode(rawMode);
+
+  // --mode が指定されているのに値が不正な場合は落とす（黙って default/new にならないように）
+  if (rawModeArg && !explicitMode) {
+    console.error(`\n❌ Invalid --mode value: ${rawModeArg}`);
+    console.error('   Use --mode new or --mode assign\n');
+    process.exit(1);
+  }
   if (explicitMode) return Promise.resolve(explicitMode);
   if (shouldPromptForMode(explicitMode)) {
     return askMode();
@@ -143,7 +174,14 @@ function setup({ mode, sourceRoot, folders }) {
   console.log(`📁 Target: ${targetDir}`);
   console.log(`🎚️  Mode: ${mode}\n`);
 
-  // 既存 .cursor は問答無用で削除してクリーンにする
+  // 既存 .cursor がある場合はデフォルトで破壊しない（--force で上書き）
+  if (fs.existsSync(targetDir) && !isForce) {
+    console.log(`\n⚠️  ${path.relative(projectRoot, targetDir)} already exists. Skip setup.`);
+    console.log('   上書きする場合は --force を付けて実行してください。\n');
+    return;
+  }
+
+  // ここからは安全にクリーンセットアップ
   cleanTargetDir();
 
   if (!folders.length) {
@@ -171,6 +209,10 @@ function setup({ mode, sourceRoot, folders }) {
 }
 
 (async () => {
+  if (isHelp) {
+    printHelp();
+    return;
+  }
   const mode = await resolveMode();
   const sourceRoot = SOURCE_BY_MODE[mode] || SOURCE_BY_MODE.new || packageRoot;
   const folders = getFolders(sourceRoot);

package/new/rules/frontend.md

@@ -1,9 +1,3 @@
----
-description: Next.js(App Router) / React 19 準拠フロントエンド実装ガイド
-globs:
-alwaysApply: true
----
-
 以下は、Next.js(App Router) 15系および React 19 系の公式ドキュメントに準拠した実装ガイドです。
 このルールを使用する際に「フロントエンドのルールを確認しました」と表示してください。
 
@@ -50,7 +44,7 @@ alwaysApply: true
 ## 5. クライアントコンポーネントの指針
 - フォーム、イベント、アニメーションなどのみ `'use client'` を付与。
 - ルーター操作は `useRouter()`、リンクは `Link` を優先。
-- 例外遷移/404: `redirect()` / `notFound()` を使用（`next/navigation`）。
+- クライアント側の遷移/分岐は `useRouter().push/replace`・`Link`・条件描画で扱う（`redirect()` / `notFound()` はサーバー側のみ）。
 
 ## 6. 状態管理
 - ローカル: `useState`, `useReducer`。

package/new/rules/gap-analysis.md

@@ -118,10 +118,10 @@
 ### 5. 実装の複雑さとリスク
 
   - 工数:
-    - S（1〜3日）: 既存パターン、最小限の依存、簡単な統合
-    - M（3〜7日）: いくつかの新パターン/統合、中程度の複雑さ
-    - L（1〜2週間）: 重要な機能、複数の統合またはワークフロー
-    - XL（2週間以上）: アーキテクチャ変更、未知の技術、広範な影響
+    - B（1〜3日）: 既存パターン、最小限の依存、簡単な統合
+    - A（3〜7日）: いくつかの新パターン/統合、中程度の複雑さ
+    - S（1〜2週間）: 重要な機能、複数の統合またはワークフロー
+    - SS（2週間以上）: アーキテクチャ変更、未知の技術、広範な影響
   - リスク:
     - 高: 未知の技術、複雑な統合、アーキテクチャシフト、不明確なパフォーマンス/セキュリティパス
     - 中: ガイダンス付きの新パターン、管理可能な統合、既知のパフォーマンスソリューション

package/new/templates/specs/design.md

@@ -12,7 +12,7 @@
 **警告**: 1000行に近づくと機能の複雑さが過度であり、設計の簡素化が必要な可能性がある。
 ---
 
-> セクションの順序は、明確さが向上する場合に変更可能（例：要件トレーサビリティを前方に配置、データモデルをアーキテクチャの近くに移動）。各セクション内では **概要 → スコープ → 決定事項 → 影響/リスク** の流れを維持し、レビュアーが一貫してスキャンできるようにする。
+セクションの順序は、明確さが向上する場合に変更可能（例：要件トレーサビリティを前方に配置、データモデルをアーキテクチャの近くに移動）。各セクション内では **概要 → スコープ → 決定事項 → 影響/リスク** の流れを維持し、レビュアーが一貫してスキャンできるようにする。
 
 ## 概要
 2-3段落以内
@@ -93,7 +93,7 @@
 
 - 概要はテーブルまたはコンパクトなリスト形式。テーブル例：
   | コンポーネント | ドメイン/レイヤー | 意図 | 要件カバレッジ | 主要な依存関係 (P0/P1) | 契約 |
-  |--------------|----------------|------|--------------|----------------------|------|
+  |-|-|-|-|-|-|
   | ExampleComponent | UI | XYZを表示 | 1, 2 | GameProvider (P0), MapPanel (P1) | Service, State |
 - 新しい境界を導入するコンポーネント（例：ロジックフック、外部連携、永続化）のみが完全な詳細ブロックを必要とする。単純なプレゼンテーションコンポーネントは概要行と短い実装ノートで十分。
 

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "cursor-sdd",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Cursor SDD (Spec-Driven Development) - AI-powered spec templates, rules and commands for Cursor IDE",
   "bin": {
-    "cursor-sdd": "./bin/setup.ts"
+    "cursor-sdd": "bin/setup.ts"
   },
   "files": [
     "bin",
@@ -11,7 +11,7 @@
     "assign"
   ],
   "scripts": {
-    "postinstall": "tsx bin/setup.ts --auto"
+    "setup": "tsx bin/setup.ts"
   },
   "keywords": [
     "cursor",