# A16_プロジェクト初期化ガイド - AI/人間協創プロジェクト構築システム（A24形式統一版）

**Version**: 2.0.0
**Last Updated**: 2025-08-17
**Type**: 効率的プロジェクト初期化の統合支援システム（5Stage + 統合プロンプト）

## 📌 概要

このガイドは、A12で確定した企画・コンセプトを基に実際のプロジェクトフォルダとファイル群を体系的に生成するための**A24形式統一プロンプト**を提供します。

> ℹ️ **CLI移行メモ**: 本ガイドに記載されている `novel` コマンドは歴史的資料です。現在は `./bin/noveler` と MCP ツールが正規手順となります。最新情報は [docs/migration/novel_to_noveler.md](migration/novel_to_noveler.md) を参照し、必要に応じてコマンドを読み替えてください。

**対象工程**: 企画設計 → プロジェクト初期化 → 世界観構築 → キャラクター設計
**最適化対象**: Claude Code実行に特化した統合プロジェクト構築システム

## 🎯 プロジェクト初期化の目的と目標

### 設計目標
- **構造化**: 長期開発に対応する適切なフォルダ構成
- **最適化**: ジャンル特性に合わせたテンプレート選択
- **自動化**: 手動作業を最小化した効率的セットアップ
- **統合性**: A20・A22ガイドとの完全連携

### 設計の5段階アプローチ
1. **プロジェクト基盤設計**: 基本設定とフォルダ構造
2. **テンプレート選択**: ジャンル特性に応じた最適化
3. **ファイル生成**: 必要ファイルの自動生成
4. **設定カスタマイズ**: プロジェクト固有の調整
5. **動作検証**: 初期化完了と品質確認

## 📋 前提条件

**A14_企画設計・コンセプト策定ガイド完了必須項目**：
- [ ] 企画・コンセプト確定
- [ ] ジャンル決定
- [ ] プロジェクト名決定
- [ ] 基本設定明確化

## 🏗️ Stage 1: プロジェクト基盤設計

```
あなたは `Project Foundation Builder`（プロジェクト基盤構築者）です。
Web小説「なろう」向けのプロジェクトの基盤となるフォルダ構造と基本設定を構築してください。

**インプット**
* A12で確定した企画・コンセプト
* プロジェクト名（日本語可）
* ジャンル（ファンタジー/SF/現代/恋愛等）

> **ジャンル定義メモ**
> Canonical genres are limited to Fantasy / Romance / Mystery / Slice of Life /
> Science Fiction. Legacy labels（例: ホラー・文学・その他）は後方互換のため
> 解釈されますが、自動テンプレート選択の優先順位には影響しません。
* 企画書ファイル（`{PROJECT_ROOT}/10_企画/企画書.yaml`）

**作業内容**

1. プロジェクト名の最適化：
   * 日本語プロジェクト名の処理
   * フォルダ名用の英数字変換
   * 特殊文字の適切な処理
   * 既存フォルダとの重複回避

2. 基本フォルダ構造の作成：
```yaml
プロジェクト構造:
  10_企画/:
    - 企画書.yaml
    - 読者分析.yaml
    - 市場調査.yaml
  20_プロット/:
    - 全体構成.yaml
    - 章別プロット/
  30_設定集/:
    - 世界観.yaml
    - キャラクター.yaml
    - [ジャンル固有].yaml
  40_原稿/:
    - [空フォルダ：執筆時に使用]
  50_管理資料/:
    - 話数管理.yaml
    - 品質チェック設定.yaml
  90_アーカイブ/:
    - [バックアップ用]
```

3. プロジェクト設定.yamlの生成：
   * 基本情報（プロジェクト名・作者・ジャンル）
   * 執筆設定（更新頻度・文字数目標）
   * 品質設定（チェック基準・目標スコア）
   * A20・A22連携設定

4. CLIランチャーの設定：
   * プロジェクト専用`novel`コマンド
   * 環境変数の自動設定
   * パス解決の最適化
   * A30執筆システムとの連携

**出力指示**
* フォルダ構造をYAML形式で明示すること
* プロジェクト設定を完全に定義すること
* 次段階で必要な情報を準備すること
* エラー処理と回復手順を含めること

**自己検証チェックリスト**
* [ ] フォルダ構造が標準に準拠しているか
* [ ] プロジェクト名が適切に処理されているか
* [ ] 必要な設定ファイルが準備されているか
* [ ] 権限とアクセス設定が正しいか
* [ ] A20・A22への連携準備が完了しているか
```

