/zen:init

zen workflow の初回セットアップウィザード

---

このコマンドを実行したら、以下のフェーズを順番に実行してください。

Phase 1: 環境チェック

1.1 gh CLI のインストール確認

gh --version

インストールされていない場合は、ユーザーにインストールを案内して終了:

• macOS: brew install gh
• Linux: https://github.com/cli/cli/blob/trunk/docs/install_linux.md
• Windows: winget install GitHub.cli

1.2 GitHub 認証状態の確認

gh auth status

認証されていない場合は gh auth login を案内して終了。

1.3 リポジトリ情報の取得

gh repo view --json owner,name,id,url

Git リポジトリでない、または GitHub リポジトリでない場合はエラーを表示して終了。

---

Phase 2: プロジェクト種別の判定

2.1 ファイル構成から自動推定

以下の順序でチェック:

1. webapp: package.json が存在し、以下のいずれかを含む

   • dependencies に react, vue, angular, svelte, next, nuxt
   • vite.config.*, webpack.config.* が存在

2. library: package.json が存在し、main または exports フィールドがある

3. cli: 以下のいずれか

   • pyproject.toml に [project.scripts] セクションがある
   • package.json に bin フィールドがある
   • Cargo.toml に [[bin]] セクションがある

4. documentation: 以下のいずれかが存在

   • mkdocs.yml, docusaurus.config.js, vuepress.config.*
   • docs/ ディレクトリのみで構成

5. generic: 上記に該当しない場合

2.2 ユーザー確認

AskUserQuestion で推定結果を確認:

プロジェクト種別を確認してください:
- webapp: Web アプリケーション
- library: OSS ライブラリ
- cli: CLI ツール
- documentation: ドキュメントサイト
- generic: 汎用プロジェクト

---

Phase 3: GitHub Projects 設定

3.1 既存 Projects の検出

gh project list --owner {owner} --format json

3.2 選択肢を提示

AskUserQuestion で選択:

• 既存の Projects と連携する（リストから選択）
• 新規 Projects を作成する

3.3 新規作成の場合

gh project create --owner {owner} --title "{repo-name}" --format json

3.4 フィールドの確認・設定

gh project field-list {project-number} --owner {owner} --format json

必要なフィールドが存在しない場合は作成:

# Priority フィールド
gh project field-create {project-number} --owner {owner} --name "Priority" --data-type "SINGLE_SELECT" --single-select-options "High,Medium,Low"

# Complexity フィールド
gh project field-create {project-number} --owner {owner} --name "Complexity" --data-type "SINGLE_SELECT" --single-select-options "XS,S,M,L,XL"

Status フィールドに "In Review" がない場合は GraphQL で追加:

gh api graphql -f query='
mutation {
  updateProjectV2Field(input: {
    fieldId: "{status-field-id}"
    singleSelectOptions: [
      {name: "Todo", color: GRAY, description: "Not started"}
      {name: "In Progress", color: YELLOW, description: "Work in progress"}
      {name: "In Review", color: BLUE, description: "Under review"}
      {name: "Done", color: GREEN, description: "Completed"}
    ]
  }) {
    projectV2Field { ... on ProjectV2SingleSelectField { name } }
  }
}'

---

Phase 4: テンプレート生成

4.1 zen-config.yml の生成

プロジェクトルートに zen-config.yml を作成（既存がある場合は確認）:

# zen-workflow configuration
version: "1.0"

project:
  type: {detected-type}
  name: "{repo-name}"

github:
  projects:
    enabled: true
    project_number: {project-number}
    owner: "{owner}"

branch:
  pattern: "{type}/issue-{number}-{slug}"
  types:
    feature: "feat"
    bugfix: "fix"
    documentation: "docs"
    refactor: "refactor"
    chore: "chore"

commit:
  style: conventional
  enforce: false

language: auto

4.2 Issue テンプレートの確認

.github/ISSUE_TEMPLATE/ が存在しない場合は、ユーザーに作成を提案。

---

Phase 5: 完了報告

設定サマリーを表示

🧘 zen workflow セットアップ完了

## 設定内容
- プロジェクト種別: {type}
- GitHub Projects: {project-url}
- 設定ファイル: zen-config.yml

## 次のステップ
1. `/zen:issue:list` で既存 Issue を確認
2. `/zen:issue:create` で新規 Issue を作成
3. `/zen:issue:start <番号>` で作業開始

詳細は `/zen:workflow` でワークフロー全体を確認できます。

---

使用可能なツール

• Bash: gh コマンド実行
• Read: ファイル読み取り
• Write: 設定ファイル生成
• Glob: ファイル検索
• AskUserQuestion: ユーザー確認