From db6daf88f10573c87d9c7cde431158a18ccf60b8 Mon Sep 17 00:00:00 2001 From: wadackel Date: Fri, 10 Apr 2026 14:24:25 +0900 Subject: [PATCH] chore: add CLAUDE.md for Claude Code guidance Co-Authored-By: Claude Opus 4.6 (1M context) --- CLAUDE.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..504e344 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,35 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## Development + +- Setup: `mise install && pnpm i` +- Build: `pnpm build` (bundles into dist/ via @vercel/ncc) +- Test: `pnpm test` (vitest), single file: `pnpm vitest run src/.test.ts` +- Lint: `pnpm lint` +- Format: `pnpm format` (eslint --fix + prettier) +- Typecheck: `pnpm typecheck` +- Generate: `pnpm generate` (docs, inputs, unicode-regex + format) + +## Important: dist/ and Generated Files + +`dist/` is committed to the repository (required for GitHub Actions). CI verifies that `dist/` matches the build output and generated files have no drift. + +After changes: + +1. Run `pnpm build` to rebuild dist/ +2. Run `pnpm generate` if you modified action.yaml inputs, unicode handling, or documentation +3. Commit the updated dist/ and any generated file changes + +## Code Style + +- Prefer `type` over `interface` for TypeScript type definitions +- Use parjs (parser combinator library) for parsing logic, not regex +- ESM modules (`"type": "module"`) +- Conventional commits enforced via commitlint +- Prettier: 120 char width, single quotes, trailing commas + +## Language + +All source code, comments, commit messages, and documentation must be written in English.