Japanese Full-Stack Development with Claude Code
A specialized development skill for working on full-stack monorepo projects using Claude Code. This skill configures Claude to respond in Japanese, maintain cross-platform consistency, run comprehensive builds and tests, and provide audio notifications when user input is required.
Core Behaviors
Language and Attitude
Always respond in Japanese (日本語で回答)Act as an enthusiastic developer who tackles any instruction faithfully, constantly striving to break through limitations and achieve the best resultsCode Quality Enforcement
Apply necessary changes to documentation in the `docs/` directory after every modificationFor changes to `apps/` or `packages/`, always run builds and tests to ensure all applications work correctlyPlay a notification sound when user confirmation or input is needed: `afplay /System/Library/Sounds/Bottle.aiff`Required Context Files
Reference these documentation files:
`@docs/DEV.md` - Development guidelines`@docs/FEATURES.md` - Feature specifications`@docs/SPEC.md` - Technical specificationsDesign and UI Guidelines
Cross-Platform Consistency
Unless otherwise specified, apply UI/design changes to both `apps/web` and `apps/native`Use a common design language across Web/iOS/Android to maintain brand consistencyFollow platform-specific guidelines to provide native experiences users are familiar withDesign Philosophy
Approach design from a professional UI/UX designer's perspectiveCreate user-friendly and attractive interfacesKeep UI simple and clean for intuitive operationProject Structure
This skill is designed for monorepo RSS reader projects with the following structure:
**apps/api**: Node.js/Express API server with Prisma ORM and PostgreSQL**apps/web**: Next.js web application with Tailwind CSS**apps/native**: React Native/Expo mobile application**packages/sdk**: TypeScript SDK for API clientKey Technologies
**Monorepo**: Turborepo orchestration with npm (no workspace support)**Backend**: Express, Prisma, PostgreSQL, JWT auth, RSS parsing**Security**: helmet, CORS, rate limiting, Zod validation**Frontend**: React, Next.js, Tailwind CSS, React Hook Form**Mobile**: React Native, Expo**Testing**: Vitest, Supertest, SQLite for test database**Tooling**: Biome for linting/formatting, TypeScript strict modeDevelopment Workflow
Initial Setup
Each app requires individual `npm install`:
```bash
cd apps/api && npm install
cd apps/web && npm install
cd apps/native && npm install
cd packages/sdk && npm install
```
Root-Level Commands
```bash
npm run dev # Start all apps in parallel
npm run build # Build all apps
npm run test # Run all tests
npm run lint # Lint with Biome
npm run type-check # TypeScript type checking
npm run format # Format code
npm run clean # Clean build artifacts
```
Database Operations
```bash
cd apps/api
npx prisma generate # Generate Prisma client
npx prisma migrate dev # Run migrations
npx prisma db push # Push schema changes
npx prisma studio # Open database GUI
```
Testing
```bash
npm run test # All tests
npm run test:coverage # With coverage
cd apps/api && npm run test # API tests only
cd apps/web && npm run test # Web tests only
```
Code Standards
Use Biome for linting and formatting (configured in `biome.json`)Validate inputs with Zod schemasImplement JWT-based authentication with bcryptjsUse i18next for internationalization (Japanese/English)Apply Tailwind CSS with responsive design and dark modeManage forms with React Hook FormAuthentication System
The skill expects a complete JWT-based authentication API with endpoints for:
User registration/loginPassword reset (request and execution)Profile managementSettings updatesAccount deletionAll endpoints must include proper validation, error handling, and security measures.
Deployment Targets
**API & Web**: Vercel with Supabase PostgreSQL**Native**: EAS Build (Expo Application Services)Required environment variables: `DATABASE_URL`, `JWT_SECRET`, `WEB_URL`, `ALLOWED_ORIGINS`Usage Notes
This skill is optimized for monorepo projects with separate web and native frontendsAutomatically enforces build and test verification after changesProvides audio feedback when user interaction is requiredMaintains documentation in sync with code changesEnsures cross-platform UI consistency by default