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

更新 18 分で読めます KissMySkills
このページ
  1. 1つの原因から生じる2つの失敗
  2. ボックスは簡単な部分です
  3. What it is genuinely good at
  4. どこで失敗するか
  5. Viktor Skillはどうやってインストールしますか?
  6. これは誰向けですか?
  7. 関連するSkillガイド
Skill · .md

このガイドの背後にあるSkill: Viktor - Software Architect AI Skill。すでに運用しているもの、変更できないもの、すでに決めたことを保持するため、選択肢は何もない場所ではなく、実際のシステムに基づいて絞り込まれて届きます - $19、1回の支払いで、永久にあなたのものです。

Viktor Skillを見る →

アーキテクチャとは、実行できないと決めたことの一覧です。モデルが伝えられるのは、設計ができることだけです。これは不誠実なのではありません。学習した資料は、機能したシステムについて、それを書く価値がある規模で運用した人々によって書かれています。そして、今も問題なく動いている退屈なモノリスについて記事を書く人はいません。だから返ってくるのは、常にグリーンフィールドで、常に最大規模です。あなたが想像したピーク時のシステムを、何もない場所に構築したものであり、差し押さえられた資産は省かれています。

1つの原因から生じる2つの失敗

役に立たないアーキテクチャの回答は、ほとんどすべて同じことに行き着きます。コーパスが、興味深い問題について、それを経験した人々によって書かれているのです。

何もない場所で設計します。 現実のアーキテクチャがグリーンフィールドであることは、ほとんどありません。実在するシステムに対する変更であり、実在する人員が担当し、触れることを許されていないものと接続されています。設計を求めると、そのどれも存在しない前提のものが返ってきます。そして、この分野で最も高くつく失敗は、間違ったデータベースを選ぶことではなく、制約が存在しないかのように設計することです。

ピークを前提に設計します。 イベント駆動、ドメインごとのサービス、すべてのコンポーネント間にキュー、基盤はKubernetes。これらは間違いではありません。それらを必要とした組織の記録であり、必要とせずにうまくやっていけた企業の記録は存在しません。だから文献の平均は、あなたの会社より大きな会社向けのアーキテクチャになります。

どちらも修正可能ですが、設計についてより良い質問をするだけでは、どちらも修正できません。モデルが前提としてよいことを変えることで修正します。

ボックスは簡単な部分です

アーキテクチャを求めると、ボックスと矢印が返ってきます。ボックスはほとんど無料です。明確な1つのことを行うサービスは解決済みの問題であり、誰でもその姿を思い描けます。

難しさはすべて矢印にあります。 2つのボックスの間にある矢印は、その2つが通信できるという主張ですが、その主張が図によって正当化されることはありません。呼び出しは同期的ですか。そうなら、呼び出し元は待っている200ミリ秒の間に何をするのでしょうか。失敗したらどうなりますか - リトライするのですか。そうなら、その操作は冪等ですか。それともリトライによってカードに2回請求されますか。タイムアウトはどのくらいで、その後はどうなりますか。順序は重要ですか。何かがそれを保証しますか。この矢印が1時間停止したら、何がまだ動き、何が動かなくなるのでしょうか。

A diagram answers none of that, and a model will generate a beautiful one anyway, because diagrams are a genre and it has read thousands. Interrogate the arrows, and the design usually changes. Frequently it collapses back into fewer boxes, which is the correct outcome.

What it is genuinely good at

図はそのどれにも答えない。それでもモデルは美しい図を生成する。図は一つのジャンルであり、モデルは何千もの図を読んでいるからだ。矢印を問いただせば、設計はたいてい変わる。多くの場合、箱の数が減る形に戻るが、それが正しい結果だ。

本当に得意なこと

障害の可能性を洗い出す。「これがうまくいかない方法はすべて何か」は、膨大な量の事後検証、インシデント報告、苦労して得られたコメントスレッドを横断する想起の問題であり、まさにこれらのツールが得意とすることだ。本番環境で8か月後に発見するはずだった障害モードを表面化してくれる。

できないのは、それらに順位を付けることだ。順位付けには、トラフィック、チーム、許容度、予算が必要だからだ。したがって役割分担は明確だ。一覧を生成するのはモデル、順序を決めるのはあなた。順序付けまでできると言う人は、何かを売り込んでいる。