## 🎨 Stage 2: テンプレート選択・最適化

```
あなたは `Template Optimization Specialist`（テンプレート最適化専門家）です。
プロジェクトのジャンルと特性に基づいて最適なテンプレートを選択・カスタマイズしてください。

**インプット**
* Stage 1完了のプロジェクト基盤
* ジャンル特性と要求事項
* 企画の差別化ポイント
* プロジェクト設定.yaml

**作業内容**

1. テンプレート自動選択アルゴリズム：
```yaml
選択基準:
  ジャンル適合性: 40%  # ジャンル固有の設定ファイル
  執筆スタイル: 30%    # 文体ガイドライン・品質基準
  更新頻度: 20%        # 話数管理構造・スケジュール
  汎用性: 10%          # カスタマイズ容易さ・拡張性
```

2. ジャンル別テンプレート適用：
   * **ファンタジー**: 魔法システム.yaml、スキル管理、ステータス対応
   * **SF**: 技術設定.yaml、科学考証メモ、用語集強化
   * **現代**: 現実設定.yaml、社会問題、時事反映
   * **恋愛**: 関係性マップ.yaml、感情曲線、イベント管理

3. カスタマイズ適用：
   * 企画固有の設定要素追加
   * 不要なテンプレート要素削除
   * A24形式プロンプトとの連携設定
   * Claude Code最適化

4. 品質基準の初期設定：
   * ジャンル別品質チェック項目
   * A31自動評価の閾値設定
   * 執筆ペース管理設定
   * バックアップ・バージョン管理

**出力指示**
* 選択テンプレートとその理由を明示すること
* カスタマイズ内容を詳細化すること
* ジャンル固有ファイルを生成すること
* 品質基準を設定すること

**自己検証チェックリスト**
* [ ] 最適なテンプレートが選択されているか
* [ ] ジャンル特性が適切に反映されているか
* [ ] 企画の独自性が考慮されているか
* [ ] 品質基準が現実的に設定されているか
* [ ] Claude Code連携が準備されているか
```

## 📁 Stage 3: ファイル生成・配置

```
あなたは `File Generation Coordinator`（ファイル生成統括者）です。
選択されたテンプレートに基づいて必要なファイルを生成・配置してください。

**インプット**
* Stage 2完了のテンプレート設定
* A12企画設計の詳細内容
* ジャンル固有の要求事項
* テンプレート設定ファイル

**作業内容**

1. 企画ファイルの自動生成：
```yaml
10_企画/:
  企画書.yaml: "A12の内容を構造化して転記"
  読者分析.yaml: "ターゲット読者ペルソナ"
  市場調査.yaml: "競合分析・差別化戦略"
```

2. 設定ファイルのテンプレート配置：
```yaml
30_設定集/:
  世界観.yaml: "A20用テンプレート（ジャンル特化）"
  キャラクター.yaml: "A22用テンプレート（5層構造）"
  魔法システム.yaml: "ファンタジー限定"
  技術設定.yaml: "SF限定"
  用語集.yaml: "全ジャンル共通"
```

3. 管理ファイルの初期化：
```yaml
50_管理資料/:
  話数管理.yaml: "更新頻度対応構成"
  品質チェック設定.yaml: "ジャンル別初期値"
  執筆進捗.yaml: "スケジュール管理"
  バックアップ設定.yaml: "自動保存設定"
```

4. 連携ファイルの準備：
   * A24プロンプト連携設定
   * A30執筆システム設定
   * A31品質チェック設定
   * Git管理設定

**出力指示**
* 生成ファイル一覧を明示すること
* 各ファイルの役割を説明すること
* テンプレート内容を適切に記述すること
* 連携設定を完全に構成すること

**自己検証チェックリスト**
* [ ] 必要なファイルがすべて生成されているか
* [ ] ファイル内容が適切に記述されているか
* [ ] A12の企画内容が正しく反映されているか
* [ ] ジャンル固有ファイルが配置されているか
* [ ] 後続工程への準備が完了しているか
```

## ⚙️ Stage 4: 設定カスタマイズ・調整

