📚 Documentation: Add development workflow scripts to CLAUDE.md

.gitignore

@@ -8,4 +8,5 @@ node_modules
 .env
 config.json
 .idea
-.cursor
+.cursor
+.claude/settings.local.json

.serena/memories/code_style_conventions.md

@@ -0,0 +1,25 @@
+# Code Style & Conventions
+
+## TypeScript Standards
+- **Strict TypeScript mode** with 2-space indentation
+- **Target**: Node.js 18+ with ES2022 features
+- **Import Style**: Prefer `@/` alias for imports (maps to `src` directory)
+- **Type Definitions**: Strong typing with interface implementations
+
+## File Organization
+- **Transformers**: Located in `src/transformer/` directory
+- **Services**: Core business logic in `src/services/`
+- **Types**: Shared type definitions in `src/types/`
+- **Utils**: Helper functions in `src/utils/`
+
+## Naming Conventions
+- **Classes**: PascalCase (e.g., `ReasoningTransformer`, `OpenAITransformer`)
+- **Files**: kebab-case (e.g., `reasoning.transformer.ts`)
+- **Methods**: camelCase (e.g., `transformRequestOut`, `transformResponseIn`)
+- **Constants**: UPPER_SNAKE_CASE (e.g., `TransformerName`)
+
+## Architecture Patterns
+- **Transformer Pattern**: Implement `Transformer` interface with optional methods
+- **Service Layer**: Clear separation between config, provider, LLM, and transformer services
+- **Error Handling**: Comprehensive try-catch with fallback responses
+- **Logging**: Debug logs to temporary files for complex transformations

.serena/memories/project_overview.md

@@ -0,0 +1,24 @@
+# Project Overview
+
+## Purpose
+Universal LLM API transformation server (@musistudio/llms v1.0.26) - middleware to standardize requests/responses between different LLM providers (Anthropic, Gemini, Deepseek, OpenAI, etc.) using modular transformer system.
+
+## Tech Stack
+- **Language**: TypeScript with Node.js 18+ (ES2022 features)
+- **Build System**: esbuild with dual CJS/ESM output
+- **Server Framework**: Fastify with CORS support
+- **Development**: nodemon + tsx for hot-reloading
+- **Package Manager**: npm/pnpm supported
+
+## Architecture
+1. **Transformers**: Provider-specific request/response conversion classes
+2. **Unified Formats**: UnifiedChatRequest and UnifiedChatResponse types  
+3. **Streaming Support**: Real-time streaming response handling
+4. **Service Layer**: ConfigService, LLMService, ProviderService, TransformerService
+
+## Key Features
+- 16+ transformers for various LLM providers and utilities
+- Path aliases (`@` maps to `src` directory)
+- Dual format builds (CommonJS and ESM)
+- Environment configuration via .env or config.json
+- Complete GPT-5 support with reasoning token handling

.serena/memories/suggested_commands.md

@@ -0,0 +1,29 @@
+# Suggested Commands
+
+## Development Commands
+- **Install dependencies**: `pnpm install` or `npm install`
+- **Development mode**: `npm run dev` (Uses nodemon + tsx for hot-reloading)
+- **Build**: `npm run build` (Outputs to dist/cjs and dist/esm)
+- **Build with watch**: `npm run build:watch` (Continuous build during development)
+- **Lint**: `npm run lint` (Runs ESLint on src directory)
+- **Start server (CJS)**: `npm start` or `node dist/cjs/server.cjs`
+- **Start server (ESM)**: `npm run start:esm` or `node dist/esm/server.mjs`
+
+## Local Development with yalc (Recommended)
+```bash
+# Publish to yalc registry
+yalc publish
+
+# In consuming project (ccr-dev)
+yalc add @musistudio/llms
+npm run build
+
+# Push updates after changes
+yalc push  # Automatically updates all linked projects
+```
+
+## macOS System Commands
+- **File operations**: `ls`, `find`, `grep` (standard Unix commands)
+- **Process management**: `ps aux | grep <process>`, `kill <PID>`
+- **Directory navigation**: `cd`, `pwd`
+- **Package management**: `npm cache clean --force` (if needed)

.serena/memories/task_completion_procedures.md

@@ -0,0 +1,28 @@
+# Task Completion Procedures
+
+## Before Committing Code
+1. **Linting**: Run `npm run lint` to check TypeScript compliance
+2. **Build**: Run `npm run build` to ensure compilation succeeds
+3. **Testing**: Manual testing via development server (`npm run dev`)
+4. **Local Package Testing**: Use yalc workflow for integration testing
+
+## Local Development with yalc (Preferred)
+```bash
+# In llms-dev project
+yalc publish           # Publish changes to yalc registry
+yalc push             # Push updates to linked projects
+
+# In consuming project (ccr-dev)
+yalc add @musistudio/llms    # Link the package
+npm run build                # Rebuild consumer
+```
+
+## Deployment Commands
+- **Development**: `npm run dev` (nodemon + tsx hot-reloading)
+- **Production Build**: `npm run build` (creates dist/cjs and dist/esm)
+- **Start Production**: `npm start` (CJS) or `npm run start:esm` (ESM)
+
+## Documentation Standards
+- Update CLAUDE.md for major architectural changes
+- Follow conventional commit messages (feat:, fix:, docs:, etc.)
+- Document transformer additions in the main export index