| name | muhfweeceevee-development |
| description | Use when developing, debugging, or extending MuhFweeCeeVee (MyFreeCeeVee) —
the local-first CV composer at C:\git-public\MuhFweeCeeVee-Professional-CV-Template-Generator.
Covers monorepo layout, Next.js composer UI, design system and UX patterns (theme tokens,
form grid, controls), YAML CV storage, template rendering, PDF export, OpenRouter AI,
company metadata, Photo Booth, and WSL dev workflow.
Triggers: MuhFweeCeeVee, MFCV, CV template generator, composer, Print Room, editor form,
UI component, design tokens, dark mode, cv_en_john_doe, harvard-v1, port 3005.
|
MuhFweeCeeVee — Development Skill
Local-first CV composer: edit YAML CVs, preview HTML/PDF via academic templates, run
OpenRouter-backed analysis, and manage bilingual variants. Read only the reference
files you need — do not load all references up front.
Session bootstrap (always)
- Read
AGENTS.md for operating contract, privacy, and validation.
- Start dev server before app code changes (see
references/dev-workflow.md).
- Default web URL: http://127.0.0.1:3005 (webpack + WSL file polling).
cd /mnt/c/git-public/MuhFweeCeeVee-Professional-CV-Template-Generator
npm run dev
npm run check
What to load next (routing table)
| Your task | Read this reference |
|---|
| First time on repo / “how does this work?” | references/architecture-overview.md |
| UI panels, editor form, autosave, localStorage | references/web-app-composer.md |
| Theme, design tokens, controls, new UI features | references/ui-ux-design-system.md |
API routes, cvStore, companies, photos, auth | references/server-api-data.md |
| Templates, mappings, HTML render, PDF/Playwright | references/rendering-pipeline.md |
| CV YAML shape, variant IDs, sync, validation | references/cv-yaml-variants.md |
| OpenRouter settings, field/company/photo AI | references/openrouter-ai.md |
| Ports, HMR, restart rules, pytest, release | references/dev-workflow.md |
packages/schemas, parser, MCP, retired keywords | references/packages-and-services.md |
| Git safety, personal CVs, secrets | references/privacy-and-safety.md |
Canonical docs outside this skill: docs/API.md,
docs/CV_YAML_STANDARD.md,
PROJECT_CONVENTIONS.md,
DEV_SERVER_WORKFLOW.md.
Mental model (30 seconds)
Browser (ComposerClient)
-> useComposerController (~2.6k lines, client state + fetch /api/*)
-> panels: Print Room | Photo Booth | Editor | Templates | Settings
Next.js Route Handlers (/api/*, nodejs runtime)
-> cvStore / templateStore / companyMetadataStore / photoGalleryStore
-> repoPath() resolves monorepo root (data/, templates/)
Render path
CV YAML + template.yaml + data/template_mappings/<templateId>.yaml
-> bindSlots() -> template-specific render*() -> HTML
-> Playwright PDF on /api/export/pdf
Non-negotiables
- Canonical data:
data/cvs/*.yaml is source of truth; never hand-edit generated PDFs.
- Explicit mapping: renderer maps CV fields via mapping YAML, not implicit key guessing.
- Privacy: only fictional sample CVs belong in git (
cv_en_john_doe.yaml). See
references/privacy-and-safety.md.
- API auth: when
MFCV_API_TOKEN is set, mutations need Bearer or x-mfcv-api-token.
- After code changes: restart dev server per
DEV_SERVER_WORKFLOW.md.
- Sync
docs/API.md when adding or changing route handlers.
Common edit map
| Change | Start here |
|---|
| New form field / editor UX | useEditorFormRenderer.tsx, editor-compact-field-row.tsx, editor-compact-form-layout.ts — see references/ui-ux-design-system.md |
| Panel layout / nav | ComposerShell.tsx, ComposerNav.tsx, *Panel.tsx — reuse nav/button tokens from UI reference |
| Client orchestration | useComposerController.ts (large — search before editing) |
| New API endpoint | apps/web/src/app/api/**/route.ts + docs/API.md |
| CV read/write/history | apps/web/src/lib/server/cvStore.ts |
| Variant/sync IDs | apps/web/src/lib/server/cvVariants.ts |
| New template renderer | apps/web/src/lib/server/render/<template-id>.ts + register in renderCvTemplate.ts |
| Template labels/layout | templates/<id>/template.yaml, layout.yaml |
| Field visibility in PDF | apps/web/src/lib/cvTemplateVisibility.ts |
| JSON schema validation | packages/schemas/src/cvSchema.ts |
| OpenRouter prompts | apps/web/src/lib/server/openRouter*.ts, lib/field-ai-rewrite.ts |
Skill maintenance
When you discover durable project knowledge, add a focused skill under skills/<category>/
per SKILLS_GUIDE.md. Update this skill’s references if the
architecture shifts (new package, retired subsystem, port change).