```
あなたは `Project Configuration Specialist`（プロジェクト設定専門家）です。
生成されたファイルをプロジェクト固有の要求に合わせてカスタマイズしてください。

**インプット**
* Stage 3完了のファイル生成
* 作者の執筆スタイル・ペース
* プロジェクト固有の要求
* 生成された全ファイル

**作業内容**

1. 執筆環境の個人最適化：
   * 執筆可能時間に応じたスケジュール調整
   * 1話あたり文字数の現実的設定
   * ストック管理の個人化
   * 品質目標の段階的設定

2. 品質チェック設定の調整：
```yaml
品質設定:
  初心者モード: "基本項目のみ・優しい基準"
  標準モード: "標準項目・バランス重視"
  上級モード: "全項目・厳格基準"
  カスタム: "個別調整・特殊要求対応"
```

3. A24統合プロンプトとの連携強化：
   * A20世界観構築への自動引き継ぎ設定
   * A22キャラクター設計への情報渡し
   * A30執筆システムとの統合設定
   * Cross-reference機能の有効化

4. 自動化・効率化設定：
   * バックアップ自動化
   * 品質チェック自動実行
   * 進捗レポート自動生成
   * Git連携の自動化

**出力指示**
* カスタマイズ内容を詳細記録すること
* 設定変更の理由を明示すること
* 自動化設定を完全に構成すること
* トラブルシューティング情報を含めること

**自己検証チェックリスト**
* [ ] 執筆環境が個人に最適化されているか
* [ ] 品質設定が現実的で継続可能か
* [ ] A24プロンプトとの連携が設定されているか
* [ ] 自動化が適切に構成されているか
* [ ] カスタマイズが過度でないか
```

## ✅ Stage 5: 動作検証・完了確認

```
あなたは `Project Validation Engineer`（プロジェクト検証技術者）です。
初期化されたプロジェクトの動作を検証し、次工程への準備完了を確認してください。

**インプット**
* Stage 4完了の全設定
* プロジェクトの全ファイル
* 連携システムの動作状況
* カスタマイズ設定内容

**作業内容**

1. ファイル・フォルダ構造の検証：
   * 全必須ファイルの存在確認
   * フォルダ権限・アクセス権確認
   * ファイル形式・エンコーディング確認
   * 相互参照の整合性確認

2. 設定ファイルの整合性チェック：
   * YAML形式の構文確認
   * 設定値の妥当性確認
   * 矛盾・競合設定の検出
   * デフォルト値の適切性確認

3. 連携システムの動作確認：
   * A20世界観構築ガイドとの連携テスト
   * A22キャラクター設計ガイドとの連携テスト
   * A30執筆システムとの統合確認
   * Claude Code実行環境の確認

4. 初期化完了レポートの生成：
   * プロジェクト概要サマリー
   * 設定内容の詳細記録
   * 次工程への引き継ぎ事項
   * トラブルシューティングガイド
   * Quick Start手順書

5. 品質保証と最終確認：
   * 初期化品質スコアの算出
   * 潜在的問題の予防的修正
   * パフォーマンス最適化
   * セキュリティ設定確認

**出力指示**
* 検証レポートをMarkdown形式で出力すること
* 問題発見時は修正手順を提示すること
* 次工程開始チェックリストを作成すること
* 初期化成功の明確な宣言を行うこと

**自己検証チェックリスト**
* [ ] 全ファイルが正常に動作するか
* [ ] 設定に矛盾・エラーがないか
* [ ] 後続工程への準備が完了しているか
* [ ] プロジェクトが即座に使用可能か
* [ ] ドキュメントが完整で分かりやすいか
```

---

## 🚀 統合プロジェクト初期化プロンプト（コピペ実行用）