Prompt 1 - フィールドは空ではない このページの他の部分は、モデルが既存のものを把握するまで何も機能しない。この点について、恥ずかしい部分も含めて正直に答えてほしい。 まだアーキテクチャを提案しないでほしい。 これから既存のものを説明する。読んだら、何かを提案する前に、まだ 何かを設計する前に、まだ何を知る必要があるのか教えてほしい。 現在稼働しているもの: - 言語、フレームワーク、データストア、ホスティング。実際に 現在の本番環境 - 何がどの頻度で、どのようにデプロイされているか - 現在の障害モード。実際に何がアラートを発生させるのか。 変更できないもの: - 私が所有していないシステム、壊せない連携、契約 動作を決めるもの - コンプライアンスまたはデータ所在地の制約 - 事業側が外部に対してコミットしていること 構築担当者: - エンジニアの人数、経験年数、そして誰が何を運用してきたか 本番環境で - 誰もこれまで運用したことのないもの - オンコール担当者がいるかどうか、そして有給かどうか 実際の数値: - 現在の負荷。予測値ではない。ユーザー数、リクエスト数、データ量。 - 実際に過去1年間で見られた成長。予測ではなく 計画 それから、何かを提案する前に、これらのうちどれを教えてほしいのか:

設計空間を最も制限する制約は何か、そして率直にどれが

私の回答のいくつかは、測定されたものというより願望のように聞こえる。

Prompt 2 - 廃止事項の一覧 モデルが決して自発的に語らない部分であり、実際に意思決定となる部分。 提案する各選択肢について、それが可能にすることから始めてはいけない 可能になること。廃止するものから始める。 各選択肢について: - その後できなくなること、または重大なコストをかけてしかできなくなることは何か? - 何が不可逆になり、元に戻すにはどれほどのコストがかかるのか? それを12か月後にもできるのか? - 何を保証しなくなるのか - 一貫性、順序付け、 可分性、個別にデプロイできる能力、能力 - システム全体を一人の頭で把握する - 現在は不可能な、どのような新しい種類のバグを可能にするのか? - それが必要かどうかにかかわらず、今後のすべての機能に何を強いるのか? その機能にそれが必要なのか? そのうえで、各選択肢について一文ずつ述べる。私たちがむしろ 持っている。 そのすべてを終えてから、各選択肢で何が可能になるのかを伝える。もし その選択肢に意味のある廃止事項がないなら、そう明言し、次のように扱う suspicious rather than as a recommendation.
Skill spotlight
Viktor - ソフトウェアアーキテクトAI Skill
Viktor - ソフトウェアアーキテクトAI Skill
$19 · one payment

推奨としてではなく、疑わしいものとして

Skillの注目項目

$19 · 1回払い

ここで違いを生むものを保持します: あなたがすでに運用しているもの、変更を許可されていないもの、そしてすでに決定したこと。毎回、空のチャットに実際の制約を再入力するのは、ほとんどの人が諦めてグリーンフィールドの回答を受け入れる理由です。そして新しいセッションは、先月合意したアーキテクチャと平然と矛盾します。 Viktorを表示 - ソフトウェアアーキテクトAI Skill → プロンプト3 - 矢印を詳細に検証する この設計のすべての矢印について、次に答えてください: 1. 同期か非同期か?同期なら、 待機中に呼び出し側は何をしていて、ユーザーには何が表示されるか? 2. 失敗した場合、何が起こるか?リトライ、失敗、キュー投入、縮退のどれか? 3. リトライする場合: 操作は冪等か?冪等でないなら、 重複が現実世界で実際に引き起こすことは何か - 二重請求、二重送信、二重カウントが起きるか? 4. タイムアウトはどのくらいか?期限切れになると何が起こるか? 5. ここでは順序が重要か?重要なら、何がそれを保証するのか? 何も保証されていないなら、そう言ってください。 6. この矢印が1時間停止した場合、何がまだ機能するか 何が起こらず、何が起こるのか?最初に気づくのは私たちか、それとも顧客か? 7. データ契約とは何か。一方の側が それを変えるか? 次に、その矢印のうち誰かを起こすことになるのはどれか、そして 不要なボックスを描いたから存在しているだけの矢印はどれか [PASTE OR DESCRIBE]

分離しているのは何か?名前を挙げてください。2つのボックスを統合するのも有効な回答です

それが当てはまるなら、ぜひ聞かせてほしい。

