# y-brew Full AI Index Source site: https://y-brew.vercel.app Primary language: Japanese (ja-JP) Content domains: frontend engineering notes, CMS implementation logs, coffee logs ## Recommended retrieval flow 1. Use /llms.txt first for the short index. 2. In this file, prioritize the Tech Articles section for implementation questions. 3. Open blocks_url when you need block-level structure, or md_url when you need the full article body in Markdown. 4. Use url as the canonical page when citing or linking back to the source. ## Canonical entry points - Home: https://y-brew.vercel.app/ - Tech list: https://y-brew.vercel.app/tech - Coffee beans list: https://y-brew.vercel.app/coffee/beans - Coffee brews list: https://y-brew.vercel.app/coffee/brews ## Retrieval policy - Prefer detail pages over list pages when citing implementation details. - Prefer blocks_url for structural extraction and md_url for prose ingestion when available. - Prefer most recent updatedAt if multiple pages overlap. - If a detail page conflicts with this file summary, trust the detail page. - For tech article selection, use summary, key_points, and section_headings before opening the full body. ## Tech Articles - title: microCMS で Content as Code url: https://y-brew.vercel.app/tech/gvmvfq_gz1 md_url: https://y-brew.vercel.app/tech/gvmvfq_gz1/markdown blocks_url: https://y-brew.vercel.app/tech/gvmvfq_gz1/blocks delivery_hint: use blocks_url for structure-first reads, md_url for prose-first reads published: 2026-03-15 updated: 2026-03-15 tags: - intent: case_study evergreen: true last_reviewed: 2026-03-15 prerequisites: headless CMS の基本的な運用イメージ, Git / PR ベースの開発フローへの理解, AI エージェントや CLI を使った作業に関心があると読みやすい key_points: Lee Robinson の問題提起を5つに整理し、そのうち自分が強く反応した論点を切り出したこと, microCMS を消さずに、Git / CLI を入口として追加するアプローチを試したこと, GitHub Actions で Git から microCMS へ同期する最小フローを検証したこと, managed state や stale_remote など、実運用で見えた詰まりどころを整理したこと section_headings: はじめに, Lee さんの記事で、何が問題だとされていたのか, 今回試したアプローチ, 実際にやってみて良かったこと, やってみて詰まったところ, ここまで試して見えたこと, 逆方向同期はどう考えているか, 向いていそうなケース / 向かないかもしれないケース, いまの時点でのまとめ summary: Lee Robinson の問題提起を手がかりに、microCMS CLI と GitHub Actions を使って microCMS でも Content as Code 的な運用がどこまで現実的かを検証した記事です。管理画面の強みを残しつつ Git を入口にするアプローチと、実際に詰まった点を整理しています。 - title: microCMS CLIでagent skillを生成物として扱うために、npm同梱と更新漏れチェックから始めた話 url: https://y-brew.vercel.app/tech/oymrs5sya87 md_url: https://y-brew.vercel.app/tech/oymrs5sya87/markdown blocks_url: https://y-brew.vercel.app/tech/oymrs5sya87/blocks delivery_hint: use blocks_url for structure-first reads, md_url for prose-first reads published: 2026-03-07 updated: 2026-03-12 tags: - intent: - evergreen: false last_reviewed: 2026-03-07 prerequisites: - key_points: - section_headings: 背景, 変更前の状態, 詰まったポイント, 自分なりの整理, 対応, 結果, 再利用ルール summary: microCMS CLIでagent skillを手書きの補助資料ではなく生成物として扱い、npm同梱と更新漏れチェックを先に整えた判断をまとめた記事です。 - title: microCMS CLI v0.6.0：taskコマンドと確認メタデータで運用を整えてみた url: https://y-brew.vercel.app/tech/ebnn5qtr9 md_url: https://y-brew.vercel.app/tech/ebnn5qtr9/markdown blocks_url: https://y-brew.vercel.app/tech/ebnn5qtr9/blocks delivery_hint: use blocks_url for structure-first reads, md_url for prose-first reads published: 2026-03-04 updated: 2026-03-04 tags: - intent: - evergreen: false last_reviewed: 2026-03-05 prerequisites: - key_points: - section_headings: はじめに, 今回の変更点, 1. taskコマンドを追加, 2. dry-run 出力に確認メタデータを追加, 3. agent eval テストを追加, なぜこの改善を入れたのか, どういう場面で効きそうか, まとめ summary: mcms-cli v0.6.0 で追加した task コマンド、確認メタデータ、agent eval テストの背景と使いどころをまとめた記事。 - title: microCMS CLI v0.4.0：運用・自動化のための6機能を追加 url: https://y-brew.vercel.app/tech/microcms-cli-v040 md_url: https://y-brew.vercel.app/tech/microcms-cli-v040/markdown blocks_url: https://y-brew.vercel.app/tech/microcms-cli-v040/blocks delivery_hint: use blocks_url for structure-first reads, md_url for prose-first reads published: 2026-03-03 updated: 2026-03-04 tags: - intent: case_study evergreen: false last_reviewed: 2026-03-01 prerequisites: 前回記事「microCMS CLIを作ってみた」の内容, microCMSの基本概念（Content API / Management API）, シェル/CLIの基本操作 key_points: 既存API変更なし・CLI側ロジックのみで運用機能を実現する設計制約, export/importによるデータ移行、schema diffによるCI連携、content diffによるレビューワークフロー, content bulkの操作定義ファイルによる作業のコード化, 機能の組み合わせで想定するワークフロー例（CI、環境移行、コンテンツレビュー） section_headings: はじめに, 共通の設計方針, content export：コンテンツ一括エクスポート, なぜ作ったか, 使い方, 実現方法, content import：コンテンツ一括インポート, なぜ作ったか, 使い方, 実現方法, schema diff：スキーマ変更検知, なぜ作ったか, 使い方, 実現方法, content diff：本番 vs 下書き差分表示, なぜ作ったか, 使い方, 実現方法, content bulk：一括操作, なぜ作ったか, 使い方, 実現方法, types sync：スキーマ取得＋型生成のワンコマンド化, なぜ作ったか, 使い方, 実現方法, 機能の組み合わせ：想定しているワークフロー, CI連携：スキーマ変更の自動検知, 環境移行：ステージングから本番へ, コンテンツレビュー：下書きの差分確認, まとめ summary: microCMS CLI v0.4.0で追加した6機能（content export/import、schema diff、content diff、content bulk、types sync）の概要と、既存APIの組み合わせで運用・自動化を実現する設計意図を解説。 - title: microCMS × visual-json を試してみた url: https://y-brew.vercel.app/tech/hbhsps0rng4a md_url: https://y-brew.vercel.app/tech/hbhsps0rng4a/markdown blocks_url: https://y-brew.vercel.app/tech/hbhsps0rng4a/blocks delivery_hint: use blocks_url for structure-first reads, md_url for prose-first reads published: 2026-03-02 updated: 2026-03-14 tags: - intent: case_study evergreen: true last_reviewed: - prerequisites: ヘッドレス CMS の運用経験, JSON / JSON Schema の基本的な理解, 前回記事（json-render × microCMS）の内容があると理解しやすい key_points: visual-json の Schema-aware はフォーム自動生成ではなくバリデーション機能, visual-json × microCMS では TreeView 閲覧、DiffView 差分表示、バリデーション付き編集が可能, microcms-schema-adapter は microCMS → JSON Schema の変換ライブラリとして汎用的な価値がある, JSON Schema エコシステム（バリデーション、型生成、フォーム生成、AI 連携）への展開が可能, 海外 CMS（Contentful、Sanity）のスキーマエクスポートに相当する仕組みを非公式ながら実現 section_headings: はじめに, 登場するツール, visual-json, microcms-schema-adapter, 何がしたかったか, 期待と現実のギャップ, visual-json × microCMS で実際にできること, 1. microCMS のコンテンツ JSON をツリー表示で閲覧・編集, 2. コンテンツの変更前後の差分を可視化, 3. JSON Schema バリデーション付きの編集, visual-json のデモ（GIF）, 「Schema-aware」がイメージしやすかった具体例, ネストが深い JSON を扱うときの例, 生 JSON 編集と比べて楽だった点, この検証での最小フロー（Playground → mcms-cli）, microcms-schema-adapter を作って見えたこと, JSON Schema があると何ができるか, 海外ヘッドレス CMS との比較, 次にやってもいいかなと思っていること, 前回記事との関係, まとめ summary: Vercel Labs の visual-json と自作の microcms-schema-adapter を使い、microCMS コンテンツの視覚的編集を試みた検証メモ。visual-json の Schema-aware はフォーム自動生成ではなくバリデーション機能だったが、schema-adapter は JSON Schema エコシステムへの橋として想定以上の汎用性があった。 - title: microCMS CLIを作ってみた url: https://y-brew.vercel.app/tech/microcms-cli md_url: https://y-brew.vercel.app/tech/microcms-cli/markdown blocks_url: https://y-brew.vercel.app/tech/microcms-cli/blocks delivery_hint: use blocks_url for structure-first reads, md_url for prose-first reads published: 2026-02-21 updated: 2026-02-23 tags: - intent: case_study evergreen: false last_reviewed: 2026-02-23 prerequisites: microCMSの基本概念（Content API / Management API）, シェル/CLIの基本操作, AIエージェント（Codex/Claude Codeなど）の利用経験があると読みやすい key_points: Agentic Coding時代におけるCMS操作のボトルネックとCLI導入意図, --json出力と終了コード固定がAI自動化に効く理由, validate/createの判定ズレなど、実運用で見えた改善ポイント, 実際にmedia listを追加したフィードバックループの記録 section_headings: 背景：Agentic CodingでCMSの使われ方が変わりつつある, なぜAPIやMCPだけでなくCLIなのか, CLIの概要, コマンド体系, 設計で意識したこと, 最小の利用例, AIエージェントに実際に触らせてみた, やったこと, うまくいったこと, 見つかった課題, フィードバックから改善したこと, この体験から感じたこと, 現時点でのまとめ summary: microCMS向けCLIを個人開発し、AIエージェント運用で有効だった設計（安定したJSON出力・終了コード設計・validate→createフロー）と、検証で見つかった課題（validateとcreateの差分、media list不足）を実例ベースで整理した検証ログです。 - title: json-render × microCMS を試してみた url: https://y-brew.vercel.app/tech/daisxqeaqyfa md_url: https://y-brew.vercel.app/tech/daisxqeaqyfa/markdown blocks_url: https://y-brew.vercel.app/tech/daisxqeaqyfa/blocks delivery_hint: use blocks_url for structure-first reads, md_url for prose-first reads published: 2026-02-19 updated: 2026-03-14 tags: - intent: comparison evergreen: true last_reviewed: 2026-02-23 prerequisites: ヘッドレスCMSの運用経験, React/Next.jsでのコンポーネント構成の基本知識, JSONベースでUIを定義する発想への理解 key_points: json-renderを『実装ゼロ化』ではなく『UI構成運用の分離』として捉える視点, microCMSにspecを置いた場合に変えやすい要素（順序・表示ON/OFF・導線文言）, 生JSON編集の運用負荷と、入力層/生成層を分離する改善案, 要件次第で効く選択肢であり、常に最適解ではないという判断 section_headings: はじめに, 自分なりの理解, 最小コード例（イメージ）, microCMS と合わせると何が変わるか, 試す余地があると感じた場面, 試してみて一番気になった点, いまの時点でのまとめ summary: json-render と microCMS を組み合わせ、UI構成変更を運用側で扱えるかを検証したメモです。採用が向く条件（見せ方の頻繁な調整・短サイクル検証）と、運用時の難所（生JSON編集の複雑さ）を整理しています。 ## Coffee Beans - name: ホンジュラス シエリト・リンド / Job Neel Caceres url: https://y-brew.vercel.app/coffee/beans/mv74x-lctk updated: 2026-03-16 origin: ホンジュラス, El Cielito, Santa Barbara roast: 浅煎り tags: ホンジュラス, 浅煎り - name: コロンビア エディルベルト・ウレゴ・ピネダ url: https://y-brew.vercel.app/coffee/beans/n76xgwtzi8 updated: 2026-02-17 origin: コロンビア, Cundinamarca roast: 浅煎り tags: コロンビア, 浅煎り - name: エルサルバドル ファミリア・ディアス url: https://y-brew.vercel.app/coffee/beans/euqakpzsv2h updated: 2026-02-17 origin: エルサルバドル, Chalatenango roast: 浅煎り tags: エルサルバドル, 浅煎り - name: エルサルバドル ラ・ミナ url: https://y-brew.vercel.app/coffee/beans/pttx4bs8r updated: 2026-02-17 origin: エルサルバドル, チャラテナンゴ roast: 浅煎り tags: 浅煎り - name: エチオピア ベダネ・マゲッソ ナチュラル url: https://y-brew.vercel.app/coffee/beans/aggd8vqgal updated: 2026-01-31 origin: エチオピア, イルガチェフェ roast: 浅煎り tags: エチオピア, 浅煎り ## Coffee Brews - title: エルサルバドル ラ・ミナ - 2026-02-17 url: https://y-brew.vercel.app/coffee/brews/0n5i3j0mkr7b method: ドリップ rating: 9/10 notes: 軽やかな口当たりで、レモンピールのような明るさ。後半に黒糖系の甘さが出る。 - title: エルサルバドル ファミリア・ディアス - 2026-02-17 url: https://y-brew.vercel.app/coffee/brews/yx8-uopigm method: ドリップ rating: 8/10 notes: 黄桃のような甘さとキャラメル感。温度が下がるとやわらかな柑橘の余韻。 ## Freshness - tech_total: 7 - beans_total: 5 - brews_total: 2 ## Crawling policy - robots: https://y-brew.vercel.app/robots.txt - sitemap: https://y-brew.vercel.app/sitemap.xml - llms_short: https://y-brew.vercel.app/llms.txt