Infrastructure as Code

概要

Infrastructure as Codeの原則に基づく構成管理の自動化を専門とするスキル。 環境変数管理、Secret管理、Railway統合を中心に、再現可能なインフラ構成を実現します。

詳細な手順や背景は references/Level1_basics.md と references/Level2_intermediate.md を参照してください。

ワークフロー

Phase 1: 環境変数設計

目的: プロジェクトの環境変数構成を設計し、.env.exampleを整備

アクション:

1. 必要な環境変数を洗い出し
2. 命名規則と分類を決定
3. バリデーションルールを定義
4. assets/env-example-template.txt をベースに.env.example作成

Task: agents/environment-design.md を参照

Phase 2: シークレット管理

目的: GitHub Secrets/Railway Secretsの安全な管理戦略を実装

アクション:

1. シークレット分類（開発/ステージング/本番）
2. ローテーション戦略の策定
3. アクセス制御の設定

Task: agents/secret-manager.md を参照

Phase 3: Railway統合構成

目的: Railway.jsonとデプロイ構成の最適化

アクション:

1. assets/railway-json-template.json をベースに設定
2. 環境別ビルド/スタートコマンド定義
3. scripts/validate-env.mjs で検証

Task: agents/railway-configurator.md を参照

Phase 4: 検証と完了

目的: 構成の整合性確認と記録

アクション:

1. agents/railway-validator.md で検証実行
2. 環境間の差分レポート作成
3. scripts/log_usage.mjs で記録

ベストプラクティス

すべきこと

• Railway構成を設計・最適化する時
• 環境変数とSecretの管理戦略を設計する時
• 複数環境間の構成差分を最小化する時
• ローカル開発環境とクラウド環境を同期する時

避けるべきこと

• シークレットをソースコードにハードコード
• 環境変数のバリデーションを省略
• 環境間の設定差分を文書化せずに運用

Task仕様ナビ

詳細仕様: 各Taskの詳細は agents/ ディレクトリの対応ファイルを参照

リソース参照

references/（詳細知識）

scripts/（決定論的処理）

assets/（テンプレート）

コマンドリファレンス

リソース読み取り

cat .claude/skills/infrastructure-as-code/references/Level1_basics.md
cat .claude/skills/infrastructure-as-code/references/Level2_intermediate.md
cat .claude/skills/infrastructure-as-code/references/Level3_advanced.md
cat .claude/skills/infrastructure-as-code/references/Level4_expert.md
cat .claude/skills/infrastructure-as-code/references/environment-variables.md
cat .claude/skills/infrastructure-as-code/references/iac-principles.md
cat .claude/skills/infrastructure-as-code/references/legacy-skill.md
cat .claude/skills/infrastructure-as-code/references/railway-integration.md
cat .claude/skills/infrastructure-as-code/references/secrets-management.md

スクリプト実行

node .claude/skills/infrastructure-as-code/scripts/log_usage.mjs --help
node .claude/skills/infrastructure-as-code/scripts/validate-env.mjs --help
node .claude/skills/infrastructure-as-code/scripts/validate-skill.mjs --help

テンプレート参照

cat .claude/skills/infrastructure-as-code/assets/env-example-template.txt
cat .claude/skills/infrastructure-as-code/assets/railway-json-template.json

変更履歴