Architecture

architecture-decision-records は、Claude Code のセッション中に生まれるアーキテクチャ上の判断を、構造化された ADR として記録できるスキルです。意思決定のタイミングを捉え、背景、選択肢、判断理由を整理して残し、将来の保守担当者のために ADR の履歴を維持します。長く参照できる意思決定の記録が必要な Technical Writing やエンジニアリングチームに向いています。

improve-codebase-architecture は、コードベース内のアーキテクチャ上の摩擦、浅いモジュール、深さを持たせる余地を見つけるのに役立ちます。リファクタリングレビュー、テストしやすさの改善、AI が扱いやすい設計判断に使えます。特に、CONTEXT.md と docs/adr/ のガイダンスを尊重させたい場合に向いています。

migration-architect は、データベース、サービス、インフラの移行をゼロダウンタイムで進めるための計画づくりを支援します。段階的な実行、互換性検証、データ照合、ロールバック runbook を組み込み、Software Architecture チーム向けに移行計画、互換性チェック、ロールバック生成のスクリプトも提供します。

senior-architect は Software Architecture 向けの skill です。付属の Python スクリプトと参考資料を使い、システム設計、ADR、技術スタックの意思決定、スケーラビリティレビュー、依存関係分析、アーキテクチャ図の作成を支援します。

cto-advisor は、アーキテクチャ判断、技術的負債、エンジニアリング指標、技術評価、チーム拡大、戦略計画を支援する CTO リーダーシップ向け skill です。ADR、DORA、評価フレームワークに加え、負債分析とチームスケーリングのための Python ツールを備えています。

cto-review は、`/cs:cto-review <plan>` を使ってアーキテクチャ、スケーリングの限界、技術的負債、チーム立ち上げリスク、build-vs-buy の判断を検証する Strategic Planning スキルです。プロンプト中心の構成のため、インストール後は任意で参照されている analyzer scripts が利用できるか確認してください。

documentation-and-adrs は、エージェントが意思決定を軸にした技術ドキュメントやADRを作成するのを助けます。アーキテクチャ、API、インフラ、認証、機能変更について、背景、制約、トレードオフ、却下した案、影響を整理して残すのに向いています。未来のエンジニアやエージェントのために、見栄えのよい要約ではなく、長く使える判断根拠が必要な場面に最適です。

archimate は、PlantUML で `!include <archimate/Archimate>` を使って ArchiMate 図を作成できるようにする skill です。型付きの要素マクロとリレーションシップマクロを備え、ビジネス、アプリケーション、テクノロジー、モチベーション、移行計画といった階層的なエンタープライズアーキテクチャのビューに適しています。構造化された EA 記法が必要な Diagramming で使うもので、一般的なクラウド図やネットワーク図の代わりではありません。

kaizenスキルは、リファクタリング、アーキテクチャ、ワークフローの修正、エラー処理、検証に向けて、小さく安全なコード改善を進めるためのガイドです。反復的な変更、設計段階での予防、最小限の変更範囲を重視します。コードを過度に複雑化せず、実践的なkaizenの指針がほしいときに使えます。

clickhouse-architecture-advisor は、ワークロードを踏まえた判断で ClickHouse の設計を支援します。取り込み、パーティション設計、JOIN、辞書、UPSERT、事前集計まで、負荷特性に合わせて選べるのが強みです。Backend Development、可観測性、SIEM、プロダクト分析、IoT テレメトリ、金融系パイプラインで特に役立ちます。ガイダンスは `official`、`derived`、`field` として分類されます。

plan-eng-review は、実装開始前にアーキテクチャ、データフロー、エッジケース、テスト範囲、パフォーマンス、リリースリスクを固めるための、対話型のエンジニアリング計画レビュー用スキルです。設計書や実装計画があり、一般的なレビュー用プロンプトよりも踏み込んだフィードバックが欲しいときに使えます。

cloud-solution-architectスキルは、エージェントをAzureのクラウドソリューションアーキテクトのように振る舞わせ、クラウドアーキテクチャの意思決定を支援します。設計レビュー、アーキテクチャスタイルの選定、Azureサービスの比較、設計原則・パターン・ベストプラクティスの適用に使うことで、汎用プロンプトよりも迷いを減らしながら判断できます。