人間・コーディングエージェント共通の作業規約。迷ったら **[Design.md](./Design.md)** を先に確認する。

AGENTS.md — MUNOLOGY リポジトリ作業ガイド

人間・コーディングエージェント共通の作業規約。迷ったら Design.md を先に確認する。

プロジェクト概要

Astro 5 静的サイト。記事は Content Collections（src/content/articles/）。
スタイル: Tailwind CSS + src/styles/global.css（デザイントークンは :root と Tailwind mun.* の両方で一致させる）。
本番 URL: astro.config.mjs の site（sitemap・OG の前提）。

パス	内容
`src/pages/`	ルーティング。`.astro` が URL になる。
`src/layouts/BaseLayout.astro`	`<html>`、計測、唯一の `<main id="main-content">`、Header/Footer。
`src/components/`	再利用 UI。
`src/content/`	`articles` コレクションとスキーマ `config.ts`。
`public/`	静的配信（画像・ファビコン）。
`docs/`	Git 手順、方針文書。理念の正本は `docs/PHILOSOPHY.md`、前提チェックは `docs/PREMISES.md`。
`docs/DESIGN.md`	Google DESIGN.md 形式（トークン YAML＋本文）。`npm run design:lint`。人間用の長文仕様は `Design.md`（大小文字非区別 FS ではルート `DESIGN.md` と混同しないよう `docs/` 配下に置く）。
レイアウト	`src/styles/global.css` の `layout-shell` / `layout-narrow` / `layout-hero-inner` 等。新規セクションは `container mx-auto px-6` ではなく上記＋ Design.md スペーシング節。

src/content/articles/ に .md を追加（またはテンプレート _template*.md を複製）。
フロントマターは src/content/config.ts の Zod スキーマ必須: title, description, author, date, category, tags, id 等。
draft: true は本番ビルドから除外される。
スラッグはファイル名（拡張子除く）。日本語ファイル名は URL エンコードされるため、英語スラッグ推奨。

Design.md — トークン・ルールの仕様書（人間可読の主文書）。
src/styles/global.css — :root 変数、.markdown-content、.hero-gradient-text、.card-bg 等。
tailwind.config.mjs — theme.extend.colors.mun と fontFamily.sans。
docs/DESIGN.md — エージェント向けの DESIGN.md 形式（@google/design.md で lint / export 可能）。トークン追加時は Design.md ／ CSS ／ Tailwind に加え、docs/DESIGN.md の YAML を揃え、npm run design:lint を通す。

新しい色を足す場合は 実装三箇所＋ docs/DESIGN.md を同期する。

npm install
npm run dev      # 開発
npm run build    # 本番ビルド
npm run preview  # ビルドプレビュー
npm run type-check

（ESLint / Prettier は未導入。導入する場合は package.json と本ファイルを更新すること。）