spec-runner 1.0.0-alpha.1

package/install.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+# =============================================================================
+# spec-runner インストーラー (curl 方式)
+#
+# 使い方:
+#   curl -sSL https://raw.githubusercontent.com/spec-runner/spec-runner/main/install.sh | bash
+#
+# または wget:
+#   wget -qO- https://raw.githubusercontent.com/spec-runner/spec-runner/main/install.sh | bash
+# =============================================================================
+
+set -e
+
+BOLD='\033[1m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+ok()   { echo -e "${GREEN}✓${NC} $*"; }
+warn() { echo -e "${YELLOW}⚠${NC} $*"; }
+info() { echo -e "${CYAN}ℹ${NC} $*"; }
+die()  { echo -e "${RED}ERROR:${NC} $*" >&2; exit 1; }
+
+echo ""
+echo -e "${BOLD}╔════════════════════════════════════════╗${NC}"
+echo -e "${BOLD}║       spec-runner  インストーラー        ║${NC}"
+echo -e "${BOLD}║  AI-driven DDD Phase Gate System       ║${NC}"
+echo -e "${BOLD}╚════════════════════════════════════════╝${NC}"
+echo ""
+
+# ── Node.js チェック ──────────────────────────────────────────────────────────
+if command -v node &>/dev/null; then
+  NODE_VERSION=$(node --version | sed 's/v//')
+  NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d. -f1)
+  if [[ "$NODE_MAJOR" -lt 16 ]]; then
+    die "Node.js 16以上が必要です（現在: v${NODE_VERSION}）\n  https://nodejs.org からインストールしてください"
+  fi
+  ok "Node.js v${NODE_VERSION}"
+else
+  die "Node.js がインストールされていません。\n  https://nodejs.org からインストールしてください"
+fi
+
+# ── jq チェック ───────────────────────────────────────────────────────────────
+if command -v jq &>/dev/null; then
+  ok "jq $(jq --version)"
+else
+  warn "jq が見つかりません。インストールします..."
+  if command -v brew &>/dev/null; then
+    brew install jq
+  elif command -v apt-get &>/dev/null; then
+    sudo apt-get install -y jq
+  elif command -v yum &>/dev/null; then
+    sudo yum install -y jq
+  else
+    die "jq を手動でインストールしてください: https://stedolan.github.io/jq/download/"
+  fi
+  ok "jq インストール完了"
+fi
+
+# ── git チェック ──────────────────────────────────────────────────────────────
+if command -v git &>/dev/null; then
+  ok "git $(git --version | awk '{print $3}')"
+else
+  die "git がインストールされていません"
+fi
+
+echo ""
+info "npx spec-runner を実行します..."
+echo ""
+
+# ── npm/npx で実行 ────────────────────────────────────────────────────────────
+if command -v npx &>/dev/null; then
+  npx spec-runner@latest
+elif command -v npm &>/dev/null; then
+  npm exec spec-runner@latest
+else
+  die "npm/npx が見つかりません。Node.js を再インストールしてください"
+fi

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "spec-runner",
+  "version": "1.0.0-alpha.1",
+  "description": "AI-driven DDD phase gate system — design-first enforcement for Claude Code, Cursor, and Copilot",
+  "license": "MIT",
+  "bin": {
+    "spec-runner": "bin/spec-runner.js"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "keywords": [
+    "ddd",
+    "phase-gate",
+    "ai-development",
+    "design-first",
+    "claude-code",
+    "spec-runner",
+    "laravel",
+    "rails",
+    "django",
+    "nextjs",
+    "spec-kit"
+  ],
+  "files": [
+    "bin/",
+    "templates/",
+    "install.sh",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "enquirer": "^2.3.6",
+    "ora": "^5.4.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TEEE88/spec-runner.git"
+  },
+  "homepage": "https://github.com/TEEE88/spec-runner",
+  "bugs": {
+    "url": "https://github.com/TEEE88/spec-runner/issues"
+  }
+}