```yaml
# ===== A12 プロジェクト初期化 統合プロンプト =====
# 実行前に project_name と enterprise_info を設定してください

task: "プロジェクト初期化"
mode: "comprehensive"  # quick / standard / comprehensive から選択

# 基本設定（必須）
project_info:
  project_name: "転生魔法学園"  # 日本語可
  author_name: "山田太郎"
  genre: "ファンタジー"  # ファンタジー / SF / 現代 / 恋愛
  concept: "異世界転生・魔法学園もの"

# 企画連携
enterprise_info:
  source_plan: "./10_企画/企画書.yaml"  # A12で作成した企画書
  differentiation_points: ["魔法×プログラミング", "デバッグ要素", "システム管理"]
  target_readers: "20-30代男性・ファンタジー好き"

# 執筆設定
writing_config:
  update_frequency: "週2-3回"  # 毎日 / 週2-3回 / 週1回 / 不定期
  episode_length: 3000  # 1話あたり文字数
  writing_style: "ライトノベル調"  # ライトノベル調 / シリアス / コメディ

# 実行ステージ
execute_stages:
  - stage_1_foundation    # プロジェクト基盤構築
  - stage_2_template      # テンプレート選択・最適化
  - stage_3_generation    # ファイル生成・配置
  - stage_4_customization # 設定カスタマイズ・調整
  - stage_5_validation    # 動作検証・完了確認

# 品質目標
quality_targets:
  structure_score: 90     # 構造品質スコア
  integration_score: 85   # 連携整合性スコア
  usability_score: 85     # 使いやすさスコア
  performance_score: 90   # パフォーマンススコア

# 出力設定
output:
  format: "structured_files"
  save_path: "auto_detect"  # プロジェクトルート/
  generate_structure:
    - "10_企画/"
    - "20_プロット/"
    - "30_設定集/"
    - "40_原稿/"
    - "50_管理資料/"
    - "90_アーカイブ/"
  generate_files:
    - "プロジェクト設定.yaml"
    - "novel"  # CLIランチャー
    - "初期化完了レポート.md"
  a20_a22_preparation: true
```

**👆 これをClaude Codeにコピペして実行してください**

## 🚀 クイックスタート

### 基本的な初期化

```bash
# インタラクティブモードで開始
novel init

# プロジェクト名を指定して開始
novel init --name "転生魔法学園"

# ジャンルを指定して開始
novel init --genre fantasy --name "竜と魔法の物語"
```

### 初期化プロセス

### インタラクティブ初期化の流れ
```
$ novel init

🎯 小説プロジェクト初期化ウィザード (A24形式統一版)

📋 A12企画設計情報の取得
   企画書の場所: ./10_企画/企画書.yaml ✓
   コンセプト: 異世界転生・魔法学園もの ✓
   差別化要素: 魔法×プログラミング ✓

🎨 テンプレート最適化
   ジャンル: ファンタジー → fantasy_light選択 ✓
   特化機能: 魔法システム管理、スキル追跡 ✓
   A24統合: 世界観・キャラクター連携設定 ✓

📁 プロジェクト構造生成
   基盤フォルダ作成中... ✓
   テンプレートファイル配置中... ✓
   設定ファイル生成中... ✓
   A20・A22連携準備中... ✓

⚙️ カスタマイズ適用
   執筆設定: 週2-3回更新、3000字/話 ✓
   品質基準: 標準モード、A31連携 ✓
   自動化設定: バックアップ・品質チェック ✓

✅ 初期化完了！ 次のコマンドで開始できます：
   novel world create  # A20世界観構築
   novel character create  # A22キャラクター設計
```

---

## 🎯 実行モード詳細

### Quick モード（30分-1時間）
```yaml
quick_mode:
  stages: [1, 3]  # 基盤構築とファイル生成のみ
  quality_target: 70-75
  use_case: "プロトタイプ作成・アイデア検証"
```

### Standard モード（1-2時間）
```yaml
standard_mode:
  stages: [1, 2, 3, 4]  # 検証以外すべて
  quality_target: 80-85
  use_case: "通常のプロジェクト初期化"
```

### Comprehensive モード（2-3時間）
```yaml
comprehensive_mode:
  stages: [1, 2, 3, 4, 5]  # 全ステージ実行
  quality_target: 85-90
  additional_features:
    - "完全な動作検証"
    - "詳細カスタマイズ"
    - "パフォーマンス最適化"
    - "トラブルシューティングガイド"
  use_case: "重要プロジェクト・長期連載"
```

## 📋 初期化オプション

### コマンドラインオプション

```bash
# 全オプション指定
novel init \
  --name "異世界転生物語" \
  --author "作者名" \
  --genre fantasy \
  --style light \
  --frequency weekly

# テンプレート直接指定
novel init --template fantasy_light

# 非対話モード（デフォルト値使用）
novel init --non-interactive
```

### 設定可能な項目

| 項目 | オプション | 説明 |
|------|-----------|------|
| name | --name | プロジェクト名（日本語可） |
| author | --author | 作者名 |
| genre | --genre | ジャンル（fantasy/sf/mystery/romance/slice_of_life） |
| style | --style | 執筆スタイル（light/serious/comedy/dark） |
| frequency | --frequency | 更新頻度（daily/weekly/monthly/irregular） |

