~/study/architect-guidance確認日

ソフトウェアアーキテクト成長ガイド

すでに理解しているシステムを、ほかの人が検討し、問い直し、発展させられる意思決定として整理しましょう。

読むための地図

新しい技術より、経験を示す証拠

作ったシステムから始める

承認ワークフロー、エディタ、通知サービス、キャプチャパイプライン、モバイルシェルから、よく知るシステムを一つ選びましょう。

アーキテクチャの練習とは制約・代替案・結果・検証方法を明示することであり、新しいフレームワークは実際の制約を解決するときに役立ちます。

この文書は公開学習ガイドであり、個人の業績評価や普遍的な昇進基準ではありません。

肩書きよりも判断と協働の範囲

役割と証拠を確かめる

StaffやPrincipalという肩書きは組織ごとに異なるため、固定的な等級と考えず、意思決定・協働・成果の範囲を確認しましょう。[1]

Will LarsonはTech Lead、Architect、Solver、Right Handという四つの反復的な役割を説明しており、必須のキャリア順序ではなく、チームに必要な仕事を議論する枠組みとして使えます。[1]

能力 → 確認する証拠 → 次の演習
能力確認する証拠次の演習
品質特性測定可能な信頼性・遅延の制約刺激・環境・応答・測定方法を書く
トレードオフ分析退けた代替案まで説明できる判断同じ制約で選択肢を比較する
意思決定の文書化レビュー済みのADR結果と見直し条件を記録する
ドメインモデリング明示的な業務の不変条件と所有権境界づけられたコンテキストとトランザクション境界を整理する
分散データ再試行と整合性についての説明重複イベントの処理を追跡する
API設計明示的な契約と互換性ポリシーエラー・ページング・冪等性を定義する
フロントエンド基盤所有者と利用者がいる共有コンポーネント貢献と廃止の規則を書く
セキュリティ信頼境界を含む脅威モデル認可と失敗経路をテストする
運用測定したSLIと対応手順書依存先の障害を訓練する
インフラIaCの変更と復旧手順ドリフト・復元・ロールバックを確認する
AIシステム版管理された評価データセット品質・遅延・コストを比較する
影響力同僚の意見で変わった設計レビュー担当者・異論・採用結果を記録する

設計文書は判断を伝える手段であり、影響力の証拠には採用結果、フィードバック、リリース後の運用成果も含まれます。

具体的な成果物に向けて読む

使える知識を積み重ねる

Fundamentals of Software Architectureで用語を学び、MADRで判断を記録し、C4でシステム境界を表し、The Staff Engineer’s Pathで技術的リーダーシップを学びましょう。[4][2][3][5]

現在の設計でレプリケーション・分割・トランザクション・ストリームに疑問が生じたとき、Designing Data-Intensive Applicationsの該当箇所を参照しましょう。[6]

  • サービス境界を選ぶ前にドメインの不変条件と境界づけられたコンテキストを定義し、ネットワーク障害の要因を増やさないモジュラーモノリスも比較しましょう。
  • 品質特性シナリオで選択肢を比較するときは、事象の主体、運用条件、必要な応答、測定方法を明示しましょう。
  • コンテキスト図に障害点と影響度を記し、対策の責任者を決めるリスクレビューを行いましょう。
  • ドメイン駆動設計、進化的アーキテクチャ、チーム境界の深い学習は、執筆中の成果物を変えられるときに選びましょう。

状態・境界・所有権をモデル化する

フロントエンドも設計の領域

明示的に判断する価値があること
領域設計の選択検証すること
エディタ文書状態とDOMを分離し、contenteditable・ProseMirror・Lexicalを比較選択範囲・文字の組み立て入力・取り消し・音声同期
決済画面pending・confirmed・failed・unknownの状態をモデル化重複送信・タイムアウト・結果照合・同じ意図での再試行
モバイルシェルWebView・ネイティブUI・ブリッジ権限を比較送信元確認・認証情報の受け渡し・ブリッジ入力検証
キャプチャパイプラインプラットフォームへのアクセスと負荷でTauri・Electronを比較再現可能な処理量・フレーム損失・CPU使用・backpressure
共有基盤組み合わせ方より先に所有権・版・互換性を定義利用側の更新経路・アクセシビリティ・ロールバック

決済のような操作ではボタンの無効化は画面を改善しますが、結果が不明なときの正しさはサーバー側の冪等性と結果照合で決まります。

ライブラリを選ぶ前にサーバー状態・共有クライアント状態・局所的な操作状態を分け、特定の状態ライブラリやマイクロフロントエンドを普遍的な既定値にしないようにしましょう。

