# リファレンス

開発ガイドラインやベストプラクティスのリファレンスドキュメントです。

## ドキュメント一覧

### 基本理念

- [よいソフトウェアとは](./よいソフトウェアとは.md)
- [ロジカルシンキング](./ロジカルシンキング.md)
- [開発ガイド](./開発ガイド.md)
- [開発ガイド（AI-DLC 版）](./開発ガイド_AI-DLC版.md) - 開発ライフサイクルを Inception・Construction・Operation で読み替え、各活動の AI と人の分担と AI-DLC 版ガイドへの入口を示す
- [エクストリームプログラミング](./エクストリームプログラミング.md)
- [AI-DLC 導入ガイド](./AI-DLC導入ガイド.md) - AWS が提唱する AI-DLC の 10 原則・成果物・フェーズ・参照実装（aidlc-workflows）と、XP ベースの開発ライフサイクル・Skills 体系への組み込み方
- [AI-DLC 用語集](./AI-DLC用語集.md) - AI-DLC の用語を基本概念・成果物・フェーズと儀式・計画・実装・参照実装の区分で定義し、XP・Scrum との対応を示す
- [ドキュメント構成ガイド](./ドキュメント構成ガイド.md) - 単一企業・統合戦略・複数プロジェクトのコンセプトに基づく docs/ と apps/ の構成規約
- [Living Documentation導入ガイド](./LivingDocumentation導入ガイド.md) - 『Living Documentation』に基づくドキュメントの再定義と 4 原則、知識の活用・拡張・キュレーション、Living Glossary・Living Diagram、ランタイムドキュメンテーションと、本プロジェクトの成果物への適用方法
- [アノテーション導入ガイド](./アノテーション導入ガイド.md) - 設計判断・意図・根拠をコード上の構造化されたアノテーションとして残す導入手順（語彙カタログ、命名・コミット規約、ツール連携と検証）
- [ダイナミックキュレーション導入ガイド](./ダイナミックキュレーション導入ガイド.md) - 既存の知識から目的に必要な少数を安定した基準で自動的に選び出す導入手順
- [ガイドツアー・サイトシーイング導入ガイド](./ガイドツアー・サイトシーイング導入ガイド.md) - コードの見どころ（サイトシーイング・マップ）と処理の流れ（ガイドツアー）をアノテーションから生成する導入手順

### 経営・ビジネス

- [企業経営論](./企業経営論.md)
- [運営管理](./運営管理.md)

### 分析・設計

- [経営戦略分析ガイド](./経営戦略分析ガイド.md)
- [ビジネスアーキテクチャ分析ガイド](./ビジネスアーキテクチャ分析ガイド.md)
- [要件定義ガイド](./要件定義ガイド.md)
- [ユースケース作成ガイド](./ユースケース作成ガイド.md)
- [ユースケース作成ガイド（AI-DLC 版）](./ユースケース作成ガイド_AI-DLC版.md) - Mob Elaboration で AI が初稿を書き人が検証する手順、人と AI の契約としての記述基準、AI 生成物の検証観点
- [アーキテクチャ設計ガイド](./アーキテクチャ設計ガイド.md)
- [データモデル設計ガイド](./データモデル設計ガイド.md)
- [ドメインモデル設計ガイド](./ドメインモデル設計ガイド.md)
- [UI 設計ガイド](./UI設計ガイド.md)
- [インフラ設計ガイド](./インフラ設計ガイド.md)

### 品質・テスト

- [テスト戦略ガイド](./テスト戦略ガイド.md)
- [非機能要件定義ガイド](./非機能要件定義ガイド.md)
- [運用要件定義ガイド](./運用要件定義ガイド.md)
- [コーディングとテストガイド](./コーディングとテストガイド.md)
- [コーディングとテストガイド（AI-DLC 版）](./コーディングとテストガイド_AI-DLC版.md) - AI が Red-Green-Refactor を回し人が承認ゲートで全行検証する Bolt 実装フロー、AI 生成コード・テストのレビュー観点、ガードレール
- [BDD導入ガイド](./BDD導入ガイド.md) - 『Living Documentation』の BDD 論に基づき、スリーアミーゴの会話・フィーチャーファイルの構造・仕様詳細・タグ・プロパティベーステストを整理し、日本語 Gherkin の書き方と Cucumber の処理系選定・インストール・ステップ定義・Red-Green-Refactor・生きたドキュメント公開までの実装手順をまとめた導入ガイド。

### 開発・運用

- [リリースガイド](./リリースガイド.md)
- [リリース・イテレーション計画ガイド](./リリース・イテレーション計画ガイド.md)
- [リリース・イテレーション計画ガイド（AI-DLC 版）](./リリース・イテレーション計画ガイド_AI-DLC版.md) - Intent → Unit → Bolt の計画、承認ゲート駆動の検証、エントロピー評価による見積もりと進捗指標
- [環境変数管理ガイド](./環境変数管理ガイド.md)
- [言語別開発ガイド](./言語別開発ガイド.md)
- [Java アプリケーション環境構築ガイド](./Javaアプリケーション環境構築ガイド.md)
- [TypeScript アプリケーション環境構築ガイド](./TypeScriptアプリケーション環境構築ガイド.md)
- [運用スクリプト作成ガイド](./運用スクリプト作成ガイド.md)

### ツール

- [Codex CLI MCP アプリケーション開発フロー](./CodexCLIMCPアプリケーション開発フロー.md)
- [Codex CLI MCP サーバー設定手順](./CodexCLIMCPサーバー設定手順.md)
- [SonarQube ローカル環境セットアップ手順書](./SonarQubeローカル環境セットアップ手順書.md)
- [Vim 操作マニュアル](./Vim操作マニュアル.md)
- [OKF 導入ガイド（Open Knowledge Format v0.2）](./OKF導入ガイド_V0.2.md)