easy-resume

name	easy-resume
description	Use when working inside the easy_resume repository: planning structure, refactoring, adding resume editor features, touching PDF export, AI review, Zustand state, templates, or project conventions.

easy_resume Repository Skill

This skill gives Codex repository-specific instructions for easy_resume, a Next.js resume editor.

First Step

Read PROJECT_STRUCTURE.md and AGENTS.md from the repository root before making architectural or feature changes.

Project Shape

• Next.js App Router, React, TypeScript strict.
• Main product: online resume editor with canvas editing, templates/themes, PDF export, AI review, local persistence.
• Zustand stores currently live in src/lib/store.
• Resume editor UI currently lives across src/app/dashboard, src/components, and src/lib.
• Target architecture is feature-first under src/features/resume-editor.

Default Implementation Rules

• Keep src/app/**/page.tsx thin. Move editor logic into feature components/hooks/services.
• Put resume-editor-only code under src/features/resume-editor.
• Put cross-feature UI under src/components/ui.
• Put server helpers under src/lib/server.
• Put IO code such as API clients, localStorage, and downloads in services.
• Put DOM/event/state orchestration in hooks.
• Keep Zustand stores synchronous and free of DOM, fetch, and localStorage.
• Prefer pure utility functions for layout, history, and formatting logic.

Naming Rules

• Directories: kebab-case.
• Components: PascalCase.
• Hooks: useXxx.ts.
• Stores: xxxStore.ts.
• Types: PascalCase.
• Do not create new code using existing misspellings like resume_sytle, SystemDilaog, or useMouseOpeartion.

High-Risk Areas

• Undo/redo: avoid mutating arrays in place and use deep-copy snapshots.
• Resume templates: avoid import-time random UUIDs for stable templates.
• PDF export: ensure Puppeteer browser closes in finally; avoid debug console logs.
• AI review: use structured request data and appropriate status codes such as 429 for rate limits.
• Rich text HTML: treat external/imported HTML as untrusted.
• Persisted resume data: never store DOM refs.

Validation

• Run pnpm check for most code changes.
• Run pnpm build for route, server, dependency, or broad TypeScript changes.
• If checks are not run, clearly say so in the final response.