設計: プロンプト4 - 規模を10分の1にして設計する あなたが費やす時間の中で最も有益な1時間。これは、負荷を支える複雑さと、理想に過ぎない複雑さを切り分けるものであり、その答えは往々にして耳の痛いものになる。 今説明した設計を使って、同じシステムを設計する あなたに伝えた負荷の10分の1を、同じチームで処理する設計に 次に答えてください: - 何を削除したのか? - 削除したもののうち、どれが問題を解決していたのか 私が今実際に抱えている問題と、私が解決しようとしていた問題を 再追加する必要がある、測定可能な時点は何か?具体的に示して 数ではなく、「規模を拡大するとき」ではなく - 後から再追加するコストは、次と比べてどの程度か 最後に: 小さいバージョンを構築した場合、今それを構築しなかったことを2年後に後悔するのは何か?後回しにすることが本当に悪化する点は正直に述べる。 2年後、私は何を喜んでいるだろうか?両方の側面を論じる 私が選びそうな案について安心させるのではなく、適切に 好む。

プロンプト5 - 障害の可能性を洗い出し、その後で優先順位を付ける

このシステムが失敗するあらゆるパターンを生成する。網羅的に、選別するのではなく 選別するのではなく - 優先順位付けは私が行う。それはあなたの 仕事をしていて、私の数字を持っていない。 最低限、次を網羅する: - 各コンポーネントが単独で障害を起こした場合と、その影響 - 部分的な障害: 停止ではなく低速になる - データストア: 利用不能、低速、容量不足、破損、復元済み 古いバックアップから - 2つの部分の間のネットワーク分断 - 依存関係が私たちに知らせずに挙動を変える - 想定の10倍の負荷が1分間に集中して到来する - 負荷が偏って到来する:1人の顧客、1つのキー、1つのテナント - クロックスキュー、重複メッセージ、順序が入れ替わったメッセージ - 中途半端にロールアウトされたデプロイ - 有効だが非常識なデータ それぞれについて、何が壊れ、ユーザーには何が見え、どうやってそれを知り、 自己修復するかどうかを示す 次に、サイレントな障害、つまりシステムが稼働し続けるものの、障害が 答えを求められるものなのに、答えが間違っているものです。私が欲しいのはそれです 最上位にあるものを挙げてください。通常の設計レビューで 見落とす。

プロンプト6 - 実際にどうやってそこへ到達するか

グリーンフィールド設計はこれを飛ばすが、実際のコストが存在するのはここだ。移行経路のない目標アーキテクチャは、願望にすぎない。

私たちは何もないところから構築するわけではない。既に存在するものは次のとおり: [DESCRIBE]. ここから目標設計に至る道筋を、独立してリリース システムを常時稼働させたまま、それぞれを独立してリリースできるか。 各段階について: - 何がリリースされ、それが完了した後のシステム状態はどうなるか - ここで永久に止めても、今より良い状態でいられるか 今はどうなっているか?どの段階でも答えが「いいえ」なら、その段階は大きすぎる。 大きすぎる - 分割する。 - 旧経路と並行して稼働するものは何か、そしてどのくらいの期間か - 本番に入った後、事前ではなく、どうロールバックするか - 移行が必要なデータは何か。また、本当に移行する必要があるか 2度移行した - この段階で何が悪化し、誰がその影響を受けるか 次に、エンジニア週単位での総コストと、後戻りできなくなる時点。 リターンを上回るなら - その後は撤回が現実的でなくなる段階。 正直な答えが、移行のコストが 目標設計に価値があるなら、そう明言する。

それが知り得ないことを断言する二つの事柄

パフォーマンスの数値。設計が1秒あたり何リクエスト処理できるか、レイテンシーがどの程度になるかを尋ねると、数値を出してくる。実際には何も分かっていない。その数値は、ハードウェア、データの形状、クエリパターン、アクセス分布に依存し、得る唯一の方法は計測することだ。提示されたスループット、レイテンシー、容量の数値はすべて仮置きとして扱い、その数値があるべき場所に負荷テストを置くこと。

現在のバージョン、制限、料金。サービスクォータ、マネージドデータベースの制限、インスタンスサイズ、クラウドプロバイダーの料金、どのバージョンで何が非推奨になったか。これらはすべて変わり、モデルは最後に見た情報をもとに回答する。これらはすべて、決定する当日にプロバイダー自身の最新ドキュメントから確認すること。古いクォータを前提に構築したアーキテクチャは、最悪のタイミングで、導入から1年後に失敗する設計だからだ。

