Dev

開発者向け「Mermaidダイアグラム」クイックスタート&チートシート

開発者向け「Mermaidダイアグラム」クイックスタート&チートシート

コードによる図解、トラブルなし。

Mermaidは、キャンバス上でボックスをドラッグするよりも、図をテキストとして記述することを好む人々のためのテキストベースの図作成ツールです。Markdownのような構文を使用して、フローチャート、シーケンス図、クラス図、状態機械図、タイムライン、ガントチャート、エンティティ関係図などを記述します。

AIアシスタントのアーキテクチャ:LLM、メモリ、ツール、ルーティング、可視化

AIアシスタントのアーキテクチャ:LLM、メモリ、ツール、ルーティング、可視化

実際に本格的なアシスタントはどのように構築されているか

本番環境向けのAIアシスタントは「プロンプト付きのLLM」ではありません。インテント(意図)を受け付け、状態を保持し、いつ検索を実行すべきか、いつ行動すべきかを決定し、障害のデバッグに必要なランタイムの詳細を公開するシステムなのです。

Pythonで堅牢なLLM構造化出力の検証

Pythonで堅牢なLLM構造化出力の検証

「雰囲気」に頼る解析をやめ、契約を検証せよ。

ほとんどのLLM「構造化出力」チュートリアルは、本気度にかけるものです。 それらは、JSONを丁寧な口調でリクエストし、モデルが適切に動作することを祈る方法を教えます。 それでは検証ではありません。 それは単に括弧で囲まれた楽観主義にすぎません。

実際に機能する分散システムにおける冪等性

実際に機能する分散システムにおける冪等性

重複する副作用を停止する

分散システムにおける冪等性(Idempotency)は、ネットワークが嘘つきになったり、キューがリトライしたり、クライアントがパニックに陥ったり、オペレーターが再生(replay)を実行したりした後に、あなたを救ってくれる性質です。本番環境のシステムにおいて、重複配信は普通のことです。しかし、重複した副作用こそがバグなのです。

開発者向け Claude Skills と SKILL.md:VS Code、JetBrains、Cursor

開発者向け Claude Skills と SKILL.md:VS Code、JetBrains、Cursor

実務で生き抜く Claude Skills を構築する

多くのチームは、Claude Skills を 2 つの方法のいずれかで誤用しています。SKILL.md を何でもありの dumping ground(ごみ箱)にするか、巨大なコピペプロンプトから卒業できないかのどちらかです。

OpenClawスキルエコシステムと実務向けの推奨スキル

OpenClawスキルエコシステムと実務向けの推奨スキル

保持すべきスキルと、スキップしてよいスキル

OpenClawには2つの拡張ストーリーがあり、それらは混同されやすいものです。

プラグインはランタイムを拡張します。スキルはエージェントの振る舞いを拡張します。

OpenClaw プラグイン — エコシステムガイドと実用的な選択

OpenClaw プラグイン — エコシステムガイドと実用的な選択

まずはプラグイン。スキルの名称を簡潔に。

この記事は、チャネル、モデルプロバイダー、ツール、音声、メモリ、メディア、Web 検索、その他ランタイムの表面機能などを追加するネイティブゲートウェイパッケージであるOpenClaw プラグインについて解説します。

アラートとワークフローのための Slack 連携パターン

アラートとワークフローのための Slack 連携パターン

Slack はワークフロー UI およびアラート配信レイヤーです。

Slack の統合は、1 つの HTTP コールでメッセージを送信できるため、欺瞞的に簡単に見えるかもしれません。 しかし、Slack を対話的で信頼性の高いものにする必要が出てきた時が、本物の面白い部分です。

アラートと制御ループ向けの Discord 統合パターン

アラートと制御ループ向けの Discord 統合パターン

Discord を安全でインタラクティブなアラートバスに変えましょう。

Discord をシステムとして扱う場合、イベントを公開する場所、人間が意思決定を行い、自動化がワークフローを継続させる場として扱うことで、本格的な統合の土台となります。

本番環境におけるアプリケーションアーキテクチャ:統合パターン、コード設計、およびデータアクセス

本番環境におけるアプリケーションアーキテクチャ:統合パターン、コード設計、およびデータアクセス

統合、コード構造、およびデータアクセスに関するパターン

アプリアーキテクチャに関する一般的なアドバイスは、実用性に欠けるほど抽象的であるか、あるいはスケールさせるには狭すぎる傾向があります。 ここでは、統合、コード構造、データアクセスにわたる本番環境向けシステムにおける実用的なトレードオフについて解説します。

Ollama、llama.cpp用のClaude Codeのインストールと設定、および料金

Ollama、llama.cpp用のClaude Codeのインストールと設定、および料金

ローカルモデルバックエンドに対応したエージェンティックコーディング

Claude Codeは、マーケティングが上手な自動補完ツールではありません。これはエージェント型コーディングツールです。コードベースを読み取り、ファイルを編集し、コマンドを実行し、開発ツールと統合します。

slog を用いた Go の構造化ログ出力:可観測性とアラート機能の実現

slog を用いた Go の構造化ログ出力:可観測性とアラート機能の実現

トレースと連携可能なクエリ可能な JSON ログ。

ログは、システムが炎上している状況でも使用できるデバッグインターフェースです。 問題となるのは、プレーンテキストのログは古くなりやすいという点です。フィルタリング、集計、アラートが必要になった瞬間、文章をパースし始めることになります。