作ったシステムから始める
承認ワークフロー、エディタ、通知サービス、キャプチャパイプライン、モバイルシェルから、よく知るシステムを一つ選びましょう。
アーキテクチャの練習とは制約・代替案・結果・検証方法を明示することであり、新しいフレームワークは実際の制約を解決するときに役立ちます。
この文書は公開学習ガイドであり、個人の業績評価や普遍的な昇進基準ではありません。
役割と証拠を確かめる
StaffやPrincipalという肩書きは組織ごとに異なるため、固定的な等級と考えず、意思決定・協働・成果の範囲を確認しましょう。[1]
Will LarsonはTech Lead、Architect、Solver、Right Handという四つの反復的な役割を説明しており、必須のキャリア順序ではなく、チームに必要な仕事を議論する枠組みとして使えます。[1]
| 能力 | 確認する証拠 | 次の演習 |
|---|---|---|
| 品質特性 | 測定可能な信頼性・遅延の制約 | 刺激・環境・応答・測定方法を書く |
| トレードオフ分析 | 退けた代替案まで説明できる判断 | 同じ制約で選択肢を比較する |
| 意思決定の文書化 | レビュー済みのADR | 結果と見直し条件を記録する |
| ドメインモデリング | 明示的な業務の不変条件と所有権 | 境界づけられたコンテキストとトランザクション境界を整理する |
| 分散データ | 再試行と整合性についての説明 | 重複イベントの処理を追跡する |
API設計 | 明示的な契約と互換性ポリシー | エラー・ページング・冪等性を定義する |
| フロントエンド基盤 | 所有者と利用者がいる共有コンポーネント | 貢献と廃止の規則を書く |
| セキュリティ | 信頼境界を含む脅威モデル | 認可と失敗経路をテストする |
| 運用 | 測定したSLIと対応手順書 | 依存先の障害を訓練する |
| インフラ | IaCの変更と復旧手順 | ドリフト・復元・ロールバックを確認する |
AIシステム | 版管理された評価データセット | 品質・遅延・コストを比較する |
| 影響力 | 同僚の意見で変わった設計 | レビュー担当者・異論・採用結果を記録する |
設計文書は判断を伝える手段であり、影響力の証拠には採用結果、フィードバック、リリース後の運用成果も含まれます。
使える知識を積み重ねる
フロントエンドも設計の領域
| 領域 | 設計の選択 | 検証すること |
|---|---|---|
| エディタ | 文書状態とDOMを分離し、contenteditable・ProseMirror・Lexicalを比較 | 選択範囲・文字の組み立て入力・取り消し・音声同期 |
| 決済画面 | pending・confirmed・failed・unknownの状態をモデル化 | 重複送信・タイムアウト・結果照合・同じ意図での再試行 |
| モバイルシェル | WebView・ネイティブUI・ブリッジ権限を比較 | 送信元確認・認証情報の受け渡し・ブリッジ入力検証 |
| キャプチャパイプライン | プラットフォームへのアクセスと負荷でTauri・Electronを比較 | 再現可能な処理量・フレーム損失・CPU使用・backpressure |
| 共有基盤 | 組み合わせ方より先に所有権・版・互換性を定義 | 利用側の更新経路・アクセシビリティ・ロールバック |
決済のような操作ではボタンの無効化は画面を改善しますが、結果が不明なときの正しさはサーバー側の冪等性と結果照合で決まります。
ライブラリを選ぶ前にサーバー状態・共有クライアント状態・局所的な操作状態を分け、特定の状態ライブラリやマイクロフロントエンドを普遍的な既定値にしないようにしましょう。
SSEでサーバー更新を受け取り、通常のHTTPリクエストで命令を送ることもできるため、操作と接続の要件が双方向チャネルを必要とするときにWebSocketを選びましょう。[11]
失敗を設計に含める
MySQLを使う通知サービスでは、業務変更とoutboxの行を同じトランザクションに書き込み、ワーカーがコミット済みの行を配信する構成にします。[7]
配信後、完了記録前にリレーが停止すると重複配信が起こり得るため、イベント識別子を追跡し、利用側の処理を冪等にしましょう。[7]
直接ポーリングするワーカーには別のキューは不要ですが、pg-bossにはPostgreSQL、BullMQのRedisバックエンドにはRedisが加わるため、依存関係を意識して選びましょう。[9][8][17]
複数サービスにまたがるワークフローではchoreographyとorchestrationを比較し、補償処理・部分的な失敗・運用責任も検討しましょう。
expand-contract移行にはバックフィルと互換期間を設け、障害が連鎖する依存先ではタイムアウトとcircuit breakerを組み合わせて検討しましょう。
セキュリティと運用を設計の入力に
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]
実装時には変更され得る文書を再確認し、実際のシステムの個人情報・契約・適用法規を検討し、このガイドを適合性に関する意見書として扱わないでください。
- Will Larson · Staff archetypes
- MADR · Markdown Architectural Decision Records
- Simon Brown · C4 model
- Richards & Ford · Fundamentals of Software Architecture, 2nd edition
- Tanya Reilly · The Staff Engineer’s Path
- Kleppmann & Riccomini · Designing Data-Intensive Applications, 2nd edition
- AWS · Transactional outbox pattern
- MySQL · BINARY and VARBINARY
- pg-boss · Introduction
- Google SRE Workbook · Implementing SLOs
- MDN · Using server-sent events
- PCI SSC · Payment Page Security and Preventing E-Skimming
- AWS · Well-Architected Framework
- Anthropic · Building effective agents
- GreatFrontEnd · The RADIO Framework
- Neal Ford · Architectural Katas
- BullMQ · Introduction and storage backends