# AI開発の用語・手法リファレンス

資料確認：2026-10-12。15分野・200項目。出典・関連資料：75件。

**[検索できるカード集](index.html)** / [全体図](learning-roadmap.png) / [CSV](catalog.csv) / [参考資料と確認範囲](sources.md) / [作業別の依頼テンプレート](task-playbook.md)

対象：Webアプリ・API・業務自動化・AI支援開発。各項目に意味・場面・例・依頼文・確認方法・注意を収録。

## 使い方

1. 困りごとの言葉で検索する。例：二重登録、権限、遅い、期待値。
2. 用語の意味と使う場面を読む。
3. 依頼文へ自分の目的・制約・入力・期待結果を加える。
4. カードの確認方法で実際の結果を確かめる。
5. 案件で使った結果を記録し、条件に応じて資料を更新する。

検索画面は同じフォルダーの index.html をブラウザーで開く。外部サーバーやログイン不要。参考資料のリンクはインターネットを使う。

## 最初の20項目

選定は学習用の推奨。全案件で20手法すべてを導入する指示ではない。

| 順 | 用語 | 判断に使う意味 |
|---|---|---|
| 1 | [Acceptance criteria](topics/01-requirements.md#requirements-03) | 受入条件 |
| 2 | [Specification by Example](topics/01-requirements.md#requirements-04) | 具体例による仕様化 |
| 3 | [Definition of Done / DoD](topics/01-requirements.md#requirements-09) | 共通の完了基準 |
| 4 | [Vertical slice](topics/04-planning.md#planning-01) | 機能を縦に切る |
| 5 | [Small batch](topics/04-planning.md#planning-02) | 小さな変更単位 |
| 6 | [YAGNI](topics/05-quality.md#quality-01) | 必要になるまで作り込まない |
| 7 | [Separation of Concerns / SoC](topics/03-architecture.md#architecture-01) | 関心の分離 |
| 8 | [ADR / Architecture Decision Record](topics/03-architecture.md#architecture-09) | 設計判断の記録 |
| 9 | [Refactoring](topics/05-quality.md#quality-04) | 外部の振る舞いを保った構造改善 |
| 10 | [Transaction / ACID](topics/06-data.md#data-06) | 一連の更新をまとめる |
| 11 | [Idempotency key](topics/07-integration.md#integration-04) | 再送を識別するキー |
| 12 | [Test oracle](topics/08-testing.md#testing-01) | 正しさを判定する根拠 |
| 13 | [Tautological test](topics/08-testing.md#testing-02) | 同語反復的なテスト |
| 14 | [Regression test](topics/08-testing.md#testing-04) | 回帰テスト |
| 15 | [Authorization / AuthZ](topics/10-security.md#security-02) | 認可・操作権の判定 |
| 16 | [CI / Continuous integration](topics/11-delivery.md#delivery-03) | 継続的インテグレーション |
| 17 | [Rollback / Roll forward](topics/11-delivery.md#delivery-10) | 以前へ戻す・修正版へ進む |
| 18 | [Observability](topics/12-operations.md#operations-01) | 観測可能性 |
| 19 | [Context engineering](topics/14-context.md#context-01) | 文脈の設計 |
| 20 | [Evaluation / Evals](topics/15-agents.md#agents-10) | AIの結果を測る評価 |

## 分野から探す

| 分野 | 目的 | 項目数 |
|---|---|---|
| [01 要件・課題](topics/01-requirements.md) | 何を、なぜ作るか | 12 |
| [02 画面・UX](topics/02-frontend.md) | 使える画面と入力 | 12 |
| [03 設計](topics/03-architecture.md) | 責任と依存を整理 | 12 |
| [04 作業計画](topics/04-planning.md) | 小さく確かめる | 12 |
| [05 コード品質](topics/05-quality.md) | 変更しやすく保つ | 12 |
| [06 データ・DB](topics/06-data.md) | 正しく保存・更新 | 12 |
| [07 API・連携](topics/07-integration.md) | 失敗・再送に備える | 12 |
| [08 テスト品質](topics/08-testing.md) | 誤りを検出する | 20 |
| [09 Git・レビュー](topics/09-git.md) | 変更を追跡・統合 | 12 |
| [10 セキュリティ](topics/10-security.md) | 権限と秘密を守る | 16 |
| [11 ビルド・公開](topics/11-delivery.md) | 再現して届ける | 12 |
| [12 運用・改善](topics/12-operations.md) | 検知・復旧・学習 | 14 |
| [13 性能・コスト](topics/13-performance.md) | 測って改善する | 12 |
| [14 AIの指示・情報](topics/14-context.md) | 必要な文脈を渡す | 14 |
| [15 AI実行・評価](topics/15-agents.md) | 行動と品質を管理 | 16 |

## 学習優先度

- P1：開発の依頼と確認で早く使いたい基礎。
- P2：該当する実装や問題に出会ったときに学ぶ。
- P3：複雑さ・規模・リスクが必要とするときに比較する。

優先度は教材上の整理。例えば本番の権限制御は、未学習でも後回しにできるという意味ではない。

## 困りごとから探す

| 状況 | 主な用語 |
|---|---|
| AIが勝手に機能を増やす | Acceptance criteria / Scope creep / YAGNI |
| 大量の変更が出て確認できない | Small batch / Vertical slice / Diff |
| 変更のたびに別の箇所が壊れる | Separation of Concerns / Coupling / Regression test |
| テストが通っても誤動作する | Test oracle / Tautological test / Mutation testing |
| 送信や再実行で二重登録する | Idempotency key / Unique constraint / Race condition |
| 他人のデータが見えてしまう | Authorization / Least privilege / Deny by default |
| 公開後に戻せない | Migration / Rollback / Backup / Expand-contract |
| 失敗した理由が分からない | Observability / Correlation ID / RCA |
| AIが古い前提や外部文書の命令に従う | Grounding / Context engineering / Prompt injection |
| AIの改善が感覚頼み | Evals / Golden dataset / Grader / Cost budget |

## 近い用語の違い

| 用語 | 区別する点 |
|---|---|
| Acceptance criteria / DoD | 機能固有の受入条件 / 作業共通の完了基準 |
| AuthN / AuthZ | 誰か / 何を許可するか |
| Idempotency / Retry | 繰り返しても効果が重複しない性質 / 再試行する動作 |
| Refactoring / Rewrite | 振る舞いを保つ構造改善 / 実装の作り直し。後者の内容は要定義 |
| CI / Delivery / Deployment | 頻繁な統合と確認 / 配備可能な状態 / 自動本番反映 |
| Rollback / Backup | 変更を戻す操作 / 復旧用データのコピー |
| Monitoring / Observability | 状態の監視 / 出力から内部状態を理解できる性質 |
| Coverage / Mutation testing | 実行範囲 / 意図的変更への検出力 |
| RAG / Fine-tuning | 実行時に取得した情報を入力へ加える / 学習でモデルを調整する。後者は今回詳細未収録 |

## 範囲・不確実性

- 分野全体の全用語・全手法を網羅する辞典ではない
- 収録数はカード項目数。関連する複数語をまとめた項目を含む
- 依頼例・具体例・優先度は教材として作成し、効率向上率は実測していない
- 出典は定義そのものと関連原則の資料を含む。直接定義を未確認の項目は個別表示
- 個別製品の実装手順・設定値・料金・CVEは採用時点の現物確認が必要
- 57項目は関連原則を参照した整理で、用語の直接定義は未確認。該当カードに表示。
- 専門アルゴリズム、言語構文の全項目、OS・ネットワークの深い理論、全設計パターン、業界別規格、全AI学習手法は未収録。

## 追加する項目の型

用語／別名／種類／使う工程／意味／困る場面／具体例／依頼文／確認方法／適用しない条件／出典／確認日を残す。似た項目は関連づけ、異なる概念を同義語として混ぜない。

## 次の一歩

最初の20項目をざっと読み、進行中の作業から一つの困りごとを選んで使う。学習した数より、依頼と確認で使えた結果を記録する。

## 参考資料

[出典一覧と調査上の限界](sources.md)。元データ：[catalog.json](catalog.json)。