/src/CLAUDE.md

CLAUDE.md at /src/CLAUDE.md

Path: src/CLAUDE.md

src/ Directory Guidelines

Tag & Category System

Tags and categories use a dual-key system: ASCII key for URLs + Japanese label for display. Before writing or editing tags/categories in MDX frontmatter, invoke /l-tagging for blacklist, content-type patterns, and full rules.

• Config: lib/data/taxonomy.ts (tagLabelMapping and categoryLabelMapping arrays)
• Article tags: lib/data/taxonomy-articles.ts, Product tags: lib/data/taxonomy-products.ts
• Format: { key: "ascii-key", label: "日本語ラベル" }
• In MDX frontmatter, always use the key, not the label
• Blacklisted tags cause build failures — check TAG_BLACKLIST in lib/data/taxonomy.ts
• Do not invent niche tags — use registered tags or the closest existing one

// In lib/data/taxonomy.ts
{ key: "how-to-build", label: "組み立てガイド" },

// In MDX frontmatter
tags:
  - how-to-build

Japanese Text Rules

• Use 商品詳細 (product details) not 商品紹介 (product introduction) for product page references
• Use proper markdown headings (####), not bold text as section headings
• Bold (**text**) and italic (*text*) for inline emphasis only, never as headings

Correct:

#### Section Title

- List item with **inline emphasis** in the content

Incorrect:

**Section Title:**

- List item

MDX Content Conventions

• Articles in src/mdx/notes/ with date-based slugs
• Product intros follow naming: YYYY-MM-DD-<slug>-intro.mdx
• Fragments in src/mdx/fragments/ for reusable content blocks
• Use /l-add-product-page slash command for guided product creation
• Use /l-add-mercari-item slash command for Mercari listings