## 🎨 テンプレート選択

### 自動選択アルゴリズム

システムは以下の要素を考慮して最適なテンプレートを選択：

1. **ジャンル適合性** (40%)
   - ジャンル固有の設定ファイル
   - 世界観テンプレート
   - キャラクター設定構造

2. **執筆スタイル** (30%)
   - 文体ガイドライン
   - 品質基準の初期値
   - 推奨文字数設定

3. **更新頻度** (20%)
   - 話数管理構造
   - 執筆スケジュール
   - バックアップ設定

4. **汎用性** (10%)
   - カスタマイズの容易さ
   - 拡張性

### 利用可能なテンプレート

```yaml
fantasy_light:      # ファンタジー・ライトノベル向け
  特徴: 魔法システム、スキル管理、ステータス表示対応

fantasy_serious:    # ファンタジー・シリアス向け
  特徴: 詳細な世界観設定、歴史年表、地図管理

sf_technical:       # SF・技術系向け
  特徴: 技術設定管理、科学考証メモ、用語集強化

mystery_classic:    # ミステリー向け
  特徴: 伏線管理、トリック設計、登場人物相関図

romance_light:      # 恋愛・ライト向け
  特徴: 関係性マップ、感情曲線、イベント管理

universal_basic:    # 汎用基本テンプレート
  特徴: 最小構成、高いカスタマイズ性
```

## 📁 作成されるプロジェクト構造

### A24形式統一版の標準構造
```
転生魔法学園/
├── プロジェクト設定.yaml    # 基本設定（A24最適化）
├── novel                    # プロジェクト専用CLIランチャー
├── 10_企画/
│   ├── 企画書.yaml         # A12からの自動転記
│   ├── 読者分析.yaml       # ペルソナ・ターゲット設定
│   ├── 市場調査.yaml       # 競合分析・差別化戦略
│   └── 差別化戦略.yaml     # USP・独自性管理
├── 20_プロット/
│   ├── 全体構成.yaml       # マスタープロット（A24連携）
│   ├── 章別プロット/       # A24プロンプト実行結果
│   └── プロット実行ログ/   # A24実行履歴
├── 30_設定集/
│   ├── 世界観.yaml         # A20用テンプレート
│   ├── キャラクター.yaml   # A22用テンプレート（5層構造）
│   ├── 魔法システム.yaml   # ファンタジー特化
│   ├── 用語集.yaml         # 固有名詞管理
│   └── 設定整合性.yaml     # 矛盾防止管理
├── 40_原稿/               # 執筆フォルダ（A30連携）
│   └── 執筆ガイド/        # A30実行時参照
├── 50_管理資料/
│   ├── 話数管理.yaml       # 更新・スケジュール管理
│   ├── 品質チェック設定.yaml # A31連携設定
│   ├── 執筆進捗.yaml       # 進捗追跡
│   └── バックアップ設定.yaml # 自動保存設定
└── 90_アーカイブ/         # バージョン管理・アーカイブ
    └── 初期化ログ/        # 初期化時の記録
```

## 🎯 ジャンル別A24最適化

### ファンタジー選択時
```yaml
特化ファイル:
  魔法システム.yaml: "A20世界観構築で詳細化"
  スキル管理.yaml: "成長システム・バランス調整"
  種族設定.yaml: "A22キャラクター設計連携"
A24連携:
  - A20_Stage2: 魔法システム詳細設計
  - A22_Stage2: 種族特性と能力連携
  - A30_STEP3: 魔法描写の専門化
```

### SF選択時
```yaml
特化ファイル:
  技術設定.yaml: "科学技術体系・考証管理"
  年表.yaml: "時系列・歴史管理"
  科学考証.yaml: "リアリティ確保・検証"
A24連携:
  - A20_Stage1: 科学技術基盤設計
  - A22_Stage2: 技術者キャラクター特化
  - A30_STEP4: 技術説明の自然な露出
```

### 現代・恋愛選択時
```yaml
特化ファイル:
  現実設定.yaml: "社会情勢・時事問題"
  関係性マップ.yaml: "恋愛・人間関係管理"
  感情曲線.yaml: "感情的展開の設計"
A24連携:
  - A20_Stage3: 現代社会の文化設計
  - A22_Stage3: 関係性発展プラン
  - A30_STEP8: 感情表現の個別化
```

