エンジニアリングの実践
卓越したエンジニアリング
私たちにとって卓越したエンジニアリングとは、一貫して適用される一連の実践です。意思決定の記録方法から、システムのテスト、リリース、監視、セキュリティ確保の方法まで、そのすべてに及びます。
01
長く通用する意思決定
優れたシステムは優れた意思決定の積み重ねであり、意思決定は文書に残しておくことで、その妥当性を説明しやすく、見直しもしやすくなります。私たちは重要な選択をアーキテクチャ決定記録（ADR）として記録し、背景、検討した選択肢、決定内容とその影響を残します。
- 01
アーキテクチャ決定記録（ADR）
コードとともに管理される、簡潔でバージョン管理された文書です。システムがなぜ現在の形になっているのかを説明します。
- 02
コードレビュー
すべての変更について、別のエンジニアが正確性、わかりやすさ、セキュリティ、アーキテクチャとの整合性の観点からレビューします。
- 03
ドキュメンテーション
セットアップ、運用、インターフェース、ランブックに関する常に最新のドキュメントを、対象となるコードと並行して維持します。
02
テストとデリバリー
私たちはテストピラミッドの考え方に従います。高速なユニットテストを幅広い土台とし、その上に統合テストとコントラクトテストの層を重点的に設け、重要なユーザージャーニーを検証する少数のエンドツーエンドテストを置きます。AIコンポーネントについては、あらゆる変更の前後に、合意した基準に照らして振る舞いを測定する評価スイートを追加します。
継続的インテグレーションと継続的デリバリーのパイプラインがすべての変更に対してこれらのチェックを実行するため、リリースはリスクの高いイベントではなく、日常的な作業となります。
- 01
テストピラミッド
高速なユニットテスト、コントラクトテストと統合テスト、そして重要な経路に絞ったエンドツーエンドのテストカバレッジ。
- 02
AI評価
プロンプト、検索（リトリーバル）、エージェントを対象とした再現可能な評価セットを継続的に追跡し、品質の後退（リグレッション）を可視化します。
- 03
CI/CD
ビルド、テスト、セキュリティスキャン、デプロイを自動化し、リリースは切り戻しが可能な形で設計します。
03
オブザーバビリティと信頼性
システムは、本番環境で自らの状態を説明できるべきです。私たちは、構造化ログ、メトリクス、トレースによってサービスを計装し、ユーザーが実際に体験する内容を軸にサービスレベル目標（SLO）を定義し、ノイズではなく症状に基づいてアラートを発します。AIワークロードについては、モデル呼び出し、ツールの利用、コスト、承認もトレースします。
04
設計段階からのセキュリティとアクセシビリティ
セキュリティは、最初のアーキテクチャの議論から設計に組み込みます。脅威モデリング、最小権限のアクセス制御、シークレット管理、依存関係のスキャン、セキュアなデフォルト設定などです。個人データを扱うシステムでは、当初からプライバシー要件をデータモデルとデータ保持の設計に反映します。
アクセシビリティも同様に扱います。WCAG 2.2 AAを基準としてインターフェースを設計・テストします。より多くの人が利用できるシステムこそ、より優れたシステムだと考えるからです。
構想中の取り組みを、お聞かせください。
課題、背景、求める成果をお知らせください。営業用の定型対応ではなく、エンジニアが内容を確認し、熟慮した次のステップをご提案します。