Architecture

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

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

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サービスの比較、設計原則・パターン・ベストプラクティスの適用に使うことで、汎用プロンプトよりも迷いを減らしながら判断できます。