cursor-sdd 1.0.14 → 1.0.16

package/bin/setup.ts

@@ -1,37 +1,26 @@
-#!/usr/bin/env tsx
+#!/usr/bin/env node
 // @ts-nocheck
 
 const fs = require('fs');
 const path = require('path');
-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, '..');
-const SOURCE_BY_MODE = {
-  new: path.join(packageRoot, 'new'),
-  assign: path.join(packageRoot, 'assign'),
-};
+const sourceDir = path.join(packageRoot, 'new');
+const FOLDERS = ['commands', 'rules', 'templates'];
 
-// プロジェクトのルートを取得（node_modules の2つ上）
+// プロジェクトのルートを取得
 function getProjectRoot() {
-  let current = process.cwd();
-
-  // npm install 経由の場合は INIT_CWD を使用
   if (process.env.INIT_CWD) {
     return process.env.INIT_CWD;
   }
-
-  // node_modules から呼ばれた場合
   const nodeModulesIndex = __dirname.indexOf('node_modules');
   if (nodeModulesIndex !== -1) {
     return __dirname.substring(0, nodeModulesIndex);
   }
-
-  return current;
+  return process.cwd();
 }
 
 const projectRoot = getProjectRoot();
@@ -46,12 +35,10 @@ function copyRecursive(src, dest) {
     if (!fs.existsSync(dest)) {
       fs.mkdirSync(dest, { recursive: true });
     }
-
     for (const item of fs.readdirSync(src)) {
       copyRecursive(path.join(src, item), path.join(dest, item));
     }
   } else {
-    // ファイルが既に存在する場合はスキップ（--force でない限り）
     if (fs.existsSync(dest) && !isForce) {
       console.log(`  ⏭️  Skip (exists): ${path.relative(projectRoot, dest)}`);
       return;
@@ -61,138 +48,18 @@ function copyRecursive(src, dest) {
   }
 }
 
-function cleanTargetDir() {
-  if (fs.existsSync(targetDir)) {
-    fs.rmSync(targetDir, { recursive: true, force: true });
-  }
-  fs.mkdirSync(targetDir, { recursive: true });
-}
-
-function getArgValue(flag) {
-  const idx = process.argv.indexOf(flag);
-  if (idx === -1) return null;
-  const next = process.argv[idx + 1];
-  if (!next || next.startsWith('-')) return null;
-  return next;
-}
-
-function normalizeMode(value) {
-  if (!value) return null;
-  const lower = value.toLowerCase();
-  if (lower === 'assign' || lower === 'a') return 'assign';
-  if (lower === 'new' || lower === 'n') return 'new';
-  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 を確認
-  try {
-    fs.accessSync('/dev/tty', fs.constants.R_OK | fs.constants.W_OK);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function createTTYInterface() {
-  // stdin が非TTYでも /dev/tty を使って対話できるようにする
-  const input = process.stdin.isTTY
-    ? process.stdin
-    : (() => {
-        try {
-          return fs.createReadStream('/dev/tty');
-        } catch {
-          return process.stdin;
-        }
-      })();
-  const output = process.stdout; // 出力は常に標準出力に寄せる
-  return readline.createInterface({ input, output });
-}
-
-function shouldPromptForMode(explicitMode) {
-  // --auto 時はプロンプトを出さず default(new) に寄せる
-  return !explicitMode && !isAuto && hasTTY() && !process.env.CI;
-}
-
-async function askMode() {
-  const rl = createTTYInterface();
-  const answer = await new Promise((resolve) => {
-    rl.question('新規PJを立ち上げますか？既存PJにアサインしますか？ [n]ew/[a]ssign (default: new): ', resolve);
-  });
-  rl.close();
-  return normalizeMode(answer) || 'new';
-}
-
-function resolveMode() {
-  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();
-  }
-  return Promise.resolve('new');
-}
-
-function getFolders(sourceRoot) {
-  if (!fs.existsSync(sourceRoot)) return [];
-  return fs
-    .readdirSync(sourceRoot)
-    .filter((item) => fs.statSync(path.join(sourceRoot, item)).isDirectory());
-}
-
-function setup({ mode, sourceRoot, folders }) {
+function setup() {
   console.log('\n🚀 Setting up Cursor SDD...\n');
-  console.log(`📁 Target: ${targetDir}`);
-  console.log(`🎚️  Mode: ${mode}\n`);
+  console.log(`📁 Target: ${targetDir}\n`);
 
-  // 既存 .cursor がある場合はデフォルトで破壊しない（--force で上書き）
-  if (fs.existsSync(targetDir) && !isForce) {
-    console.log(`\n⚠️  ${path.relative(projectRoot, targetDir)} already exists. Skip setup.`);
-    console.log('   上書きする場合は --force を付けて実行してください。\n');
-    return;
+  if (!fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { recursive: true });
   }
 
-  // ここからは安全にクリーンセットアップ
-  cleanTargetDir();
-
-  if (!folders.length) {
-    console.log(`ℹ️  No folders to copy for mode: ${mode}.`);
-    return;
-  }
-
-  // 各フォルダをコピー
-  for (const folder of folders) {
-    const src = path.join(sourceRoot, folder);
+  for (const folder of FOLDERS) {
+    const src = path.join(sourceDir, folder);
     const dest = path.join(targetDir, folder);
+    if (!fs.existsSync(src)) continue;
 
     console.log(`📂 ${folder}/`);
     copyRecursive(src, dest);
@@ -208,18 +75,5 @@ function setup({ mode, sourceRoot, folders }) {
   console.log('  /status       - Check status\n');
 }
 
-(async () => {
-  if (isHelp) {
-    printHelp();
-    return;
-  }
-  const mode = await resolveMode();
-  const sourceRoot = SOURCE_BY_MODE[mode] || SOURCE_BY_MODE.new || packageRoot;
-  const folders = getFolders(sourceRoot);
-
-  setup({ mode, sourceRoot, folders });
-})().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});
+setup();
 

package/{new → now}/commands/check-design.md

@@ -20,23 +20,23 @@ argument-hint: <feature-name:$1>
 
 ## 実行ステップ
 
-1. **コンテキストの読み込み**:
-   - `.cursor/$1/spec.json` から言語とメタデータを読み込み
-   - `.cursor/$1/requirements.md` から要件を読み込み
-   - `.cursor/$1/design.md` から設計ドキュメントを読み込み
-
-2. **レビューガイドラインの読み込み**:
-   - `.cursor/rules/design-review.md` からレビュー基準とプロセスを読み込み
-
-3. **設計レビューの実行**:
-   - design-review.md のプロセスに従う: 分析 → 重大な問題 → 強み → GO/NO-GO
-   - 最も重要な懸念事項を最大3つに限定
-   - ユーザーとインタラクティブにやり取り
-   - spec.json で指定された言語で出力
-
-4. **判定と次のステップの提供**:
-   - 根拠を伴う明確な GO/NO-GO 判定
-   - 判定に基づいた進め方のガイド
+### ステップ1: コンテキストの読み込み
+- `.cursor/$1/spec.json` から言語とメタデータを読み込み
+- `.cursor/$1/requirements.md` から要件を読み込み
+- `.cursor/$1/design.md` から設計ドキュメントを読み込み
+
+### ステップ2: レビューガイドラインの読み込み
+- `.cursor/rules/design-review.md` からレビュー基準とプロセスを読み込み
+
+### ステップ3: 設計レビューの実行
+- design-review.md のプロセスに従う: 分析 → 重大な問題 → 強み → GO/NO-GO
+- 最も重要な懸念事項を最大3つに限定
+- ユーザーとインタラクティブにやり取り
+- spec.json で指定された言語で出力
+
+### ステップ4: 判定と次のステップの提供
+- 根拠を伴う明確な GO/NO-GO 判定
+- 判定に基づいた進め方のガイド
 
 ## 重要な制約
 - **品質保証であり完璧追求ではない**: 許容可能なリスクを受け入れる

package/{new → now}/commands/design.md

@@ -28,6 +28,9 @@ argument-hint: <feature-name:$1> [-y:$2]
 - `.cursor/rules/design-principles.md` から設計原則
 - `.cursor/templates/specs/research.md` から発見ログ構造
 - **`package.json`（プロジェクトルートに存在する場合）**: 既存の依存関係とバージョンを把握
+- `.cursor/rules/artifacts-generation.md`（成果物の安全な初期作成ルール）を読み込み
+  - `.cursor/$1/artifacts/data-model.md` / `.cursor/$1/artifacts/table-definition.md` が無ければ、テンプレから **init 作成（上書き禁止）**
+  - テンプレ: `.cursor/templates/artifacts/create-data-model.md` / `.cursor/templates/artifacts/create-table-definition.md`
 - `.cursor/rules/frontend.md`（存在する場合）からフロントエンド設計原則
 
 **要件承認の検証**:
@@ -49,6 +52,7 @@ argument-hint: <feature-name:$1> [-y:$2]
    - dependencies / devDependencies を確認し、使用可能なライブラリをリストアップ
    - 既存パッケージのバージョンと互換性を検証
    - 不足している機能がある場合のみ、追加パッケージを検討
+   - **技術スタック記載ルール（必須）**: 設計ドキュメントの「技術スタック」セクションには、`package.json` から読み取った**実際のバージョン**を記載する（推測や汎用的なバージョンではなく、例: `next: "15.1.2"` なら "Next.js 15.1.2" と記載）
 
 3. **適切な発見プロセスの実行**:
    
@@ -185,4 +189,3 @@ spec.json で指定された言語で簡潔なサマリーを提供:
 - 既存の設計は参照として使用（マージモード）
 
 **注記**: タスク生成に進む前に設計の承認が必須。
-</output>

package/{new → now}/commands/difference-check.md

@@ -20,24 +20,24 @@ argument-hint: <feature-name:$1>
 
 ## 実行ステップ
 
-1. **コンテキストの読み込み**:
-   - `.cursor/$1/spec.json` から言語とメタデータを読み込み
-   - `.cursor/$1/requirements.md` から要件を読み込み
-
-2. **分析ガイドラインの読み込み**:
-   - `.cursor/rules/gap-analysis.md` から包括的な分析フレームワークを読み込み
-
-3. **ギャップ分析の実行**:
-   - gap-analysis.md フレームワークに従って徹底的な調査を実施
-   - Grep と Read ツールを使用して既存コードベースを分析
-   - 必要に応じて WebSearch/WebFetch で外部依存関係を調査
-   - 複数の実装アプローチ（拡張/新規/ハイブリッド）を評価
-   - spec.json で指定された言語で出力
-
-4. **分析ドキュメントの生成**:
-   - gap-analysis.md の出力ガイドラインに従って包括的なギャップ分析を作成
-   - トレードオフを含む複数の実行可能なオプションを提示
-   - さらなる調査が必要な領域にフラグを立てる
+### ステップ1: コンテキストの読み込み
+- `.cursor/$1/spec.json` から言語とメタデータを読み込み
+- `.cursor/$1/requirements.md` から要件を読み込み
+
+### ステップ2: 分析ガイドラインの読み込み
+- `.cursor/rules/gap-analysis.md` から包括的な分析フレームワークを読み込み
+
+### ステップ3: ギャップ分析の実行
+- gap-analysis.md フレームワークに従って徹底的な調査を実施
+- Grep と Read ツールを使用して既存コードベースを分析
+- 必要に応じて WebSearch/WebFetch で外部依存関係を調査
+- 複数の実装アプローチ（拡張/新規/ハイブリッド）を評価
+- spec.json で指定された言語で出力
+
+### ステップ4: 分析ドキュメントの生成
+- gap-analysis.md の出力ガイドラインに従って包括的なギャップ分析を作成
+- トレードオフを含む複数の実行可能なオプションを提示
+- さらなる調査が必要な領域にフラグを立てる
 
 ## 重要な制約
 - **決定より情報**: 最終的な実装選択ではなく、分析とオプションを提供

package/{new → now}/commands/init.md

@@ -18,16 +18,21 @@ argument-hint: <project-description>
 ワークスペースのルートフォルダ名をプロジェクト名として使用し、仕様構造を初期化する。
 
 ## 実行ステップ
-1. **プロジェクト名の取得**: ワークスペースのルートフォルダ名をプロジェクト名として使用
-2. **ディレクトリ作成**: `.cursor/[ルートフォルダ名]/`
-3. **テンプレートを使用してファイルを初期化**:
-   - `.cursor/templates/specs/init.json` を読み込み
-   - `.cursor/templates/specs/requirements-init.md` を読み込み
-   - プレースホルダーを置換:
-     - `{{FEATURE_NAME}}` → ルートフォルダ名（プロジェクト名）
-     - `{{TIMESTAMP}}` → 現在の ISO 8601 タイムスタンプ
-     - `{{PROJECT_DESCRIPTION}}` → $ARGUMENTS
-   - `spec.json` と `requirements.md` を `.cursor/[ルートフォルダ名]/` に書き込み
+
+### ステップ1: プロジェクト名の取得
+ワークスペースのルートフォルダ名をプロジェクト名として使用する。
+
+### ステップ2: ディレクトリ作成
+`.cursor/[ルートフォルダ名]/` と `.cursor/[ルートフォルダ名]/artifacts/` を作成する。
+
+### ステップ3: テンプレートを使用してファイルを初期化
+- `.cursor/templates/specs/init.json` を読み込み
+- `.cursor/templates/specs/requirements-init.md` を読み込み
+- プレースホルダーを置換:
+  - `{{FEATURE_NAME}}` → ルートフォルダ名（プロジェクト名）
+  - `{{TIMESTAMP}}` → 現在の日付（YYYY/MM/DD 形式）
+  - `{{PROJECT_DESCRIPTION}}` → $ARGUMENTS
+- `spec.json` と `requirements.md` を `.cursor/[ルートフォルダ名]/` に書き込み
 
 ## 重要な制約
 - この段階で requirements/design/tasks を生成しない

package/now/commands/requirements-import.md

@@ -0,0 +1,98 @@
+<meta>
+description: 既存の要件ドキュメントをインポート（/initで作成済みのrequirements.mdから読み取り）
+argument-hint: <feature-name:$1>
+</meta>
+
+# 既存要件インポート
+
+<background_information>
+- **ミッション**: `/init` で作成された requirements.md に記載された既存要件を正式な要件として取り込み、spec駆動開発のフローに統合
+- **成功基準**:
+  - `.cursor/$1/requirements.md` の「プロジェクト説明」セクションを要件として整形
+  - メタデータを更新してインポート状況を追跡
+  - 次のフェーズ（設計生成）への明確なパスを提供
+- **前提**: `/init` 実行時に、ユーザーが社内要件をプロジェクト説明として入力済み
+</background_information>
+
+<instructions>
+## コアタスク
+`/init` で作成された `.cursor/$1/requirements.md` の「プロジェクト説明」セクションを読み取り、正式な要件として整形・統合する。
+
+## 実行ステップ
+
+### ステップ1: 前提条件の確認
+- `.cursor/$1/spec.json` が存在することを確認（/init 実行済み）
+- `.cursor/$1/requirements.md` が存在することを確認
+- 「## プロジェクト説明（入力）」セクションに内容があることを確認
+
+### ステップ2: 既存要件の読み込み
+- `.cursor/$1/requirements.md` から「## プロジェクト説明（入力）」セクションの内容を抽出
+- 要件の構造を解析（見出し、箇条書き、番号付きリスト等）
+- 複数の要件項目がある場合は個別に識別
+
+### ステップ3: 要件の整形・統合
+- 「## プロジェクト説明（入力）」セクションは維持
+- 「## 要件」セクションにプロジェクト説明の内容を要件として整形・配置
+- 元のフォーマットをできるだけ尊重しつつ、Markdown形式に整形
+- **注意**: EARS フォーマットへの強制変換は行わない（元の記述を尊重）
+- 要件には連番を付与（1, 2, 3...）
+
+### ステップ4: メタデータの更新
+spec.json を以下のように更新:
+- `phase: "requirements-imported"` を設定
+- `approvals.requirements.generated: true` を設定
+- `approvals.requirements.source: "imported"` を追加
+- `updated_at` タイムスタンプを更新
+
+## 重要な制約
+- 既存要件の内容を勝手に変更・削除しない
+- プロジェクト説明セクションは維持（要件セクションにコピー）
+- 元の記述スタイルをできるだけ保持
+- インポート後のレビュー機会を提供
+
+</instructions>
+
+## ツールガイダンス
+- **Read** を使用: `.cursor/$1/spec.json`、`.cursor/$1/requirements.md`
+- **Write** を使用: requirements.md の更新、spec.json の更新
+- **Glob** を使用: ファイル存在確認
+
+## 出力説明
+spec.json で指定された言語で以下を出力:
+
+1. **インポート結果サマリー**:
+   - 取り込んだ要件の概要（主要な要件領域を3-5項目で要約）
+   - 要件数
+   - フォーマット変換の内容（あれば）
+
+2. **更新されたファイル**:
+   - `.cursor/$1/requirements.md`
+   - `.cursor/$1/spec.json`
+
+3. **次のステップ**:
+   - 内容確認の案内
+   - `/design $1` で設計フェーズへ進む方法
+
+**フォーマット要件**:
+- Markdown見出しを使用
+- ファイルパスはコードブロックに含める
+- サマリーは簡潔に（300語以内）
+
+## 安全性とフォールバック
+
+### エラーシナリオ
+- **spec.json が見つからない**: `/init` の実行を案内
+- **requirements.md が見つからない**: `/init` の実行を案内
+- **プロジェクト説明が空**: `/init` 時に要件を入力するよう案内
+- **既に要件セクションに内容がある**: 上書きするか確認をユーザーに求める
+
+### 次のフェーズ: 設計生成
+
+**インポート完了後**:
+- `.cursor/$1/requirements.md` でインポートされた要件をレビュー
+- 必要に応じて手動で調整
+- `/design $1` で設計フェーズに進む
+
+**修正が必要な場合**:
+- requirements.md を直接編集
+- または `/init` からやり直し

package/{new → now}/commands/requirements.md

@@ -20,24 +20,24 @@ requirements.md のプロジェクト説明に基づいて、機能 **$1** の
 
 ## 実行ステップ
 
-1. **コンテキストの読み込み**:
-   - `.cursor/$1/spec.json` から言語とメタデータを読み込み
-   - `.cursor/$1/requirements.md` からプロジェクト説明を読み込み
+### ステップ1: コンテキストの読み込み
+- `.cursor/$1/spec.json` から言語とメタデータを読み込み
+- `.cursor/$1/requirements.md` からプロジェクト説明を読み込み
 
-2. **ガイドラインの読み込み**:
-   - `.cursor/rules/ears-format.md` から EARS 構文ルールを読み込み
-   - `.cursor/templates/specs/requirements.md` からドキュメント構造を読み込み
+### ステップ2: ガイドラインの読み込み
+- `.cursor/rules/ears-format.md` から EARS 構文ルールを読み込み
+- `.cursor/templates/specs/requirements.md` からドキュメント構造を読み込み
 
-3. **要件の生成**:
-   - プロジェクト説明に基づいて初期要件を作成
-   - 関連機能を論理的な要件領域にグループ化
-   - すべての受け入れ基準に EARS フォーマットを適用
-   - spec.json で指定された言語を使用
+### ステップ3: 要件の生成
+- プロジェクト説明に基づいて初期要件を作成
+- 関連機能を論理的な要件領域にグループ化
+- すべての受け入れ基準に EARS フォーマットを適用
+- spec.json で指定された言語を使用
 
-4. **メタデータの更新**:
-   - `phase: "requirements-generated"` を設定
-   - `approvals.requirements.generated: true` を設定
-   - `updated_at` タイムスタンプを更新
+### ステップ4: メタデータの更新
+- `phase: "requirements-generated"` を設定
+- `approvals.requirements.generated: true` を設定
+- `updated_at` タイムスタンプを更新
 
 ## 重要な制約
 - 何を（WHAT）にフォーカスし、どのように（HOW）は含めない（実装詳細なし）
@@ -45,6 +45,17 @@ requirements.md のプロジェクト説明に基づいて、機能 **$1** の
 - EARS文の適切な主語を選択（ソフトウェアにはシステム/サービス名）
 - 最初に初期バージョンを生成し、その後ユーザーフィードバックで反復（事前の連続質問なし）
 - requirements.md の要件見出しには先頭に数値IDのみを含めること（例: "Requirement 1"、"1."、"2 Feature ..."）、"Requirement A" のようなアルファベットIDは使用しない
+
+## 成果物（artifacts）の自動作成
+
+`/requirements` 実行時に、`.cursor/rules/artifacts-generation.md` を読み込み、
+`.cursor/$1/artifacts/feature-list.md` を（無ければ）テンプレから作成する（**上書き禁止**）。
+
+- テンプレ: `.cursor/templates/artifacts/create-feature-list.md`
+
+### 出力への追記
+- 作成/スキップした成果物ファイルの一覧を、requirements 出力サマリーに含める。
+
 </instructions>
 
 ## ツールガイダンス

package/{new → now}/commands/status.md

@@ -25,21 +25,18 @@ argument-hint: <feature-name:$1>
 - `.cursor/$1/` ディレクトリで利用可能なファイルを確認
 
 ### ステップ2: ステータスの分析
-
-**各フェーズを解析**:
 - **Requirements**: 要件と受け入れ基準の数をカウント
 - **Design**: アーキテクチャ、コンポーネント、ダイアグラムを確認
 - **Tasks**: 完了タスク vs 全タスクをカウント（`- [x]` vs `- [ ]` を解析）
 - **Approvals**: spec.json で承認状況を確認
 
 ### ステップ3: レポートの生成
-
 spec.json で指定された言語でレポートを作成し、以下をカバー:
-1. **現在のフェーズと進捗**: ワークフローにおけるspecの位置
-2. **完了状況**: 各フェーズの完了率
-3. **タスク内訳**: タスクが存在する場合、完了/残りの数を表示
-4. **次のアクション**: 次に何をすべきか
-5. **ブロッカー**: 進捗を妨げる問題
+- **現在のフェーズと進捗**: ワークフローにおけるspecの位置
+- **完了状況**: 各フェーズの完了率
+- **タスク内訳**: タスクが存在する場合、完了/残りの数を表示
+- **次のアクション**: 次に何をすべきか
+- **ブロッカー**: 進捗を妨げる問題
 
 ## 重要な制約
 - spec.json の言語を使用

package/{new → now}/commands/tasks.md

@@ -26,6 +26,9 @@ argument-hint: <feature-name:$1> [-y:$2] [--sequential:$3]
 - `.cursor/$1/spec.json`、`requirements.md`、`design.md`
 - `.cursor/$1/tasks.md`（存在する場合、マージモード用）
 - `.cursor/rules/frontend.md`（フロントエンド実装制約）
+- `.cursor/rules/artifacts-generation.md`（成果物の安全な初期作成ルール）
+- `.cursor/$1/artifacts/feature-list.md` / `.cursor/$1/artifacts/data-model.md` / `.cursor/$1/artifacts/table-definition.md` を（存在すれば）読み込み
+- 欠けている場合はテンプレから **init 作成（上書き禁止）** してから参照してよい
 
 **承認の検証**:
 - `-y` フラグが提供された場合（$2 == "-y"）: spec.json で要件と設計を自動承認
@@ -39,6 +42,7 @@ argument-hint: <feature-name:$1> [-y:$2] [--sequential:$3]
 
 読み込むファイルパターン:
 - .cursor/$1/*.{json,md}
+- .cursor/$1/artifacts/*.md
 - .cursor/rules/tasks-generation.md
 - .cursor/rules/tasks-parallel-analysis.md（シーケンシャルモードが false の場合のみ含める）
 - .cursor/templates/specs/tasks.md

package/now/rules/artifacts-generation.md

@@ -0,0 +1,63 @@
+# 成果物（artifacts）生成ルール（AI 実行手順）
+
+## 目的
+requirements / design / tasks の各フェーズで、設計の一次ソースとなる成果物（機能一覧・ERD・テーブル定義書）を **テンプレートから安全に初期作成** できるようにする。
+
+## 対象成果物（.cursor/<feature>/artifacts/ 配下）
+- `feature-list.md`
+- `data-model.md`
+- `table-definition.md`
+
+## 記載ルール（必須）
+### data-model.md（ERD）
+- Mermaid の `erDiagram` には、**登場する各テーブル/エンティティについてカラム定義ブロックを記載する**。
+  - 形式例: `M_USER { bigint id PK ... }`
+  - **PK/UK/FK（分かる範囲）を明示**する（少なくとも `id PK`、主要なユニークキー、参照カラムの `FK`）。
+- `%%` から始まる行は Mermaid のコメントとして扱ってよい（図の読みやすさ向上目的）。
+- `data-model.md` と `table-definition.md` の内容が矛盾しないようにする（命名・キー・参照関係）。
+
+## 生成の基本ポリシー（必須）
+- **安全な init がデフォルト**: 既存ファイルは **絶対に上書きしない**
+- 上書きが許されるのは、ユーザーが明示的に「上書きして」と指示した場合のみ
+- 生成した後は、以降 **差分更新が基本**（全面書き換えしない）
+
+## フェーズ別の生成対象（推奨）
+- **requirements 直後**: `.cursor/<feature>/artifacts/feature-list.md` を（無ければ）作成
+- **design 前半〜中盤**: `.cursor/<feature>/artifacts/data-model.md` を（無ければ）作成
+- **design 中盤〜終盤（tasks 前）**: `.cursor/<feature>/artifacts/table-definition.md` を（無ければ）作成
+- **tasks**: 3成果物（存在する場合）を読み取り、タスクがスコープ逸脱しないようにする
+  - ただし、欠けている成果物がある場合は **テンプレから初期作成してもよい**（initのみ、上書き禁止）
+
+## テンプレートの場所
+テンプレは `.cursor/templates/artifacts/` に置く。
+- `.cursor/templates/artifacts/create-feature-list.md`
+- `.cursor/templates/artifacts/create-data-model.md`
+- `.cursor/templates/artifacts/create-table-definition.md`
+
+## プレースホルダー置換（必須）
+テンプレ内の以下を置換して出力する。
+- `{{PROJECT_NAME}}`
+  - 優先: リポジトリルートの `package.json` の `name`
+  - 代替: ルートフォルダ名
+- `{{DATE}}`: `YYYY-MM-DD`（UTC）
+- `{{TIMESTAMP}}`: `YYYY-MM-DDTHH:mm:ssZ`（UTC）
+- `{{AUTHOR}}`: 未指定なら空文字（ユーザー指定があれば反映）
+
+互換性:
+- テンプレ内に `{{SYSTEM_NAME}}` が残っていたら `{{PROJECT_NAME}}` と同値として扱う（同様に置換）。
+
+## 実行アルゴリズム（AI 向け・手順そのまま）
+1. **機能ディレクトリ判定**: `feature = $1` とし、出力先を `.cursor/$1/artifacts/` とする（無ければ作成）。
+2. **テンプレ読み込み**: 上記3テンプレを読み込む。
+3. **置換値決定**:
+   - `package.json` があれば `name` を読む（文字列かつ非空）
+   - `{{DATE}}`/`{{TIMESTAMP}}` は UTC の現在時刻で生成
+   - `{{AUTHOR}}` は未指定なら空
+4. **安全に作成**:
+   - 出力先（`.cursor/$1/artifacts/`）に同名ファイルが **存在する場合はスキップ**
+   - 存在しない場合のみ、置換済みの内容を書き込んで作成
+5. **結果サマリー**:
+   - 作成/スキップを一覧化して、コマンド出力サマリーに含める
+
+## 例（運用メモ）
+- 通常は `/requirements` / `/design` / `/tasks` の実行に含めて初期作成する（既存は上書きしない）

package/now/templates/artifacts/artifacts_rules.md

@@ -0,0 +1,51 @@
+# 成果物（機能一覧・ERD・テーブル定義書）運用ルール
+
+## 対象成果物（.cursor/<feature>/artifacts/ 配下）
+- `.cursor/<feature>/artifacts/feature-list.md`
+- `.cursor/<feature>/artifacts/data-model.md`
+- `.cursor/<feature>/artifacts/table-definition.md`
+
+## プレースホルダー（テンプレ共通）
+テンプレ（`.cursor/templates/artifacts/*.md`）は以下のプレースホルダーを使う。
+
+- `{{PROJECT_NAME}}`: プロジェクト名（既定: `package.json.name`、無い場合はルートフォルダ名）
+- `{{DATE}}`: `YYYY-MM-DD`（UTC）
+- `{{TIMESTAMP}}`: `YYYY-MM-DDTHH:mm:ssZ`（UTC）
+- `{{AUTHOR}}`: 記載者（任意。未指定なら空）
+
+## 作成/更新タイミング（推奨）
+- **requirements 直後**: `.cursor/<feature>/artifacts/feature-list.md`
+  - MVP/Phase と UI/API/Batch を先に固定（design の前提を明確化）
+- **design 前半〜中盤**: `.cursor/<feature>/artifacts/data-model.md`
+  - MVPの主要エンティティとFKを Mermaid + FK表で固定
+  - Mermaid の `erDiagram` には **カラム定義ブロック（PK/UK/FK）** を含める（登場するテーブルは原則ブロックも書く）
+- **design 中盤〜終盤（tasks前）**: `.cursor/<feature>/artifacts/table-definition.md`
+  - 制約/インデックス/編集仕様まで“契約化”
+- **tasks**: 3成果物（存在する場合）を読み取り、タスクがスコープ逸脱しないようにする
+
+## 生成方法（推奨）
+AI コマンド（`/requirements` / `/design` / `/tasks`）が `.cursor/rules/artifacts-generation.md` に従って **安全に初期作成**（既存は上書きしない）する。
+
+## 更新ポリシー
+- **差分更新が基本**（全面書き換えしない）
+- **MVP優先**で埋め、Phase2以降は追記で拡張
+- spec（`.cursor/<feature>/requirements.md` / `design.md`）と乖離したら、どちらを正にするか決めて同期（放置しない）
+
+## テンプレート
+- `.cursor/templates/artifacts/create-feature-list.md`
+- `.cursor/templates/artifacts/create-data-model.md`
+- `.cursor/templates/artifacts/create-table-definition.md`
+
+## AI 自動作成ルール
+- `.cursor/rules/artifacts-generation.md`
+
+## 共通スニペット（任意）
+- `.cursor/templates/artifacts/change-history-section.md`（変更履歴の統一フォーマット）
+
+---
+
+## 変更履歴
+
+| 日付 | バージョン | 変更者 | 変更内容 |
+| ---- | ---------- | ------ | -------- |
+| {{DATE}} | v1.0 | {{AUTHOR}} | 初版作成 |

package/now/templates/artifacts/create-data-model.md

@@ -0,0 +1,86 @@
+# データモデル / ERD（{{PROJECT_NAME}}）
+
+**目的**: 実装/レビュー/運用が同じ参照を見られるように、ドメイン境界とテーブル関係を Mermaid で固定する。
+**作成/更新タイミング**: `/design` の前半（MVPの主要エンティティが見えたら）。詳細は `.cursor/templates/artifacts/artifacts_rules.md`。
+
+---
+
+## ER 図
+
+**記載ルール（必須）**
+- `erDiagram` 内で、関係線だけでなく **各テーブルのカラム定義ブロック**（PK/UK/FK）も記載する。
+- PK/UK/FK は分かる範囲で明示する（最低限 `id PK`、主要UK、参照カラムの `FK`）。
+- `%%` は Mermaid のコメントとして使用してよい。
+
+```mermaid
+erDiagram
+  %% ここにエンティティ関係を記述
+  %% 例: M_USER ||--o{ T_SESSION : has
+
+  %% 関係線の例
+  M_USER ||--o{ T_SESSION : has
+  M_ITEM ||--o{ T_INVENTORY_BALANCE : has
+
+  %% カラム定義ブロックの例（PK/UK/FK を明示）
+  M_USER {
+    bigint id PK
+    varchar login_id UK
+    varchar display_name
+    varchar role "viewer/operator/admin"
+    timestamptz created_at
+    timestamptz updated_at
+  }
+
+  T_SESSION {
+    bigint id PK
+    bigint user_id FK
+    varchar token UK
+    timestamptz expires_at
+  }
+
+  M_ITEM {
+    bigint id PK
+    varchar sku_code UK
+    varchar name
+    varchar unit "pcs/box/etc"
+    boolean is_active
+  }
+```
+
+---
+
+## テーブル間の関係性
+
+### 外部キー制約一覧
+
+| FK 制約名 | 参照元テーブル | 参照元カラム | 参照先テーブル | 参照先カラム | ON DELETE | ON UPDATE | 説明 |
+| -------- | -------------- | ------------ | -------------- | ------------ | -------- | -------- | ---- |
+| (例) fk_xxx | t_xxx | yyy_id | m_yyy | id | RESTRICT | CASCADE | |
+
+### テーブル間の依存関係
+
+- **依存関係の要約**:
+  - （例）`m_user → t_session`: 1対多。ユーザーが無効なら新規セッション発行停止
+
+### データ整合性ルール
+
+- **整合性方針（例）**:
+  1. どのテーブルが“正（source of truth）”か
+  2. 更新禁止/追記のみ（監査性）
+  3. 冪等性（例: request_id UNIQUE）
+  4. 論理削除/無効化方針
+  5. 参照整合性（ON DELETE 方針）
+
+---
+
+## 参照
+- **テーブル定義書**: `table-definition.md`
+- **機能一覧**: `feature-list.md`
+
+---
+
+## 変更履歴
+
+| 日付 | バージョン | 変更者 | 変更内容 |
+| ---- | ---------- | ------ | -------- |
+| {{DATE}} | v1.0 | {{AUTHOR}} | 初版作成 |

package/now/templates/artifacts/create-feature-list.md

@@ -0,0 +1,45 @@
+# 機能一覧（{{PROJECT_NAME}}）
+
+**目的**: プロダクトのスコープ（MVP/Phase）と、UI/API/バッチの一覧を“合意の一次ソース”として固定する。
+**作成/更新タイミング**: `/requirements` の直後（要件ドラフトが出たらまず作る）。詳細は `.cursor/templates/artifacts/artifacts_rules.md`。
+
+---
+
+## 画面機能
+
+| 機能 ID | 画面名 | 説明 | 優先度 | Phase | 記載者 |
+| ------- | ------ | ---- | ------ | ----- | ------ |
+| UI-001  | （例）在庫一覧 | （例）SKU × ロケーション単位で在庫を一覧表示。検索/絞り込みを提供。 | High | MVP | |
+
+**記載ルール**
+- Phase は `MVP`, `Phase2`, `Phase3`… のように段階を明示
+- 説明は「ユーザー価値 + 主要な入出力」まで（HOW は書かない）
+
+---
+
+## API 機能
+
+| 機能 ID | API 名 | エンドポイント | メソッド | 説明 | レベル | 実装方法 | 優先度 | Phase | 記載者 |
+| ------- | ------ | -------------- | -------- | ---- | ------ | -------- | ------ | ----- | ------ |
+| API-001 | （例）在庫残一覧取得 | /v1/... | GET | （例）在庫残を一覧取得する。 | B | Server API | High | MVP | |
+
+**レベル定義（例）**:
+- **A**: 複雑なビジネスロジック/外部連携/非同期など
+- **B**: 複数テーブル結合/集計/加工あり
+- **C**: 単テーブルCRUD相当
+
+---
+
+## バッチ機能
+
+| 機能 ID | バッチ名 | 実行タイミング | 説明 | 優先度 | Phase | 記載者 |
+| ------- | -------- | -------------- | ---- | ------ | ----- | ------ |
+| BT-001  | （例）在庫残集計 | 任意（例：1時間毎） | （例）台帳から在庫残を集計し高速化する。 | Low | MVP | |
+
+---
+
+## 変更履歴
+
+| 日付 | バージョン | 変更者 | 変更内容 |
+| ---- | ---------- | ------ | -------- |
+| {{DATE}} | v1.0 | {{AUTHOR}} | 初版作成 |

package/now/templates/artifacts/create-table-definition.md

@@ -0,0 +1,80 @@
+# テーブル定義書（{{PROJECT_NAME}}）
+
+**目的**: DBの“契約”を明文化し、実装・レビュー・移行でブレないようにする。
+**作成/更新タイミング**: `/design` の中盤〜終盤（ERDのエンティティが固まったら）。詳細は `.cursor/templates/artifacts/artifacts_rules.md`。
+
+---
+
+## テーブル一覧
+
+| テーブル物理名 | テーブル論理名 | 概要 | 種別 |
+| -------------- | -------------- | ---- | ---- |
+| (例) m_user | ユーザー | ユーザー情報 | マスタ |
+
+---
+
+## 共通カラム定義
+
+> ここはプロジェクト標準を定義して、各テーブルの繰り返しを減らす。
+
+| カラム名 | 論理名 | 型 | 制約 | デフォルト値 | 説明 |
+| ------ | ------ | -- | ---- | ---------- | ---- |
+| id | ID | bigint | PK | | |
+| created_at | 作成日時 | timestamptz | NOT NULL | CURRENT_TIMESTAMP | |
+| created_by | 作成者 | text | NULL | | |
+| created_program | 作成プログラム | varchar(255) | NOT NULL | | |
+| updated_at | 更新日時 | timestamptz | NOT NULL | CURRENT_TIMESTAMP | |
+| updated_by | 更新者 | text | NULL | | |
+| updated_program | 更新プログラム | varchar(255) | NOT NULL | | |
+| patched_at | パッチ更新日時 | timestamptz | NULL | | |
+| patched_by | パッチ更新者 | text | NULL | | |
+| lock_no | ロック番号 | bigint | NOT NULL | 0 | 楽観ロック |
+
+**論理削除カラム（必要なテーブルのみ）**
+
+| カラム名 | 論理名 | 型 | 制約 | デフォルト値 | 説明 |
+| ------- | ------ | -- | ---- | ---------- | ---- |
+| deleted_at | 削除日時 | timestamptz | NULL | | NULL=有効 |
+
+---
+
+## テーブル詳細定義
+
+### （例）ユーザー（m_user）
+
+**概要**: 
+
+#### テーブル定義
+
+| カラム名 | 論理名 | 型 | 制約 | デフォルト値 | 説明 |
+| ------ | ------ | -- | ---- | ---------- | ---- |
+| id | ID | bigint | PK | | |
+
+**インデックス**
+
+| インデックス名 | カラム | 種別 | 備考 |
+| ------------ | ------ | ---- | ---- |
+
+**外部キー制約**
+
+| FK 名 | 参照元カラム | 参照先テーブル | 参照先カラム | ON DELETE | ON UPDATE |
+| ----- | ---------- | -------------- | ------------ | -------- | -------- |
+
+#### データ編集仕様
+
+| カラム名 | [操作 1：作成] | [操作 2：更新] | [操作 3：無効化/削除] |
+| ------- | ------------- | ------------- | --------------------- |
+
+#### RLS ポリシー（任意）
+
+```sql
+-- 採用する場合のみ方針を書く
+```
+
+---
+
+## 変更履歴
+
+| 日付 | バージョン | 変更者 | 変更内容 |
+| ---- | ---------- | ------ | -------- |
+| {{DATE}} | v1.0 | {{AUTHOR}} | 初版作成 |

package/{new → now}/templates/specs/design.md

@@ -20,6 +20,8 @@
 **ユーザー**: [対象ユーザーグループ]が[特定のワークフロー]でこれを利用する。
 **影響**（該当する場合）: 現在の[システム状態]を[具体的な変更]によって変更する。
 
+**成果物（推奨）**: 設計の一次ソースとして、可能な限り以下3つを作成/更新し、設計と矛盾させない。\n> - `.cursor/<feature>/artifacts/feature-list.md`\n> - `.cursor/<feature>/artifacts/data-model.md`\n> - `.cursor/<feature>/artifacts/table-definition.md`\n> テンプレートは `.cursor/templates/artifacts/` を参照。（初期作成ロジックは `.cursor/rules/artifacts-generation.md`）。
+
 ### ゴール
 - 主要目標1
 - 主要目標2
@@ -163,6 +165,8 @@ interface [ComponentName]Service {
 
 この機能で変更されるデータ環境の部分に焦点を当てる。
 
+**注記**: データモデルは `data-model.md` / `table-definition.md` と整合している必要がある。設計内では決定事項と契約を要約し、詳細は成果物側を一次ソースとして参照してよい（ただし矛盾は許容しない）。
+
 ### ドメインモデル
 - 集約とトランザクション境界
 - エンティティ、値オブジェクト、ドメインイベント
@@ -273,3 +277,11 @@ _パフォーマンス目標、高負荷、またはスケーリングの懸念
 - メイン本文に情報を残すと可読性が損なわれる場合のみこのセクションを作成（例：非常に長いTypeScript定義、ベンダーオプションマトリックス、網羅的なスキーマテーブル）。意思決定のコンテキストはメインセクションに残し、設計を自己完結型に保つ。
 - 大きなスニペットをインラインで含めず、メインテキストから参考資料へのリンクを張る。
 - 背景調査ノートと比較は引き続き`research.md`に記載するが、その結論はメイン設計に要約する必要がある。
+
+---
+
+## 変更履歴
+
+| 日付 | バージョン | 変更者 | 変更内容 |
+| ---- | ---------- | ------ | -------- |
+| {{DATE}} | v1.0 | {{AUTHOR}} | 初版作成 |

package/now/templates/specs/requirements-init.md

@@ -0,0 +1,15 @@
+# 要件ドキュメント
+
+## プロジェクト説明（入力）
+{{PROJECT_DESCRIPTION}}
+
+## 要件
+<!-- /kiro:spec-requirements フェーズで生成 -->
+
+---
+
+## 変更履歴
+
+| 日付 | バージョン | 変更者 | 変更内容 |
+| ---- | ---------- | ------ | -------- |
+| {{DATE}} | v1.0 | {{AUTHOR}} | 初版作成 |

package/{new → now}/templates/specs/requirements.md

@@ -24,3 +24,21 @@
 2. [イベント]かつ[条件]の場合、[システム]は[レスポンス/アクション]を行う
 
 <!-- 追加の要件は同じパターンに従う -->
+
+## 成果物（推奨）
+このフェーズの出力を **設計の一次ソース** に落とし込むため、要件ドラフトが出た時点で以下を作成/更新する。
+
+※ 自動初期作成（上書き禁止）のルールは `.cursor/rules/artifacts-generation.md` を参照。
+
+- `.cursor/<feature>/artifacts/feature-list.md`（MVP/Phase と UI/API/Batch の一覧）
+
+テンプレート:
+- `.cursor/templates/artifacts/create-feature-list.md`
+
+---
+
+## 変更履歴
+
+| 日付 | バージョン | 変更者 | 変更内容 |
+| ---- | ---------- | ------ | -------- |
+| {{DATE}} | v1.0 | {{AUTHOR}} | 初版作成 |

package/{new → now}/templates/specs/research.md

@@ -59,3 +59,11 @@ _各決定についてサブセクションを繰り返す。_
 正規のリンクと引用を提供（公式ドキュメント、標準、ADR、内部ガイドライン）。
 - [タイトル](https://example.com) — 関連性の簡単なメモ
 - ...
+
+---
+
+## 変更履歴
+
+| 日付 | バージョン | 変更者 | 変更内容 |
+| ---- | ---------- | ------ | -------- |
+| {{DATE}} | v1.0 | {{AUTHOR}} | 初版作成 |

package/now/templates/specs/tasks.md

@@ -0,0 +1,31 @@
+# 実装計画
+
+**成果物の参照（推奨）**: 可能であれば `.cursor/<feature>/artifacts/feature-list.md` / `.cursor/<feature>/artifacts/data-model.md` / `.cursor/<feature>/artifacts/table-definition.md` を前提に、タスクがスコープ逸脱しないように分解する（ただしタスクリスト自体にドキュメント作業は含めない）。
+
+## タスク形式テンプレート
+
+作業分解に適したパターンを使用：
+
+### メジャータスクのみ
+- [ ] {{NUMBER}}. {{TASK_DESCRIPTION}}{{PARALLEL_MARK}}
+  - {{DETAIL_ITEM_1}} *（必要な場合のみ詳細を含める。タスクが単独で成立する場合は箇条書きを省略。）*
+  - _要件: {{REQUIREMENT_IDS}}_
+
+### メジャー + サブタスク構造
+- [ ] {{MAJOR_NUMBER}}. {{MAJOR_TASK_SUMMARY}}
+- [ ] {{MAJOR_NUMBER}}.{{SUB_NUMBER}} {{SUB_TASK_DESCRIPTION}}{{SUB_PARALLEL_MARK}}
+  - {{DETAIL_ITEM_1}}
+  - {{DETAIL_ITEM_2}}
+  - _要件: {{REQUIREMENT_IDS}}_ *（IDのみ。説明や括弧を追加しない。）*
+
+**並列マーカー**: 並列実行可能なタスクにのみ` (P)`を付加。`--sequential`モードで実行する場合はマーカーを省略。
+
+**オプションのテストカバレッジ**: 受け入れ基準に関連する延期可能なテスト作業のサブタスクの場合、チェックボックスを`- [ ]*`としてマークし、詳細の箇条書きで参照要件を説明。
+
+---
+
+## 変更履歴
+
+| 日付 | バージョン | 変更者 | 変更内容 |
+| ---- | ---------- | ------ | -------- |
+| {{DATE}} | v1.0 | {{AUTHOR}} | 初版作成 |

package/package.json

@@ -1,18 +1,15 @@
 {
   "name": "cursor-sdd",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Cursor SDD (Spec-Driven Development) - AI-powered spec templates, rules and commands for Cursor IDE",
   "bin": {
     "cursor-sdd": "bin/setup.ts"
   },
   "files": [
     "bin",
-    "new",
-    "assign"
+    "now"
   ],
-  "scripts": {
-    "setup": "tsx bin/setup.ts"
-  },
+  "scripts": {},
   "keywords": [
     "cursor",
     "cursor-ide",

package/assign/README.md

@@ -1,16 +0,0 @@
-# assign プロファイル
-
-既存プロジェクトにアサインする際のカスタム `.cursor` 一式をここに配置します。
-
-- `assign/commands` … アサイン時専用のコマンド定義
-- `assign/rules` … アサイン時専用のルール
-- `assign/templates` … アサイン時専用のテンプレート
-
-`npx cursor-sdd@latest --mode assign` あるいは対話選択で `assign` を選ぶと、このフォルダ配下が `.cursor/` にコピーされます。
-
-依存に入れる場合は、インストール後にセットアップを実行してください：
-
-```bash
-npm i -D cursor-sdd
-npx cursor-sdd --mode assign
-```

package/assign/commands/README.md

@@ -1,4 +0,0 @@
-# assign/commands
-
-アサイン時専用の Cursor コマンド定義を置く場所です。
-既定の `/init` などとは別内容にしたい場合、このディレクトリを編集してください。

package/assign/rules/README.md

@@ -1,3 +0,0 @@
-# assign/rules
-
-アサイン時専用のルールを置く場所です。既存プロジェクトのガイドラインに合わせてここを編集してください。

package/assign/templates/README.md

@@ -1,3 +0,0 @@
-# assign/templates
-
-アサイン時専用のテンプレートを置く場所です。不要なら空のままでも構いません。

package/new/templates/specs/requirements-init.md

@@ -1,8 +0,0 @@
-# 要件ドキュメント
-
-## プロジェクト説明（入力）
-{{PROJECT_DESCRIPTION}}
-
-## 要件
-<!-- /kiro:spec-requirements フェーズで生成 -->
-

package/new/templates/specs/tasks.md

@@ -1,21 +0,0 @@
-# 実装計画
-
-## タスク形式テンプレート
-
-作業分解に適したパターンを使用：
-
-### メジャータスクのみ
-- [ ] {{NUMBER}}. {{TASK_DESCRIPTION}}{{PARALLEL_MARK}}
-  - {{DETAIL_ITEM_1}} *（必要な場合のみ詳細を含める。タスクが単独で成立する場合は箇条書きを省略。）*
-  - _要件: {{REQUIREMENT_IDS}}_
-
-### メジャー + サブタスク構造
-- [ ] {{MAJOR_NUMBER}}. {{MAJOR_TASK_SUMMARY}}
-- [ ] {{MAJOR_NUMBER}}.{{SUB_NUMBER}} {{SUB_TASK_DESCRIPTION}}{{SUB_PARALLEL_MARK}}
-  - {{DETAIL_ITEM_1}}
-  - {{DETAIL_ITEM_2}}
-  - _要件: {{REQUIREMENT_IDS}}_ *（IDのみ。説明や括弧を追加しない。）*
-
-> **並列マーカー**: 並列実行可能なタスクにのみ` (P)`を付加。`--sequential`モードで実行する場合はマーカーを省略。
->
-> **オプションのテストカバレッジ**: 受け入れ基準に関連する延期可能なテスト作業のサブタスクの場合、チェックボックスを`- [ ]*`としてマークし、詳細の箇条書きで参照要件を説明。