# cursor-sdd-package

Cursor IDE 向けの Spec-Driven Development (SDD) テンプレート、ルール、コマンド集。

## インストール

```bash
# 推奨（都度実行・インストール不要）
npx cursor-sdd@latest

# 依存に入れたい場合（必要な時に自分で実行する）
npm i -D cursor-sdd
```

実行時にプロジェクトの `.cursor/` フォルダにファイルがコピーされます。

### 依存として入れた場合の実行

`npm i -D cursor-sdd` しただけでは `.cursor/` は変更しません。セットアップは明示的に実行してください：

```bash
npx cursor-sdd
```

### 強制上書き

既存の `.cursor/` がある場合は同名ファイルがスキップされます。強制上書きする場合：

```bash
npx cursor-sdd --force
```

## 使い方

Cursor IDE で以下のコマンドが使えるようになります：

| コマンド | 説明 |
|---------|------|
| `/requirements` | 要件定義書の生成（推奨入口） |
| `/requirements-import` | 既存要件のインポート（互換運用） |
| `/design` | 技術設計書の作成 |
| `/check-design` | 設計書の検証 |
| `/impl` | 要件・設計に基づく実装の開始 |
| `/review` | 仕様・実装・TDD証跡のレビュー |
| `/trace` | 要件から実装証跡までのトレース生成 |
| `/final-check` | リリース前の最終整合性チェック |
| `/status` | 進捗確認 |
| `/difference-check` | 差分チェック |

### 入口（推奨）

- **まず `/requirements` から開始**: `/requirements <feature-name> <要件/背景メモ>`
- 既に `.cursor/<feature-name>/` があれば、その内容を読み込んで要件を更新
- 未初期化なら、`/requirements` が初期化を兼ねて作成してから要件生成
- 既存記述をそのまま要件化したいときのみ `/requirements-import <feature-name>` を使う

## 含まれるファイル

```
.cursor/
├── commands/          # Cursor コマンド定義
│   ├── requirements.md
│   ├── requirements-import.md
│   ├── design.md
│   ├── check-design.md
│   ├── impl.md
│   ├── review.md
│   ├── trace.md
│   ├── final-check.md
│   ├── status.md
│   └── difference-check.md
├── rules/             # AI ルール・ガイドライン
│   ├── artifacts-generation.md
│   ├── design-principles.md
│   ├── design-review.md
│   ├── design-discovery-full.md
│   ├── design-discovery-light.md
│   ├── ears-format.md
│   ├── frontend.md
│   ├── gap-analysis.md
│   ├── implementation.md
│   ├── gate-invalidation-policy.md
│   └── spec-state-management.md
└── templates/
    ├── artifacts/     # テーブル定義テンプレート
    │   ├── artifacts_rules.md
    │   ├── create-data-model.md
    │   ├── create-feature-list.md
    │   └── create-table-definition.md
    └── specs/         # 仕様書テンプレート
        ├── init.json
        ├── requirements-init.md
        ├── requirements.md
        ├── design.md
        └── research.md
```

## ワークフロー

```
必須:   /requirements -> /design -> /impl -> /trace -> /review -> /final-check
任意:   /requirements-import (要件取り込み時) /difference-check (ブラウンフィールド推奨) /check-design
常時:   /status
```

`spec.json` は各フェーズの承認状態、TDD の RED/GREEN 証跡、レビュー結果、最終チェック結果、トレーサビリティ状態を保持します。Coherence / impact analysis のような依存グラフは軽量版では含めず、必要になった場合の将来拡張として扱います。

## 重複削減の方針（互換ポリシー）

- 現在は `/requirements` と `/requirements-import` を併存させ、ユースケースで使い分ける
- 将来的には `requirements --import` への統合を検討中（互換エイリアス期間を設ける想定）
- 当面は既存コマンド名を維持し、破壊的変更なく運用できる