TIL スタイルガイドの設計 — 完璧主義を捨てて「30秒で伝わる」を目指す
ブログ記事とは別に TIL(Today I Learned)セクションのスタイルガイドを設計した。中心にある思想は「書くハードルを下げ、読む価値を上げる」こと。ブログ記事との境界線、タイトルの付け方、トーンの使い分けを解説する。
すべてのブログ記事一覧
ブログ記事とは別に TIL(Today I Learned)セクションのスタイルガイドを設計した。中心にある思想は「書くハードルを下げ、読む価値を上げる」こと。ブログ記事との境界線、タイトルの付け方、トーンの使い分けを解説する。
Claude CodeにプロジェクトコンテキストをCLAUDE.mdで提供し、規約に沿ったコード生成を実現する。5セクション構成の設計思想と、355行の詳細版が逆効果になった発見を共有する。
8記事の執筆経験から、個人技術ブログのスタイルガイドを言語化した。中心にある思想は「読者の時間を最適化する」こと。タイトル、構成、コード量、まとめの書き方まで、各ルールの設計意図を解説する。
Velite に新しいコレクションを定義し、既存コンポーネントを最小限の適応で再利用して TIL セクションを実装。検索統合まで含めて、新しい依存関係はゼロだった。
再利用できる3つのパターン:Velite の default(false) による安全なスキーマ拡張、MAX_TAGS によるタグ溢れ対策、空のとき自動的に消えるセクションの条件付きレンダリング。
Strands Agents SDK の Agents as Tools パターンで複数エージェントを協調させる。要約エージェントと翻訳エージェントをオーケストレーターが連携させる実例をコードとメトリクスで確認する。
Strands Agents SDK のマルチターン会話と SlidingWindowConversationManager を実際に動かし、エージェントが会話を記憶する仕組みとコンテキストウィンドウの管理方法をコードで確認する。
Strands Agents SDK に MCP (Model Context Protocol) サーバーを接続し、外部ツールでエージェントを拡張する。AWS ドキュメント検索 MCP サーバーを実際に動かし、自作ツールとの併用パターンをコードとメトリクスで確認する。
Strands Agents SDK のカスタムツールを深掘りする。ツールの連鎖でマルチステップ動作を実現し、エラー時の LLM の挙動やシステムプロンプトによる出力制御を実際のコードとメトリクスで確認する。
Strands Agents SDK の Python Quickstart を実際に動かし、エージェントループ・カスタムツール・メトリクスの仕組みをコード付きで解説する。わずか数十行で動くエージェントの手軽さと設計思想が見えてくる。