## ⚙️ 高度な設定

### カスタムテンプレート

```bash
# カスタムテンプレートの登録
novel template register ./my_template/ --name "my_custom"

# カスタムテンプレートで初期化
novel init --template my_custom
```

### 既存プロジェクトの移行

```bash
# 既存フォルダをプロジェクト化
novel init --migrate ./existing_novel/

# 部分的な初期化（不足ファイルのみ）
novel init --partial
```

### バッチ初期化

```bash
# 設定ファイルから複数プロジェクト作成
novel init --batch projects.yaml
```

## ⚠️ よくある失敗パターンと対策

### 典型的な失敗と予防策
```yaml
失敗パターン:
  テンプレート選択ミス:
    症状: "後からジャンル変更が困難"
    問題: "再初期化が必要、作業の重複"
    対策:
      - "A12企画設計での明確化"
      - "ジャンル特性の事前理解"
      - "プロトタイプでの事前検証"

  設定過多の初期化:
    症状: "使わないファイルが大量生成"
    問題: "混乱、管理負荷増大"
    対策:
      - "必要最小限の設定で開始"
      - "段階的な機能追加"
      - "quickモードでの試行"

  A24連携設定漏れ:
    症状: "後続工程で連携エラー"
    問題: "A20・A22が正常動作しない"
    対策:
      - "validation段階での連携確認"
      - "統合テストの実行"
      - "設定ファイルの構文チェック"

  パス・権限問題:
    症状: "ファイル作成・読み書きエラー"
    問題: "プロジェクトが使用不能"
    対策:
      - "書き込み権限の事前確認"
      - "パス名の文字制限遵守"
      - "既存ファイルの保護"

  カスタマイズ過度:
    症状: "設定が複雑すぎて管理不能"
    問題: "メンテナンス困難、エラー多発"
    対策:
      - "標準設定をベースに最小変更"
      - "変更記録の詳細保持"
      - "設定の段階的調整"
```

## 📝 初期化後の推奨手順

### 1. A12企画内容の自動反映確認
```bash
# 企画書の自動転記確認
novel validate project-setup
# A12からの情報が正しく反映されているか検証
```

### 2. A24統合プロンプト準備確認
```bash
# A20世界観構築の準備確認
novel world check-readiness
# A22キャラクター設計の準備確認
novel character check-readiness
```

### 3. 次工程への移行
```bash
# A20世界観構築の開始
novel world create --use-project-settings
# または A22キャラクター設計の開始
novel character create --use-project-settings
```

## ✅ プロジェクト初期化完了チェックリスト

### 初期化前準備段階
- [ ] A12企画設計完了
- [ ] プロジェクト名確定
- [ ] ジャンル決定
- [ ] 初期化に十分な時間確保（2-3時間推奨）

### Stage 1: 基盤構築段階
- [ ] フォルダ構造作成
- [ ] プロジェクト設定.yaml生成
- [ ] CLIランチャー設定
- [ ] 権限・アクセス設定

### Stage 2: テンプレート段階
- [ ] 最適テンプレート選択
- [ ] ジャンル特化設定
- [ ] 品質基準設定
- [ ] A24連携準備

### Stage 3: ファイル生成段階
- [ ] 企画ファイル自動生成
- [ ] 設定テンプレート配置
- [ ] 管理ファイル初期化
- [ ] 連携ファイル準備

### Stage 4: カスタマイズ段階
- [ ] 執筆環境最適化
- [ ] 品質チェック調整
- [ ] 自動化設定
- [ ] A24統合強化

### Stage 5: 検証段階
- [ ] ファイル構造検証
- [ ] 設定整合性確認
- [ ] 連携動作確認
- [ ] 完了レポート生成

### 最終確認
- [ ] 全ファイル正常生成
- [ ] 品質スコア達成（85点以上）
- [ ] A20・A22準備完了
- [ ] `novel project validate`で検証完了

## ⚠️ 注意事項・制約

### プロジェクト名・パス
- 日本語使用可能（自動エスケープ）
- 特殊文字は安全な代替文字に自動変換
- 既存フォルダとの重複は自動回避
- パス長制限（Windows: 260文字）に注意

### テンプレート・カスタマイズ
- A24形式最適化済みテンプレート使用
- 後からのジャンル変更は再初期化推奨
- カスタマイズは段階的に実施
- 標準設定からの最小変更を推奨

