# A03_番号体系準拠チェック

**役割**: A02番号体系運用ルールの準拠チェックリスト（奇数 - チェック）

**Version**: 1.0.0
**Last Updated**: 2025-08-24
**Type**: 番号体系準拠性の包括的検証・品質保証チェック

> **基本定義・運用（WHAT & HOW）は**: [A02_番号体系定義・運用ガイド.md](A02_番号体系定義・運用ガイド.md)

---

## 🎯 チェック概要

このチェックリストは、A番号体系の準拠性を包括的に検証し、品質保証を行うための実践的ツールです。

### 対象範囲
- **全Aファイルの番号体系準拠性**
- **ファイル間の相互参照整合性**
- **段階・役割分類の正確性**
- **ペア構造（ガイド↔チェック）の完全性**

### 実施タイミング
- **新ファイル作成後**: 必須実施
- **既存ファイル修正後**: 必須実施
- **定期監査**: 月次実施推奨
- **大規模変更時**: リファクタリング後必須

## ✅ Level 1: 基本構造チェック

### 1.1 ファイル命名規則
```yaml
チェック項目:
  - [ ] ファイル名がA{数字2桁}_{内容}.md形式
  - [ ] 数字部分が01-99の範囲内
  - [ ] 内容部分が日本語で具体的
  - [ ] ファイル名重複なし

不合格例:
  - A1_ガイド.md（数字1桁）
  - A001_ガイド.md（数字3桁）
  - A32_guide.md（英語）
  - A32_ガイド.md + A32_マニュアル.md（重複）

合格例:
  - A32_執筆コマンドガイド.md
  - A33_執筆品質管理チェック.md
```

### 1.2 段階分類準拠
```yaml
A0x: 番号体系・メタ管理
  - [ ] A02, A03等が番号体系関連内容
  - [ ] 他段階の作業内容が含まれていない

A1x: 企画段階
  - [ ] 企画・コンセプト策定関連内容
  - [ ] プロジェクト立ち上げ段階の作業

A2x: 設定・プロット作成段階
  - [ ] 世界観・キャラクター・プロット関連
  - [ ] 執筆前の準備作業内容

A3x: 原稿作成段階
  - [ ] 実際の執筆・技術的操作内容
  - [ ] 品質管理・コマンド操作関連

A4x: 推敲・品質向上段階
  - [ ] 執筆後の推敲・品質向上内容
  - [ ] 原稿完成後の作業

A5x: 投稿・運営段階
  - [ ] 投稿・公開・読者対応内容
  - [ ] 運営・マーケティング関連
```

### 1.3 役割分類準拠
```yaml
x0: ワークフロー定義
  - [ ] その段階全体の流れ・プロセス定義
  - [ ] 手順書・フローチャート・概要内容

偶数（x2,x4,x6,x8）: 作業ガイド
  - [ ] 具体的作業手順・技術的操作方法
  - [ ] 実践的内容・操作解説

奇数（x1,x3,x5,x7,x9）: チェックリスト
  - [ ] 品質チェック・確認項目
  - [ ] 直前偶数ファイルに対応するチェック内容
  - [ ] 対象ガイドが明確に特定可能
```

## ✅ Level 2: 内容品質チェック

### 2.1 必須要素存在確認
```yaml
ファイル冒頭:
  - [ ] タイトル（# A{番号}_{内容}）
  - [ ] 役割説明（**役割**: ...（奇数/偶数 - 作業種別））
  - [ ] バージョン情報（**Version**, **Last Updated**）
  - [ ] 相互参照リンク（> **{役割}は**: [{ファイル}]({ファイル})）

ファイル構造:
  - [ ] 目次・セクション構造が論理的
  - [ ] 内容が役割に応じて適切
  - [ ] 重要情報の見落としなし
```

### 2.2 役割整合性確認
```yaml
ワークフロー（x0）:
  - [ ] 段階全体の流れが明確
  - [ ] 他のガイド・チェックとの関係が説明済み
  - [ ] プロセス図・手順が含まれている

作業ガイド（偶数）:
  - [ ] 具体的手順・技術内容
  - [ ] 実行可能な操作説明
  - [ ] 前提条件・事後条件が明確

チェックリスト（奇数）:
  - [ ] 対象ガイドが明確
  - [ ] チェック項目が具体的・検証可能
  - [ ] 合格・不合格基準が明確
```

## ✅ Level 3: 相互参照整合性チェック

### 3.1 参照リンク確認
```yaml
リンク存在確認:
  - [ ] 全ての参照ファイルが実在
  - [ ] リンクパスが正確（相対パス使用）
  - [ ] リンク切れが存在しない

参照方向確認:
  - [ ] 上位ファイルから下位ファイルへの参照
  - [ ] ペアファイル間の双方向参照
  - [ ] 循環参照が存在しない
```

