platform-engineering

プラットフォームエンジニアリング

プラットフォームエンジニアリング作業の中核となる方法論とリファレンスライブラリです。このスキル自体は操作を実行せず、プラットフォームエンジニアのプロファイルが必要に応じて読み込むフレームワーク、パターン、リファレンス資料を提供します。

読み込むタイミング

タスクに以下が含まれる場合、このスキルを読み込みます。

トリガー	必要な内容
CI/CD パイプラインの設計	パイプライン構造、GitOps の同期戦略、リリース自動化
Infrastructure as Code の計画	Terraform/OpenTofu のモジュールパターン、状態管理、Pulumi/Ansible のパターン
コンテナオーケストレーションの設計	K8s の Pod ライフサイクル、Helm チャートの規約、Kustomize オーバーレイ、Docker Compose。クラスターの運用（マニフェスト、RBAC、ワークロード、アップグレード）は kubernetes に引き継ぎます
サービスネットワーキング／メッシュ	Traefik/nginx/Caddy の設定、Tailscale/Headscale の ACL、WireGuard、サービスメッシュ
オブザーバビリティ戦略	Prometheus ルール、コードとして管理する Grafana ダッシュボード、Loki ロギング、トレーシング。Prometheus/OTel/Loki スタックの運用（スクレイプ、ルール、保持）は telemetry に、Grafana プロダクト関連の作業は grafana に引き継ぎます
インフラストラクチャの実行	Terraform/OpenTofu の plan/apply ワークフロー、状態バックエンド、ドリフト検出、アップグレード — terraform に引き継ぎます
PostgreSQL の運用	サーバー設定のレビュー、インデックスとクエリプラン、バキューム／肥大化、バックアップ／PITR、レプリケーション — postgres に引き継ぎます
シークレット管理の設計	Vault、SOPS、External Secrets Operator のパターン
クラウドアーキテクチャの評価	マルチクラウドのパターン、プロバイダーの基盤、コストガバナンス
デプロイパイプラインのレビュー	デリバリープラットフォームのアーキテクチャ。リリースモデル、昇格ゲート、ロールアウト、またはロールバックポリシーを定義する場合は、release-engineering を読み込みます
プラットフォームプロダクトの導入相談または価値評価	適用可能性、内部ユーザーの把握、成果の契約、導入／価値のエビデンス、停止／エスカレーションのルール
セルフサービスの契約またはポリシー例外	API／成果の契約、ガードレールのエビデンス、例外の所有者、エスケープハッチのレビュー
プラットフォームのオブザーバビリティに関する責任	プラットフォーム利用者による導入、SLI/SLO の公開、対応先の振り分け、所有権の引き継ぎ

使用しないケース

リリースプロセス、昇格、ロールアウト、またはロールバックポリシーを定義するには、release-engineering を使用します。このスキルは、それらの決定を実装するデリバリープラットフォームを構築し、運用します。

読み込み順序

skill_view('platform-engineering')          # This — methodology index
skill_view('artifact-pyramids')              # Output contract
skill_view('docker-compose')                 # Container lifecycle and Compose (if needed)
skill_view('traefik')                        # Reverse proxy (if needed)
skill_view('tailscale')                      # Mesh networking (if needed)
skill_view('implementation-planning')        # Work breakdown (if needed)

次に、このスキルからドメイン固有のリファレンスを読み込みます。

skill_view('platform-engineering', file_path='references/ci-cd-pipelines.md')
skill_view('platform-engineering', file_path='references/platform-product-evidence.md')
skill_view('platform-engineering', file_path='references/policy-and-observability-ownership.md')
skill_view('platform-engineering', file_path='references/infrastructure-as-code.md')
# ... etc per domain

参照ファイル

参照先	用途
references/ci-cd-pipelines.md	GitHub Actions、GitLab CI、Forgejo CI、Jenkins、CircleCI、ArgoCD／Flux を使用した GitOps、リリース自動化
references/container-orchestration.md	K8s／k3s、Helm チャートの規約、Kustomize オーバーレイ、RBAC パターン、Docker Compose の本番環境向けパターン
references/infrastructure-as-code.md	Terraform／OpenTofu のモジュール設計、状態バックエンド、Pulumi プロジェクト構成、Ansible ロール、CloudFormation／CDK
references/service-networking.md	リバースプロキシの設定（Traefik、nginx、Caddy）、Tailscale／Headscale の ACL、WireGuard のトポロジー、サービスメッシュ（Istio、Cilium）
references/observability.md	Prometheus の記録ルール／アラート、コードとして管理する Grafana ダッシュボード、Loki によるログ集約、OpenTelemetry によるトレース
references/secret-management.md	HashiCorp Vault の認証／ポリシー、Git での SOPS／age 暗号化、External Secrets Operator、Sealed Secrets
references/cloud-platforms.md	AWS／GCP／Azure の基盤サービス、マルチクラウド設計、コストガバナンス、プロバイダーの抽象化
references/automation-languages.md	プラットフォームツール向けの Go CLI パターン、Python SDK 統合、Bash によるブートストラップ／規約
references/release-engineering.md	コンテナーイメージのライフサイクル、アーティファクトのバージョニング戦略、リリースゲートのチェックリスト、Helm チャートの昇格
references/platform-product-evidence.md	適用可能性／インテーク、プラットフォームのドメイン境界、成果／セルフサービス契約、導入と価値のエビデンス
references/policy-and-observability-ownership.md	再利用可能なポリシーチェックを用いた開発者主体のデリバリー、例外、オブザーバビリティのオーナーシップ、対応の振り分け

