/CLAUDE.md

Path: CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a personal writing helper project with two main packages:

• Blog (/blog/) - Next.js blog for draft article writing
• Doc (/doc/) - Docusaurus documentation site for writing rules and references

Directory-specific instructions are in blog/CLAUDE.md and doc/CLAUDE.md.

Language Guidelines

Conversation language: English

• Use English when communicating with Claude Code
• Code comments can be in English

Article/Documentation language: Japanese

• All articles and documentation content should be written in Japanese
• This includes markdown files in /doc/docs/ and /blog/src/articles/

Code and Config: English

• Variable names, function names, and code structure in English
• Commit messages in English

Development Commands

# Blog (Next.js) - default commands
pnpm dev          # Start blog dev server
pnpm build        # Build blog for production
pnpm serve        # Serve blog static export

# Doc (Docusaurus)
pnpm doc:start    # Start doc dev server
pnpm doc:build    # Build doc for production
pnpm doc:check:fix # Run doc linting and formatting

File Types

• .mdx / .md - Documentation files (MDX supports JSX components)
• .tsx / .ts - TypeScript React components
• .css - Stylesheets
• .json - Configuration and generated data files