package/templates/base/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,43 @@
+## 対象ユースケース
+
+<!-- ./scripts/spec-runner.sh status の出力を貼り付ける -->
+
+## 変更の種別
+
+- [ ] 新規機能（feature/uc-）
+- [ ] 通常修正（fix/）
+- [ ] 緊急修正（hotfix/）
+
+---
+
+## ドキュメント更新チェック
+
+<!-- 変更内容に応じてチェックしてください。不要な項目は N/A と書く -->
+
+| ドキュメント | 更新済み | パス |
+|------------|---------|------|
+| ドメインモデル設計 | [ ] | docs/detailed/*/domain.md |
+| ユースケース設計 | [ ] | docs/detailed/*/usecase.md |
+| テーブル設計 | [ ] | docs/detailed/*/table.md |
+| インフラ設計 | [ ] | docs/detailed/*/infra.md |
+| テスト設計 | [ ] | docs/test-design/*.md |
+| glossary.md | [ ] | docs/glossary.md |
+| ADR | [ ] / N/A | docs/adr/XXX-*.md |
+
+---
+
+## レビュアー向け読み順
+
+1. **設計ドキュメント** `docs/detailed/<UC名>/` — 何を作るか
+2. **ADR** `docs/adr/` — なぜその設計か（該当する場合）
+3. **テスト設計** `docs/test-design/<UC名>.md` — 何を検証するか
+4. **テストコード** — 振る舞いの確認
+5. **実装コード** — 設計との整合性確認
+
+---
+
+## hotfix の場合（追加記入）
+
+- 影響ユースケース:
+- 修正内容の要約:
+- debt.md への記録: [ ] 完了

package/templates/base/.github/workflows/phase-gate-check.yml

@@ -0,0 +1,216 @@
+name: フェーズゲートチェック
+
+on:
+  pull_request:
+    branches: [main, 'aggregate/**']
+
+jobs:
+  gate-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: jq インストール確認
+        run: jq --version
+
+      # ─── spec-runner 設定の読み込み（.spec-runner/config.sh）────────────────
+      - name: spec-runner 設定の読み込み
+        run: |
+          if [[ -f .spec-runner/config.sh ]]; then
+            set -a
+            # shellcheck source=.spec-runner/config.sh
+            source .spec-runner/config.sh
+            set +a
+            echo "DOMAIN_PATH=$DOMAIN_PATH" >> $GITHUB_ENV
+            echo "USECASE_PATH=$USECASE_PATH" >> $GITHUB_ENV
+            echo "INFRA_PATH=$INFRA_PATH" >> $GITHUB_ENV
+            echo "MIGRATION_DIR=$MIGRATION_DIR" >> $GITHUB_ENV
+            echo "SOURCE_EXTENSIONS=$SOURCE_EXTENSIONS" >> $GITHUB_ENV
+            echo "DOMAIN_FORBIDDEN_GREP_PATTERN=$DOMAIN_FORBIDDEN_GREP_PATTERN" >> $GITHUB_ENV
+          else
+            echo "DOMAIN_PATH=src/domain" >> $GITHUB_ENV
+            echo "USECASE_PATH=src/useCase" >> $GITHUB_ENV
+            echo "INFRA_PATH=src/infrastructure" >> $GITHUB_ENV
+            echo "MIGRATION_DIR=" >> $GITHUB_ENV
+            echo "SOURCE_EXTENSIONS=ts tsx js jsx" >> $GITHUB_ENV
+            echo "DOMAIN_FORBIDDEN_GREP_PATTERN=" >> $GITHUB_ENV
+          fi
+
+      # ─── 1. ブランチ命名規則チェック ───────────────────────────────────
+      - name: ブランチ命名規則チェック
+        run: |
+          BRANCH="${{ github.head_ref }}"
+          echo "対象ブランチ: $BRANCH"
+
+          # 許可されるブランチパターン
+          if [[ "$BRANCH" =~ ^(feature/uc-|fix/|hotfix/|aggregate/) ]]; then
+            echo "✓ ブランチ命名: OK ($BRANCH)"
+          else
+            echo "✗ ブランチ命名が規約に違反しています: $BRANCH"
+            echo ""
+            echo "許可されるパターン:"
+            echo "  feature/uc-<ユースケース名>  ← 新機能"
+            echo "  fix/<ユースケース名>-<内容>  ← 通常修正"
+            echo "  hotfix/<内容>               ← 緊急修正"
+            echo "  aggregate/<集約名>           ← 集約ブランチ"
+            exit 1
+          fi
+
+      # ─── 2. ドメイン変更 → 設計ドキュメント更新チェック（config.sh のパスを使用）──
+      - name: ドメインモデル変更時の設計ドキュメント更新チェック
+        env:
+          DOMAIN_PATH: ${{ env.DOMAIN_PATH }}
+          USECASE_PATH: ${{ env.USECASE_PATH }}
+          MIGRATION_DIR: ${{ env.MIGRATION_DIR }}
+        run: |
+          ERRORS=0
+
+          CHANGED=$(git diff --name-only origin/${{ github.base_ref }}...HEAD)
+          echo "変更ファイル:"
+          echo "$CHANGED"
+          echo ""
+
+          # DOMAIN_PATH が変更されたら docs/detailed/*/domain.md も更新が必要
+          if [[ -n "$DOMAIN_PATH" ]]; then
+            DOMAIN_CHANGED=$(echo "$CHANGED" | grep -E "^${DOMAIN_PATH}/" || true)
+            if [[ -n "$DOMAIN_CHANGED" ]]; then
+              DETAIL_DOC_CHANGED=$(echo "$CHANGED" | grep -E 'docs/detailed/.*/domain\.md' || true)
+              if [[ -z "$DETAIL_DOC_CHANGED" ]]; then
+                echo "✗ $DOMAIN_PATH/ が変更されましたが docs/detailed/*/domain.md が更新されていません"
+                echo "$DOMAIN_CHANGED" | sed 's/^/    /'
+                ERRORS=$((ERRORS + 1))
+              else
+                echo "✓ $DOMAIN_PATH/ 変更 → domain.md 更新確認"
+              fi
+            fi
+          fi
+
+          # USECASE_PATH が変更されたら docs/detailed/*/usecase.md も更新が必要
+          if [[ -n "$USECASE_PATH" ]]; then
+            USECASE_CHANGED=$(echo "$CHANGED" | grep -E "^${USECASE_PATH}/" || true)
+            if [[ -n "$USECASE_CHANGED" ]]; then
+              USECASE_DOC_CHANGED=$(echo "$CHANGED" | grep -E 'docs/detailed/.*/usecase\.md' || true)
+              if [[ -z "$USECASE_DOC_CHANGED" ]]; then
+                echo "✗ $USECASE_PATH/ が変更されましたが docs/detailed/*/usecase.md が更新されていません"
+                ERRORS=$((ERRORS + 1))
+              else
+                echo "✓ $USECASE_PATH/ 変更 → usecase.md 更新確認"
+              fi
+            fi
+          fi
+
+          # MIGRATION_DIR が変更されたら docs/detailed/*/table.md も更新が必要
+          if [[ -n "$MIGRATION_DIR" ]]; then
+            MIGRATION_CHANGED=$(echo "$CHANGED" | grep -E "^${MIGRATION_DIR}/" || true)
+            if [[ -n "$MIGRATION_CHANGED" ]]; then
+              TABLE_DOC_CHANGED=$(echo "$CHANGED" | grep -E 'docs/detailed/.*/table\.md' || true)
+              if [[ -z "$TABLE_DOC_CHANGED" ]]; then
+                echo "✗ $MIGRATION_DIR/ が変更されましたが docs/detailed/*/table.md が更新されていません"
+                ERRORS=$((ERRORS + 1))
+              else
+                echo "✓ $MIGRATION_DIR/ 変更 → table.md 更新確認"
+              fi
+            fi
+          fi
+
+          if [[ $ERRORS -gt 0 ]]; then
+            echo ""
+            echo "ドキュメントの更新が必要です。コードと設計ドキュメントを同一PRに含めてください。"
+            exit 1
+          fi
+
+          echo ""
+          echo "✓ ドキュメント鮮度チェック: OK"
+
+      # ─── 3. hotfix の負債チェック ──────────────────────────────────────
+      - name: hotfix PRの負債記録チェック
+        run: |
+          BRANCH="${{ github.head_ref }}"
+          if [[ "$BRANCH" =~ ^hotfix/ ]]; then
+            if git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -q 'docs/review/debt.md'; then
+              echo "✓ hotfix: debt.md への記録確認"
+            else
+              echo "✗ hotfix PR では docs/review/debt.md への負債記録が必要です"
+              echo "  ./scripts/spec-runner.sh hotfix を使用してください"
+              exit 1
+            fi
+          fi
+
+      # ─── 4. DDD 依存方向チェック（config.sh の DOMAIN_PATH / DOMAIN_FORBIDDEN_GREP_PATTERN）──
+      - name: DDD レイヤー依存方向チェック
+        env:
+          DOMAIN_PATH: ${{ env.DOMAIN_PATH }}
+          SOURCE_EXTENSIONS: ${{ env.SOURCE_EXTENSIONS }}
+          DOMAIN_FORBIDDEN_GREP_PATTERN: ${{ env.DOMAIN_FORBIDDEN_GREP_PATTERN }}
+        run: |
+          ERRORS=0
+
+          if [[ -z "$DOMAIN_PATH" || ! -d "$DOMAIN_PATH" ]]; then
+            echo "✓ DDD依存方向: スキップ（DOMAIN_PATH 未設定またはディレクトリなし）"
+            exit 0
+          fi
+
+          if [[ -z "$DOMAIN_FORBIDDEN_GREP_PATTERN" ]]; then
+            echo "✓ DDD依存方向: スキップ（DOMAIN_FORBIDDEN_GREP_PATTERN 未設定。.spec-runner/config.sh で設定可能）"
+            exit 0
+          fi
+
+          # ソース拡張子で find して、禁止パターンに一致するファイルを検出
+          EXT_REGEX=".*\\.($(echo "$SOURCE_EXTENSIONS" | tr ' ' '|'))$"
+          VIOLATIONS=$(find "$DOMAIN_PATH" -type f -regextype posix-extended -regex "$EXT_REGEX" 2>/dev/null | xargs grep -l "$DOMAIN_FORBIDDEN_GREP_PATTERN" 2>/dev/null || true)
+          if [[ -n "$VIOLATIONS" ]]; then
+            echo "✗ Domain層が上位層に依存しています（DDD違反）"
+            echo "$VIOLATIONS" | sed 's/^/  /'
+            ERRORS=$((ERRORS + 1))
+          else
+            echo "✓ DDD依存方向: OK"
+          fi
+
+          [[ $ERRORS -eq 0 ]] || exit 1
+
+      # ─── 5. ADR の対応コードリンクチェック ────────────────────────────
+      - name: ADR 対応コードリンクチェック
+        run: |
+          WARNINGS=0
+          if [[ -d "docs/adr" ]]; then
+            for adr in docs/adr/[0-9]*.md; do
+              [[ -f "$adr" ]] || continue
+              # 「## 対応コード」セクションからファイルパスを抽出
+              code_refs=$(awk '/^## 対応コード/{found=1; next} /^## /{found=0} found && /`.*\.(php|ts|tsx)`/{print}' "$adr" | grep -oP '`[^`]+`' | tr -d '`' || true)
+              while IFS= read -r ref; do
+                [[ -z "$ref" ]] && continue
+                if [[ ! -f "$ref" ]]; then
+                  echo "⚠ ADR $(basename $adr): 参照ファイルが存在しません → $ref"
+                  WARNINGS=$((WARNINGS + 1))
+                fi
+              done <<< "$code_refs"
+            done
+          fi
+
+          if [[ $WARNINGS -gt 0 ]]; then
+            echo ""
+            echo "ADRの対応コードリンクを更新してください（警告: ブロックしません）"
+          else
+            echo "✓ ADR対応コードリンク: OK"
+          fi
+
+      # ─── 6. glossary.md の新エンティティチェック（config.sh の DOMAIN_PATH / SOURCE_EXTENSIONS）──
+      - name: 新規Domain classのglossary.md登録チェック
+        env:
+          DOMAIN_PATH: ${{ env.DOMAIN_PATH }}
+          SOURCE_EXTENSIONS: ${{ env.SOURCE_EXTENSIONS }}
+        run: |
+          CHANGED=$(git diff --name-only origin/${{ github.base_ref }}...HEAD)
+          EXT_PATTERN=$(echo "$SOURCE_EXTENSIONS" | tr ' ' '|')
+          NEW_DOMAIN=$(echo "$CHANGED" | grep -E "^${DOMAIN_PATH}/.*\.(${EXT_PATTERN})$" | xargs git diff --diff-filter=A --name-only origin/${{ github.base_ref }}...HEAD 2>/dev/null || true)
+
+          if [[ -n "$NEW_DOMAIN" && -n "$DOMAIN_PATH" ]]; then
+            if echo "$CHANGED" | grep -q 'docs/glossary.md'; then
+              echo "✓ 新規Domainクラス追加 → glossary.md 更新確認"
+            else
+              echo "⚠ 新規Domainクラスが追加されましたが glossary.md が更新されていません"
+              echo "  新しいエンティティ/値オブジェクトにはユビキタス言語の追加が必要です"
+            fi
+          fi

