ソフトウェアアーキテクトとしてClaudeを使う方法：Viktor Skillガイド

コードを書くことは簡単な部分です。誰も書く前にシステムの形を決めることこそ、プロジェクトが静かに成功するか失敗するかの分かれ目です。人々がClaudeをソフトウェアアーキテクトとして使うと、なぜそのように構築されているのかという理由なしに、図式的な答えが得られます。本物のAIソフトウェアアーキテクトはトレードオフを重視します。なぜならアーキテクチャとは、どの問題を選ぶかを決める学問だからです。

Viktorはそのアーキテクトです。彼はClaude、ChatGPT、または任意のAIチャットに一度ロードするデザインペルソナであり、単一の「最良」設計を提示することを拒みます。彼は構築する規模、チームの人数、制約条件を知りたがります。なぜなら、2人のスタートアップに適したアーキテクチャは銀行には不適切であり、その逆もまた然りだからです。

なぜ一般的なAIのアーキテクチャアドバイスは不十分なのか

指示なしでは、チャットボットはトレードオフを考慮せずに流行の技術を使った自信満々の答えを一つだけ提示します。規模や制約を無視し、週末プロジェクトにも企業にも同じマイクロサービスとKubernetesのスタックを推奨します。欠点が示されない設計はアーキテクチャではなく、単なる願望リストです。

Viktor Skillで何が変わるのか

Viktorは提案の前に規模、チームサイズ、予算、制約を尋ね、それからトレードオフを明示した複数の選択肢を提示します。コスト、複雑さ、失敗モードを含めて明確に理由付けし、スケーラビリティ、コスト、保守性について論理的に説明し、決定とその根拠を文書化して、決定した人が変わっても選択が残るようにします。流行の設計ではなく、正当化可能な設計が得られます。

実際に何を生み出すのか

トレードオフを含むアーキテクチャの選択肢、システムとデータフローの説明、理由付けを伴う技術選定、保持可能なアーキテクチャ決定記録、スケーリングとリスク分析。何を作るのか、どんな制約があるのかを説明すれば、彼がルートを示し、それぞれが将来どんなコストをもたらすか教えてくれます。

最大限に活用する方法

実際の制約—予想される規模、チームサイズ、予算、締め切り—を伝えてください。これらが良いアーキテクチャと一般的なものを分ける要素です。単一の答えではなく複数の選択肢を求め、トレードオフを見ながら選べるようにしましょう。そして決定とその理由を記録するよう依頼し、将来の自分が理由を覚えて再検討を避けられるようにしてください。

対象ユーザー

設計判断を行うテックリードやシニアエンジニア、コミット前に構築方法を決める創業者、思考のパートナーを求めるアーキテクト向けです。Claude、ChatGPT、またはシステムpromptを受け入れる任意のAIチャットで動作します。実際の開発には技術＆開発スキルコレクションがあり、コーディング、コードレビュー、デリバリーに特化したアシスタントが揃っています。