zpaper-draft

Type to search...

to open search from anywhere

/CLAUDE.md

CLAUDE.md at /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

Personal writing helper project — a pnpm monorepo. Directory-specific instructions are in each package’s CLAUDE.md.

Main Packages

  • Blog (/blog/) - Astro 6 blog for draft article writing → blog/CLAUDE.md
  • Doc (/doc/) - zudo-doc (Astro 6) documentation site for writing rules and references → doc/CLAUDE.md
  • Cloudflare Functions (/functions/) - Serverless API (search, keyword logging) → functions/CLAUDE.md

Supporting Directories

  • Sub-packages (/sub-packages/) - Standalone packages (keyword-viewer, kumiko-gen, md-plugins, svg-to-png)
  • Tauri apps (/blog/src-tauri/, /doc/src-tauri/) - Tauri v2 desktop wrappers for blog and doc sites
  • Scripts (/scripts/) - Project-level scripts (b4push.sh, setup-worktree-env.sh)
  • Resources (/_resources/) - Assets (OGP images)

Repository Visibility

This repository is private/closed. When writing articles about this project, do not include concrete file paths, PR URLs, or other repository-specific details that would expose the internal structure.

Language Guidelines

Conversation language: English

  • Use English when communicating with Claude Code

Article/Documentation language: Japanese

  • All articles and documentation content in /doc/src/content/docs/ and /blog/src/articles/

Code and Config: English

  • Variable names, function names, commit messages in English

Package Manager

pnpm with workspaces. Always use pnpm (not npm/yarn). Root scripts delegate to packages via pnpm --filter <package> <command>.

Development Commands

# Blog (Astro)
pnpm dev          # Start blog dev server (port 15567)
pnpm build        # Build blog for production (RSS + search index + astro build)
pnpm serve        # Serve blog static export
pnpm app:blog     # Start Tauri blog wrapper app

# Doc (zudo-doc / Astro)
pnpm doc:start    # Start doc dev server (port 15566, build-then-serve)
pnpm doc:build    # Build doc for production
pnpm app:doc      # Start Tauri doc wrapper app