SSEでサーバー更新を受け取り、通常のHTTPリクエストで命令を送ることもできるため、操作と接続の要件が双方向チャネルを必要とするときにWebSocketを選びましょう。[11]

実際に運用するデータベースから出発

失敗を設計に含める

MySQLを使う通知サービスでは、業務変更とoutboxの行を同じトランザクションに書き込み、ワーカーがコミット済みの行を配信する構成にします。[7]

配信後、完了記録前にリレーが停止すると重複配信が起こり得るため、イベント識別子を追跡し、利用側の処理を冪等にしましょう。[7]

  • 同時実行ワーカーが同じ作業を意図的に処理しないよう行の確保やリースを定義し、一定時間後に放置された確保を回復しましょう。
  • エンティティ単位の順序、backoffとjitterを含む再試行、試行上限、確認後に再処理・破棄できるdead-letter queueを明示しましょう。
  • 冪等性キーを主体と操作に限定し、正規化した要求のハッシュを比較し、要求変更時のキー再利用拒否と期限・処理中の復旧方法を決めましょう。
  • MySQLで生のSHA-256ダイジェストを保存するならBINARY(32)が表現の一例であり、BYTEAはMySQLの列型ではありません。

直接ポーリングするワーカーには別のキューは不要ですが、pg-bossにはPostgreSQL、BullMQのRedisバックエンドにはRedisが加わるため、依存関係を意識して選びましょう。[9][8][17]

複数サービスにまたがるワークフローではchoreographyとorchestrationを比較し、補償処理・部分的な失敗・運用責任も検討しましょう。

expand-contract移行にはバックフィルと互換期間を設け、障害が連鎖する依存先ではタイムアウトとcircuit breakerを組み合わせて検討しましょう。

成果を主張する前に測定する

セキュリティと運用を設計の入力に

対策を選ぶ前に、資産、信頼境界、主体ごとの権限、悪用例を含む脅威モデルを描きましょう。

決済ページではPCI DSSのスクリプト承認・完全性・一覧管理の要件を確認し、nonceベースのCSPは対策の一つであって適合性評価全体を代替しないと区別しましょう。[12]

SLOを決める前にSLIの測定対象と観測期間を定義し、提案した遅延値は実測で裏づけられるまで目標値として示しましょう。[10]

  • ブラウザー測定・バックエンドのトレース・構造化ログを要求識別子でつなぎ、認証情報と個人情報を除去しましょう。
  • 症状、担当者、緩和策・ロールバック・復旧検証を含む手順書を書き、依存先の障害を訓練しましょう。
  • 道具を変えるために既存構成を作り直すのではなく、infrastructure as codeの権限・シークレット・ドリフト・バックアップ復元・コスト・安全な配備を見直しましょう。
  • Kubernetesは熟練度の証明とせず、リソース制限・プローブ・外部シークレット管理を含む任意の配備演習として扱いましょう。

このリポジトリにはAmplify/CDKのインフラ、一部の閲覧画面のWeb Vitals収集、チャット評価ツールがありますが、コードの存在だけでは配備範囲や本番運用の改善を証明できません。

デモを出発点にする

AIシステムにも証拠が必要

要件を満たす最も単純なワークフローから始め、評価が追加コストと障害要因を正当化するときだけrouting・parallelization・エージェントの自律性を加えましょう。[14]

RAG・長いコンテキスト・fine-tuningを交換可能な更新と考えず、知識の鮮度・追跡可能性・振る舞い・遅延・コストで比較しましょう。

範囲の明確な実験を一つ選ぶ
演習成果物合格の根拠
ドメイン文書のRAG検索・分割・原文アクセスの判断回答可能性・引用精度・検索失敗を付与したデータセット
読み取り専用MCPツールツール契約・識別範囲・監査設計認可テスト・悪意ある出力のテスト・呼び出し上限
チャット評価ループ不変のプロンプトとデータセットの版基準版との品質・コスト・遅延の比較

合成データか公開可能なデータを使い、ツールとデータ層で権限を強制し、検索した文章を実行権限ではなく信頼できない入力として扱いましょう。

問題 → 制約 → 判断 → 証拠

判断の過程をレビュー可能にする

設計文書には背景、目標と非目標、インターフェースとデータ、代替案・リスク・テスト・配備・ロールバック・成功条件を含めましょう。

MADRで個別の判断を記録し、C4のコンテキスト図やコンテナ図で境界を示し、振る舞いの説明が必要な場所だけにシーケンス図や状態図を追加しましょう。[2][3]