package/templates/base/docs/adr/TEMPLATE.md

@@ -0,0 +1,46 @@
+---
+title: ADR-XXX <タイトル>
+status: 提案 | 承認済み | 置き換え済み（by ADR-YYY）
+date: YYYY-MM-DD
+usecase: <関連ユースケース名>
+---
+
+# ADR-XXX: <タイトル>
+
+## ステータス: 提案
+
+## コンテキスト
+
+<!-- この判断が必要になった背景 -->
+
+## 検討した選択肢
+
+### A: <名前>
+メリット:
+デメリット:
+
+### B: <名前>
+メリット:
+デメリット:
+
+## 決定
+
+<!-- どれを選んだか -->
+
+## 根拠
+
+<!-- なぜその選択肢を選んだか。トレードオフ -->
+
+## 対応コード
+
+<!--
+CIがこのセクションを読んでファイル存在チェックする。
+バッククォートで囲んだファイルパスを列挙すること。
+-->
+
+- `packages/backend/src/Domain/...`
+- `packages/backend/src/Infrastructure/...`
+
+## 影響
+
+<!-- 他の設計・ADRへの影響 -->

package/templates/base/docs/glossary.md

@@ -0,0 +1,51 @@
+# ユビキタス言語辞書
+
+> このファイルはプロジェクト内の用語の**唯一の真実源**。
+> 新しい概念が登場したら、**まずここに追加してから**設計・実装に入ること。
+> `./scripts/spec-runner.sh set-gate glossary_checked` で確認済みフラグを立てること。
+
+---
+
+## 使い方
+
+- 設計ドキュメント（`docs/`） → **日本語** 列を使う
+- コード（クラス名・メソッド名・変数名）→ **英語** 列を使う
+- PHPDoc / JSDoc → 日本語を `@description` に併記する
+
+---
+
+## 顧客管理コンテキスト
+
+| 日本語 | 英語 | コンテキスト | 説明 | 初出 |
+|-------|------|------------|------|------|
+| 顧客 | Customer | 顧客管理 | 当社のサービスを利用する法人または個人 | - |
+| 顧客ステータス | CustomerStatus | 顧客管理 | アクティブ/休止/解約 | - |
+| 連絡先 | Contact | 顧客管理 | 顧客に紐づく連絡先情報 | - |
+| 担当者 | AccountManager | 顧客管理 | 顧客を担当する社内メンバー | - |
+| 対応履歴 | InteractionHistory | 顧客管理 | 顧客とのやりとりの記録 | - |
+
+## 認証コンテキスト
+
+| 日本語 | 英語 | コンテキスト | 説明 | 初出 |
+|-------|------|------------|------|------|
+| ユーザー | User | 認証 | システムにログインするアカウント | - |
+| ロール | Role | 認可 | 権限グループ（管理者/一般） | - |
+
+## 共通
+
+| 日本語 | 英語 | コンテキスト | 説明 | 初出 |
+|-------|------|------------|------|------|
+| 識別子 | Id | 共通 | エンティティを一意に特定する値（ULID） | - |
+| 値オブジェクト | ValueObject | 共通 | 属性値で等価判定されるオブジェクト | - |
+| エンティティ | Entity | 共通 | 同一性（ID）を持つドメインオブジェクト | - |
+| ドメインイベント | DomainEvent | 共通 | ドメインで発生した事実を表すイベント | - |
+| リポジトリ | Repository | 共通 | 永続化・取得を抽象化するインターフェース | - |
+
+---
+
+## 追加ルール
+
+1. 新しい概念 → 実装前にここへ追加
+2. 日本語名変更 → 設計ドキュメントの全使用箇所も更新
+3. 英語名変更 → コードの全使用箇所もリネーム
+4. 「初出」列 → 最初に定義したドキュメントのパスを記載

package/templates/base/docs/review/debt.md

@@ -0,0 +1,8 @@
+# ドキュメント負債
+
+> hotfix 等で緊急対応した際に積み上がる負債を記録する。
+> `./scripts/spec-runner.sh init` 実行時に未消化タスクがあると警告が出る。
+
+---
+
+<!-- hotfix時に自動追記される -->