### ファイル管理・バックアップ
- 既存ファイルは自動保護（上書き防止）
- --forceオプションで強制上書き可能
- 自動バックアップ（.bak拡張子）作成
- Git連携による履歴管理を推奨

## 🔧 トラブルシューティング

### 初期化失敗の対処
```yaml
症状と対策:
  ディスク容量不足:
    確認: "df -h または dir コマンド"
    対策: "不要ファイル削除、別ドライブ使用"

  書き込み権限エラー:
    確認: "ls -la または icacls コマンド"
    対策: "管理者権限実行、フォルダ権限変更"

  パス名問題:
    確認: "特殊文字・長すぎるパス・予約語"
    対策: "英数字のみ、短縮名使用、safe-nameオプション"

  A12連携エラー:
    確認: "企画書.yamlの存在・形式"
    対策: "A12再実行、手動ファイル修正"
```

### A24連携問題の解決
```yaml
連携エラー対処:
  設定ファイル不整合:
    確認: "yaml形式、必須フィールド、文字エンコーディング"
    対策: "yaml-lint実行、テンプレート再生成"

  A20・A22準備不完全:
    確認: "連携設定ファイル、参照パス"
    対策: "validation再実行、設定ファイル手動調整"

  Claude Code統合エラー:
    確認: "環境変数、プロジェクトパス"
    対策: "環境再設定、CLIランチャー再生成"
```

### 復旧・再実行手順
```bash
# 段階的復旧
novel project reset --partial  # 部分的リセット
novel init --resume            # 中断箇所から再開
novel init --force             # 完全な再初期化

# 診断・検証
novel diagnose --full          # 全体診断
novel project validate         # プロジェクト検証
novel check-dependencies       # 依存関係確認
```

## 📝 Git管理

プロジェクト初期化完了時は適切にバージョン管理を行い、設定の進化を記録しましょう：

### 初期化段階でのコミット
```bash
# 基盤構築完了時
git init
git add プロジェクト設定.yaml novel
git commit -m "feat: プロジェクト基盤構築完了（A24統合版）"

# 全体初期化完了時
git add .
git commit -m "feat: プロジェクト初期化完了（A12 v2.0.0・A20/A22連携）"
```

## 🚀 次のステップ

### 初期化完了後の流れ
```bash
# A20世界観構築への移行
novel world create --use-project-config

# A22キャラクター設計への移行
novel character create --use-project-config

# または両方の並行実行
novel design-phase start
```

### 次工程
- **A20_世界観構築**: プロジェクト設定を活かした世界設計
- **A24_キャラクター設計**: 世界観に生きるキャラクター創造
- **A24_話別プロット作成**: 統合設定を活用したストーリー構築

---

## 📚 関連ガイド

- **前工程**: [A14_企画設計・コンセプト策定ガイド](A14_企画設計・コンセプト策定ガイド.md) - v2.0.0 A24形式統一版
- **次工程**: [A22_世界観構築ガイド](A22_世界観構築ガイド.md) - v3.0.0 A24形式統一版
- **並行工程**: [A24_キャラクター設計ガイド](A24_キャラクター設計ガイド.md) - v4.0.0 A24形式統一版
- **執筆工程**: [A38_執筆プロンプトガイド.md](A38_執筆プロンプトガイド.md) - v5.0.0統合版

## 📈 更新履歴

- **v2.0.0** (2025-08-17): A24形式統一版に全面改訂
  - ロール定義明確化（Project Foundation Builder等）
  - 構造化セクション（インプット→作業内容→出力指示→自己検証）
  - 統合実行プロンプト追加（コピペ実行対応）
  - A20・A22連携強化とClaude Code最適化完了
- **v1.1.0**: テンプレート選択アルゴリズム強化
- **v1.0.0**: 初版リリース

---

**💡 ポイント**: プロジェクト初期化は後続工程の基盤となる重要な段階です。A12で確定した企画を基に、A20・A22との完全連携を前提とした構造を構築します。A24形式による統一されたアプローチで、効率的なプロジェクトセットアップを実現しましょう。

**このプロンプトはA22_世界観構築ガイド.md、A24_キャラクター設計ガイド.md、A38_執筆プロンプトガイド.mdと同等の使いやすさを実現した統一フォーマット版です。**