再利用できる五つの事例研究
システム説明するトレードオフ含める証拠
承認ワークフロー明示的な経路と汎用ルールエンジン状態遷移・不変条件・権限境界
通知サービス同期送信と永続化した非同期配信障害シーケンス・重複・再処理・運用コスト
文字起こしエディタ文書モデルと暗黙的なDOM状態文字の組み立て入力・選択範囲・同期テスト
画面キャプチャネイティブアクセス・移植性・処理コスト測定方法・負荷・フレーム損失・ボトルネック
モバイルシェルネイティブ機能とウェブコード共有ブリッジの信頼境界・認証・復旧

公開・合成の例で方法を説明し、勤務先のスキーマ・顧客識別子・認証情報・非公開の通信量を載せず、アプリの公開が実装の公開を意味しないことを忘れないでください。

箱を描く前に前提を示す

説明を練習する

フロントエンド設計にはRADIOのRequirements・Architecture・Data model・Interface・Optimizationsを使い、各段階の深さを選ぶ前に面接の範囲を確認しましょう。[15]

バックエンドやフルスタックの練習では、すべての面接に固定の時間配分を当てはめず、要件・エンティティ・契約・データフロー・全体設計・障害分析を扱いましょう。

繰り返せる練習の順序
回システム深く検討する点
1–2通知サービス配信保証と失敗メッセージの再処理
3–4共同文字起こしエディタ競合解決・選択範囲・遅延
5–6決済画面冪等性と不明な結果
7–8通知の拡張容量見積もり・順序・運用コスト
9–10ストリーミング文字起こし流量制御・切断・提供元の障害
11–12共有フロントエンドの移行所有権・互換性・配備・ロールバック

仮の負荷として日間利用者100万人が通知を10件ずつ受け取るなら平均は毎秒約116件であり、ピークを10倍と仮定すると毎秒約1,160件なので、実際の通信量で前提を確認する必要があります。

開始日は自由に、段階ごとに証拠を残す

続けられる成長ロードマップ

週6時間を一つの予算とし、執筆2時間、目的を絞った読書2時間、実装1時間、練習1時間に配分しましょう。

以下の節目は納期の約束ではなく提案なので、レビュー・アクセス権・実務に時間を使う場合は範囲を狭めるか期間を延ばしましょう。

同じ週間予算で進める相対的な日程
段階重点レビュー可能な成果物
1–2週身近な判断を文書化ADR一つとシステムコンテキスト図一つ
1–3か月公開・レビュー・修正事例研究一つ、リスクレビュー、同僚の意見
4–6か月失敗しやすい経路を一つ深める測定を伴うoutbox実験または信頼性の訓練
7–12か月インフラかAIの課題を一つ選ぶ復旧訓練または評価で裏づけたデモ
13–18か月他者と意思決定を主導レビュー済みの提案・採用の証拠・配備結果
19–24か月整理して伝える判断の再検討・振り返り・発表か記事

資格は業務や確認済みの求人要件に必要な能力と合う場合に選び、試験名・受験可否・費用は提供元で確認しましょう。

出典の事実と学習の提案を分ける

参考資料と検証の範囲

以下の資料は個別の概念の根拠であり、演習・学習順序・完了条件は出典が課す要件ではなく編集上の提案です。

この公開版では個人の点数・応募戦略・給与比較、推測に基づく公開時期の予測、未検証の企業別面接基準を除外しています。

基礎書と実務文書を併読し、AWS Well-Architected Frameworkで運用の優秀性・セキュリティ・信頼性・性能・コスト・持続可能性を検討しましょう。[13]

実装時には変更され得る文書を再確認し、実際のシステムの個人情報・契約・適用法規を検討し、このガイドを適合性に関する意見書として扱わないでください。

  1. [1]Will Larson · Staff archetypes
  2. [2]MADR · Markdown Architectural Decision Records
  3. [3]Simon Brown · C4 model
  4. [4]Richards & Ford · Fundamentals of Software Architecture, 2nd edition
  5. [5]Tanya Reilly · The Staff Engineer’s Path
  6. [6]Kleppmann & Riccomini · Designing Data-Intensive Applications, 2nd edition
  7. [7]AWS · Transactional outbox pattern
  8. [8]MySQL · BINARY and VARBINARY
  9. [9]pg-boss · Introduction
  10. [10]Google SRE Workbook · Implementing SLOs
  11. [11]MDN · Using server-sent events
  12. [12]PCI SSC · Payment Page Security and Preventing E-Skimming
  13. [13]AWS · Well-Architected Framework
  14. [14]Anthropic · Building effective agents
  15. [15]GreatFrontEnd · The RADIO Framework
  16. [16]Neal Ford · Architectural Katas
  17. [17]BullMQ · Introduction and storage backends
↑ 先頭へ