### 3.2 ペア構造整合性
```yaml
ガイド↔チェックペア:
  - [ ] A12 ↔ A13: 企画設計ガイド ↔ 企画品質基準
  - [ ] A22 ↔ A23: キャラ設計ガイド ↔ キャラ設計チェック（要作成）
  - [ ] A28 ↔ A29: プロットプロンプト ↔ プロット品質基準
  - [ ] A32 ↔ A33: コマンドガイド ↔ 品質管理チェック
  - [ ] A34 ↔ A35: 統合ワークフロー ↔ 統合チェック（要作成）
  - [ ] A36 ↔ A37: AI協創ガイド ↔ AI協創チェック（要作成）

ペア整合性:
  - [ ] チェックが対象ガイドの内容をカバー
  - [ ] チェック項目が実行可能
  - [ ] 相互参照が双方向で整備
```

## ✅ Level 4: システム整合性チェック

### 4.1 docs/_index.yaml整合性
```yaml
ファイル登録確認:
  - [ ] 全Aファイルが_index.yamlに登録
  - [ ] ファイル名が実際のファイル名と一致
  - [ ] 説明文が内容と整合

分類整合性:
  - [ ] 段階分類が番号体系と一致
  - [ ] タグ付けが適切（偶数/奇数含む）
  - [ ] priority設定が段階順序と整合
```

### 4.2 番号空間管理
```yaml
番号使用状況:
  - [ ] 使用済み番号の重複なし
  - [ ] 空き番号の把握・管理
  - [ ] 将来拡張用番号の確保

番号割当適切性:
  - [ ] 内容に対して適切な段階番号
  - [ ] 内容に対して適切な役割番号
  - [ ] 論理的な番号順序
```

## ✅ Level 5: 品質・保守性チェック

### 5.1 内容品質確認
```yaml
情報完全性:
  - [ ] 必要な情報が全て含まれている
  - [ ] 情報の重複・矛盾がない
  - [ ] 最新情報への更新済み

可読性:
  - [ ] 構造が理解しやすい
  - [ ] 専門用語に説明がある
  - [ ] 実例・図解が適切に配置

実用性:
  - [ ] 実際に使用可能な内容
  - [ ] 手順が明確で実行可能
  - [ ] トラブルシューティング情報
```

### 5.2 保守性確認
```yaml
更新容易性:
  - [ ] 修正すべき箇所が明確
  - [ ] 変更の影響範囲が限定
  - [ ] バージョン管理が適切

拡張性:
  - [ ] 新機能追加時の拡張方針が明確
  - [ ] 番号空間に余裕がある
  - [ ] アーキテクチャが拡張に対応
```

## 📊 チェック結果評価

### 合格基準
```yaml
Level 1（基本構造）: 100%合格必須
Level 2（内容品質）: 95%以上合格
Level 3（相互参照）: 100%合格必須
Level 4（システム整合性）: 100%合格必須
Level 5（品質・保守性）: 90%以上合格

総合評価:
  - S: 全Level 95%以上（優秀）
  - A: 必須Level 100% + その他90%以上（良好）
  - B: 必須Level 100% + その他80%以上（改善余地）
  - C: 必須Level未満（要修正）
```

### 不合格時対応
```yaml
即座修正必須:
  - Level 1, 3, 4の不合格項目
  - システム動作に影響する問題
  - セキュリティ・整合性問題

計画修正推奨:
  - Level 2, 5の不合格項目
  - 品質向上・保守性問題
  - ユーザビリティ問題

定期見直し:
  - 軽微な改善項目
  - 将来拡張への準備
  - 最適化・効率化項目
```

## 🚨 よくある違反パターン

### 重大違反
```yaml
番号体系根本違反:
  - 奇数ファイルが作業ガイド内容
  - 偶数ファイルがチェックリスト内容
  - 段階を跨いだ混在内容

参照整合性違反:
  - 存在しないファイルへの参照
  - 循環参照の発生
  - ペア構造の破綻
```

### 軽微違反
```yaml
形式不備:
  - 役割説明の不備・不正確
  - バージョン情報の未更新
  - 相互参照リンクの不備

内容不備:
  - 情報の不完全性
  - 実用性の不足
  - 保守性の問題
```

## 🔧 自動化支援

### 推奨チェックツール
```yaml
自動チェック可能項目:
  - ファイル命名規則
  - 参照リンク存在確認
  - docs/_index.yaml整合性
  - 番号重複チェック

手動チェック必要項目:
  - 内容と役割の整合性
  - 品質・可読性
  - 実用性・保守性
```

### チェック支援スクリプト例
```bash
# 基本構造自動チェック
./scripts/check_a_numbering_basic.sh

# 参照整合性自動チェック
./scripts/check_cross_references.sh

# 包括的準拠チェック（手動項目含む）
./scripts/check_full_compliance.sh --interactive
```

---

**重要**: このチェックリストは番号体系の品質保証の要です。新規作成・修正時の必須実施により、システム全体の一貫性・品質が保たれます。
