ai: update CLAUDE.md

Author: uhyo

CLAUDE.md

@@ -7,6 +7,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 This project generates alternative TypeScript standard library definitions with improved type safety. The architecture consists of:
 
 - **`build/`** - TypeScript build system and generation logic
+
   - `lib.ts` - Main script for generating improved lib definitions
   - `package.ts` - Script for building npm packages
   - `diff.ts` - Script for generating documentation diffs
@@ -25,6 +26,7 @@ This project generates alternative TypeScript standard library definitions with
 ## Essential Commands
 
 ### Build Commands
+
 ```bash
 # Compile TypeScript build scripts
 npm run build:tsc
@@ -40,6 +42,9 @@ npm run build:diff
 ```
 
 ### Testing
+
+NOTE that you should run `npm run build:lib` and then `npm run build:package` before running tests to ensure the latest changes are reflected.
+
 ```bash
 # Run type-level tests in tests/ directory
 cd tests && npm test
@@ -49,10 +54,12 @@ cd tests && npx tsd
 ```
 
 ### Development Workflow
+
 1. Modify type definitions in `lib/` directory
-2. Run `npm run build:tsc && npm run build:lib` to regenerate
+2. Run `npm run build:lib && npm run build:generate` to regenerate the output
 3. Test changes with `cd tests && npm test`
-4. Generate packages with `npm run build:package` if needed
+
+NOTE that the generated type definitions only take effect during the tests. When you want to debug the generated types, the only way is to write a test case in the `tests/` directory and run `npm test` to see how the types behave. Do not forget to run `npm run build:lib && npm run build:generate` after modifying the source definitions in `lib/`.
 
 ## Key Implementation Details
 
@@ -63,7 +70,8 @@ cd tests && npx tsd
 - All changes prioritize type safety over convenience, potentially causing breaking changes in existing codebases
 
 ## Important Files
+
 - `build/logic/generate.ts` - Core generation algorithm
-- `build/logic/ReplacementMap.ts` - Tracks lib modifications  
+- `build/logic/ReplacementMap.ts` - Tracks lib modifications
 - `lib/es5.d.ts` - Main improvements to core JavaScript APIs
-- `tests/src/` - Type-level tests for verifications
+- `tests/src/` - Type-level tests for verifications