テンプレート

テンプレート	使用する場面
templates/golden-path-self-service-portal.md	開発者ワークフロー向けのゴールデンパスまたはセルフサービスポータルを設計する場合（スコープ設定、ジャーニー、ガードレール、エスケープハッチ、メトリクス）
templates/iac-review-record.md	Terraform／OpenTofu／Pulumi／Ansible のモジュールをリリースする前に、構造化されたレビューを記録する場合
templates/observability-contract.md	サービスが本番トラフィックを受け入れる前に満たすべきメトリクス／ログ／トレースの契約を宣言する場合
templates/platform-value-record.md	プラットフォームの問題、ベースライン、導入の前提、価値モデル、停止／エスカレーションの判断を記録する場合
templates/platform-exception-record.md	スコープ、エビデンス、有効期限、責任者を含めて、エスケープハッチまたはポリシー例外をレビューする場合

出力契約

このスキルを使用するプロファイルは、アーティファクトのピラミッドを生成します。呼び出し元への応答は、00-index.md の絶対パスです。仕様については artifact-pyramids スキルを参照してください。

設計原則

1. プラットフォームはプロダクトです。 社内の開発者はお客様です。開発者の生産性、満足度、認知負荷が主要な指標です。
2. 黄金の道を用意し、黄金の檻は作りません。 一般的なワークフローには整備された道筋を提供しつつ、そこから外れる手段も用意します。正しいことを簡単にし、間違ったことを不可能にはしません。
3. 認知負荷を軽減します。 インフラストラクチャの複雑さを抽象化します。サービスをデプロイするために、開発者が Kubernetes の内部構造や Terraform の状態管理を理解する必要はありません。
4. すべてをコードで管理します。 インフラストラクチャ、設定、パイプライン、ポリシーはバージョン管理され、レビューされ、再現可能である必要があります。Git を唯一の信頼できる情報源とします。
5. チケット対応よりセルフサービスを優先します。 チーム間の手作業による引き継ぎはすべてボトルネックになります。デプロイに別のチームの支援が必要なら、プラットフォームは未完成です。
6. 自動化をデフォルトにします。 自動化できるプロセスは、必ず自動化します。手動作業は toil、つまり組織にとっての負担です。
7. オブザーバビリティはインフラストラクチャの一部です。 ログ、メトリクス、トレース、ダッシュボードはプラットフォームの契約であり、任意の追加機能ではありません。すべてのサービスで、デフォルトで利用できるようにします。
8. セキュリティは後付けではなく、組み込みます。 サプライチェーンセキュリティ、シークレット管理、脆弱性スキャン、ポリシー適用は、プラットフォームの責任です。
9. API ファーストで設計します。 プラットフォームのすべての機能を API 経由で利用できるようにし、自動化、セルフサービスポータル、CLI ツールを実現します。

関連スキル

• artifact-pyramids — 出力契約の仕様
• docker-compose — コンテナのライフサイクルと、複数コンテナの Compose オーケストレーション
• kubernetes — クラスター運用：マニフェスト、RBAC、ワークロード、Helm、アップグレード、トラブルシューティング
• terraform — Terraform/OpenTofu の実行：plan/apply ワークフロー、状態バックエンドとロック、ドリフト検出、アップグレードとリファクタリング
• telemetry — Prometheus/OpenTelemetry Collector/Loki スタックの運用：スクレイプ設定、ルールファイル、保持期間、高可用性
• postgres — PostgreSQL の運用：設定レビュー、インデックスとクエリプランの診断、バキューム／肥大化、バックアップ／PITR、レプリケーションとフェイルオーバー
• grafana — Grafana のプロダクト業務：ダッシュボード、パネル、データソース、アラートルール、コンタクトポイント、通知ポリシー
• traefik — リバースプロキシとイングレスの設定
• tailscale — メッシュネットワーキングと ACL ポリシー
• implementation-planning — 作業の分解と依存関係の順序付け
• mermaid-diagrams — アーキテクチャ図の生成
• site-reliability-engineering — デプロイ後の信頼性を扱う関連領域
• release-engineering — リリースプロセス、アーティファクトの昇格、準備状況、ロールアウト、ロールバックポリシー。このスキルは、それらの判断を実装するデリバリープラットフォームを担当します。