/blog/CLAUDE.md

Path: blog/CLAUDE.md

Blog CLAUDE.md

Structure

• src/app/ - Next.js App Router pages
• src/articles/ - MDX article files (draft writing)
• src/components/ - React components (article typography, MDX, shared UI)
• src/design-system/ - Zudo Design System CSS tokens and theme
• src/lib/ - Data layer (article reader, types, utils)

Article Writing Rules

Before editing or creating article content in src/articles/, read and follow these rule documents:

• ../doc/docs/overview/writing-style.md
• ../doc/docs/overview/markdown-writing-rule.md
• ../doc/docs/overview/vocabulary-rule.md

URL Reference Guidelines

When the user provides URLs starting with http://zpaper-blog.localhost:15567/pj/zpaper/ in the conversation:

• DO NOT fetch the URL - These are local blog URLs served by Next.js
• Instead, find and read the corresponding source file in this directory
• Map URLs to file paths following Next.js App Router routing:
  • http://zpaper-blog.localhost:15567/pj/zpaper/ → src/app/page.tsx (homepage)
  • http://zpaper-blog.localhost:15567/pj/zpaper/articles/ → src/app/articles/page.tsx
  • http://zpaper-blog.localhost:15567/pj/zpaper/articles/some-slug/ → src/articles/some-slug.mdx