どこで失敗するか

障害 何が起きるか その対処法
デフォルトではグリーンフィールド 空のフィールド、レガシーなし、触れることを禁じられたものもないと仮定した設計 何かを要求する前に、恥ずかしい部分も含め、現在稼働しているものを説明する
ピーク時を前提に設計する その興味深い問題に直面し、それについて書いた企業のアーキテクチャ 同じシステムを負荷10分の1で要求し、その後比較する
機能だけで、差し押さえはない あなたが与えたもので設計が可能にすること。ただし、何を諦めたかは語られないまま まず差し押さえリストを要求し、何もない選択肢は疑わしいものとして扱う
美しい図 難しい問いがすべて矢印の中にあり、そのどれにも答えがないボックスと矢印 矢印を一つひとつ問いただす。2つのボックスを統合することも有効な結果です
捏造されたパフォーマンス 裏付けのない、1秒あたりのリクエスト数やレイテンシーの数値 あらゆる数値を負荷テスト用のプレースホルダーとして扱う
古いプラットフォーム情報 最後に確認した時点のクォータ、制限、インスタンスタイプ、価格 その時点のプロバイダーのドキュメントを、項目ごとに提示する
移行経路がない システムが稼働中のままそこへ到達する方法を考慮していない目標設計 独立してリリース可能なステップを要求し、それぞれの時点で停止できるようにする
尋ねれば優先順位を付けます どの失敗が最も重要か尋ねると、あなたの数字を一切使わずに答えます 空間を生成させます。順序付けはあなたが行います

Viktor Skillはどうやってインストールしますか?

ダウンロードは、アーカイブのルートにSKILL.mdがあるZIPであり、入れ子になったフォルダー内にはありません。このフォルダー構成が、アップロードに失敗する一般的な原因です。Claudeデスクトップアプリでカスタマイズ → Skillsを開き、ZIPをアップロードしてオンに切り替えます。

Skillsには、設定 → 機能でコード実行を有効にする必要があります。Anthropicのヘルプセンターでは現在、SkillsをFree、Pro、Max、Team、Enterpriseで利用できると記載していますが、AcademyのチュートリアルではPro、Max、Team、Enterpriseと記載されています。そのため無料プランを利用している場合は、どちらかのページの記載を鵜呑みにせず、設定 → 機能で自分のアカウントを確認してください。詳しい手順はSkillのインストールガイドにあります。

ChatGPTやGeminiでは、アップロード手順はありません:開いて SKILL.md、内容をコピーしてカスタム指示に貼り付けます。自動トリガー機能は失われますが、手法はそのまま使えます。

これは誰向けですか?

思考のパートナーとして反論してくれる相手を求めるアーキテクトやスタッフエンジニア、自分の給与等級を超える設計判断を下すテックリード、そして実際に着手する前にどう構築するかを決める創業者向けです。Claude、ChatGPT、または任意のAIチャットで動作します。

エンジニアリングの各ロールは、それぞれ独立したSkillsに分かれており、各19ドルの買い切りダウンロードです:

より幅広いセットは、ソフトウェア開発者Skillとソフトウェア&IT Skillです。

要約:

アーキテクチャとは、できないようにすると選択した事柄のリストです。そしてモデルは常に、能力しか説明しません。なぜなら、そのコーパスは、興味深く出版する価値のある問題に取り組んだ人々によって書かれているからです。何かを提案する前に、何がすでに稼働し、何を変更できず、誰が構築しているのかを伝えてください。可能にすることより先に、何をできなくするのかを尋ね、欠点のない選択肢は推奨ではなく警告とみなしてください。ボックスは無視して、すべての矢印を問いただしてください。失敗、順序付け、冪等性、影響範囲が存在するのはそこだからです。そして、2つのボックスを再び1つにまとめることも厭わないでください。負荷の10分の1を想定して同じシステムを設計し、どの複雑さが不可欠かを見極めてください。失敗の可能性をすべて生成させ、順位付けは自分で行ってください。そして移行経路を、途中で止められる段階に分けて示させてください。そこへ至る道筋のない目標設計は、願望にすぎないからです。セッション間で保持される実際の制約や過去の意思決定に対応するViktor - ソフトウェアアーキテクトAI Skill(19ドル)。Claude、ChatGPT、その他あらゆるAIチャットで利用でき、30日間の返金保証付きです。

