# y-brew Agent Index

y-brew is a personal website about frontend engineering notes and coffee logs.
Primary language: Japanese (ja-JP).
Primary agent-ready domain: Tech Articles.

## Recommended retrieval flow
1. Start with this file to choose the content domain.
2. For implementation details, move to llms-full.txt and select the closest tech article.
3. Read /tech/{id}/blocks for structure-first ingestion, or /tech/{id}/markdown for full prose.
4. Use the HTML page as the canonical citation target.
5. Treat updatedAt and lastReviewedAt as the main freshness signals.

## Main sections
- Home: https://y-brew.vercel.app/
- Tech Articles: https://y-brew.vercel.app/tech
- Coffee Beans: https://y-brew.vercel.app/coffee/beans
- Coffee Brews: https://y-brew.vercel.app/coffee/brews

## AI retrieval hints
- Full AI index: https://y-brew.vercel.app/llms-full.txt
- Prefer Tech Articles when the question is about implementation, frontend, Next.js, microCMS, or content workflow.
- Every tech article has alternates at /tech/{id}/markdown and /tech/{id}/blocks, and both are listed in llms-full.txt.
- HTML tech detail pages expose Markdown and block JSON alternates via rel=alternate.

## Latest tech articles
- title: microCMS で Content as Code
  html_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
  updated: 2026-03-15
  summary: Lee Robinson の問題提起を手がかりに、microCMS CLI と GitHub Actions を使って microCMS でも Content as Code 的な運用がどこまで現実的かを検証した記事です。管理画面の強みを残しつつ Git を入口にするアプローチと、実際に詰まった点を整理しています。
  key_points: Lee Robinson の問題提起を5つに整理し、そのうち自分が強く反応した論点を切り出したこと, microCMS を消さずに、Git / CLI を入口として追加するアプローチを試したこと, GitHub Actions で Git から microCMS へ同期する最小フローを検証したこと, managed state や stale_remote など、実運用で見えた詰まりどころを整理したこと
- title: microCMS CLIでagent skillを生成物として扱うために、npm同梱と更新漏れチェックから始めた話
  html_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
  updated: 2026-03-12
  summary: microCMS CLIでagent skillを手書きの補助資料ではなく生成物として扱い、npm同梱と更新漏れチェックを先に整えた判断をまとめた記事です。
  key_points: -
- title: microCMS CLI v0.6.0：taskコマンドと確認メタデータで運用を整えてみた
  html_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
  updated: 2026-03-04
  summary: mcms-cli v0.6.0 で追加した task コマンド、確認メタデータ、agent eval テストの背景と使いどころをまとめた記事。
  key_points: -
- title: microCMS CLI v0.4.0：運用・自動化のための6機能を追加
  html_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
  updated: 2026-03-04
  summary: microCMS CLI v0.4.0で追加した6機能（content export/import、schema diff、content diff、content bulk、types sync）の概要と、既存APIの組み合わせで運用・自動化を実現する設計意図を解説。
  key_points: 既存API変更なし・CLI側ロジックのみで運用機能を実現する設計制約, export/importによるデータ移行、schema diffによるCI連携、content diffによるレビューワークフロー, content bulkの操作定義ファイルによる作業のコード化, 機能の組み合わせで想定するワークフロー例（CI、環境移行、コンテンツレビュー）
- title: microCMS × visual-json を試してみた
  html_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
  updated: 2026-03-14
  summary: Vercel Labs の visual-json と自作の microcms-schema-adapter を使い、microCMS コンテンツの視覚的編集を試みた検証メモ。visual-json の Schema-aware はフォーム自動生成ではなくバリデーション機能だったが、schema-adapter は JSON Schema エコシステムへの橋として想定以上の汎用性があった。
  key_points: visual-json の Schema-aware はフォーム自動生成ではなくバリデーション機能, visual-json × microCMS では TreeView 閲覧、DiffView 差分表示、バリデーション付き編集が可能, microcms-schema-adapter は microCMS → JSON Schema の変換ライブラリとして汎用的な価値がある, JSON Schema エコシステム（バリデーション、型生成、フォーム生成、AI 連携）への展開が可能, 海外 CMS（Contentful、Sanity）のスキーマエクスポートに相当する仕組みを非公式ながら実現

## Freshness snapshot
- Latest tech updated: 2026-03-15
- Latest bean updated: 2026-03-16
- Latest brew updated: 2026-02-17

## Crawling policy
- robots: https://y-brew.vercel.app/robots.txt
- sitemap: https://y-brew.vercel.app/sitemap.xml