Skill · .md · ClaudeとChatGPTで利用可能

Viktor - ソフトウェアアーキテクトAI Skill

何かを提案する前に、まず何がすでに稼働しているかを尋ねます。可能にすることではなく、設計によって何ができなくなるかを起点にし、ボックスを描くのではなく矢印を問いただし、途中で止められる段階に分けて移行経路を示します。サブスクリプション不要。永久にあなたのものです。

$19
Viktor Skillを入手 →

KissMySkillsは、Claude、ChatGPT、その他あらゆるAIチャット向けの2,000以上のAISkill、80以上のpromptパック、75以上のagent、および無料ツールを扱うマーケットプレイスです。

関連するSkillガイド

よくある質問

Can Claude design a software architecture?+

It can produce a design, and the design will be greenfield and maximal, because the material it learned from was written by people describing systems that worked at a scale worth writing about. Nobody publishes a post about the boring monolith that is still fine. So you get the architecture of a company larger than yours, on an empty field, with the foreclosures left out. That is correctable, but not by asking better questions about the design - only by changing what the model is allowed to assume.

Why does AI always suggest microservices and Kubernetes?+

Because those are the write-ups of organisations that genuinely needed them, and there are no write-ups of the companies that did fine without. The average of the literature is therefore an architecture for a larger company. The cheapest correction is to ask for the same system at one tenth of the load you stated, with the same team, then ask what was removed and at what specific measurable point each removed piece would need to come back.

What is an architecture, really?+

A list of things you have decided you will not be able to do. Choosing eventual consistency forecloses certain guarantees, choosing a monolith forecloses independent deployment, choosing a particular store forecloses certain shapes of growth. The foreclosures are the decision. A model leads with capabilities every time and will not volunteer what you gave up, so ask for the foreclosure list before the enablement list - and treat an option that appears to have no downsides as suspicious rather than as a recommendation.

Why are AI architecture diagrams misleading?+

Because the boxes are the easy part. A service that does one clear thing is a solved problem. All of the difficulty is in the arrows, and an arrow is a claim that two things can talk which the diagram never justifies. Synchronous or asynchronous, what happens on failure, whether a retry is safe, what the timeout is, whether order matters and what guarantees it, what still works if this arrow is down for an hour. Interrogate the arrows and the design usually changes, often collapsing back into fewer boxes.

What is AI genuinely good at in architecture work?+

Generating the failure space. Asking what are all the ways this can go wrong is a recall problem across an enormous body of postmortems and incident write-ups, which is exactly what these tools are for, and it will surface the failure mode you would otherwise have found in production in eight months. What it cannot do is rank them, because ranking needs your traffic, your team, your tolerance and your money. It generates the list, you order it.

Can it estimate how much load my design will handle?+

It will give you a number and it has no idea. Throughput, latency and capacity depend on your hardware, your data shape, your query patterns and your access distribution, and the only way to get them is to measure. Treat any performance figure it offers as a placeholder where a load test should go. The same applies to service quotas, managed-database limits, instance sizes and cloud pricing, all of which change and all of which it answers from whatever it last saw.

Why do AI designs never include a migration path?+

Because greenfield designs do not need one, and greenfield is what the corpus describes. In reality a target architecture with no route to it is a wish, and the migration is where most of the cost lives. Ask for the path in steps that each ship independently with the system live, and apply one test to every step: could we stop here permanently and still be better off than we are now? If the answer is no, the step is too big. Also ask where the point of no return is.

How do I install the Viktor skill?+

The download is a ZIP with SKILL.md at the root of the archive rather than inside a nested folder, which is the usual reason an upload fails. In the Claude desktop app open Customize, then Skills, upload the ZIP and toggle it on. Skills need code execution enabled, under Settings then Capabilities. Anthropic's help centre currently lists Skills on Free, Pro, Max, Team and Enterprise, while its Academy tutorial lists Pro, Max, Team and Enterprise, so if you are on the free plan check Settings then Capabilities for your own account rather than trusting either page. In ChatGPT or Gemini there is no upload step, so open SKILL.md, copy the contents and paste them into custom instructions.

~/get-started

役立つSkills。無駄なし。

ストア内のすべてのskill、prompt pack、agentを閲覧できます。

すべてのスキルを見る →または無料ツールを試す