Menu
Sync claude-design-docs with implemented UI after paradigm changes. Use when finishing UI work, when asked to "sync UI product docs", or when prototype vs code diverged.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when debugging local failures, failed to fetch, API errors, Docker stack issues. Always apply for bug reports and runtime errors in Career Forge.
Use LangSmith CLI to inspect LLM traces/runs for Career Forge debugging. Use when debugging diagnosis interview, forge SSE, mentor flows, or any upstream LLM execution.
Mandatory pre-merge triple gate for Career Forge — code evaluator, Playwright MCP, agent verify. Use before every merge.
Gate C — run make agent-verify for API + Postgres proof before merge. Extend scripts/agent-verify.sh for new behavior.
| name | ui-product-sync |
| description | Sync claude-design-docs with implemented UI after paradigm changes. Use when finishing UI work, when asked to "sync UI product docs", or when prototype vs code diverged. |
Keep PRODUCT-SOURCE-OF-TRUTH.md aligned with apps/frontend/ and the Claude Design prototype.
Rule: .cursor/rules/ui-product-sync.mdc
apps/frontend/, claude-design-docs/, Tailwind, or global CSSRead:
prototype/Career Forge.html (tokens/components — flow may lag)git diff origin/main...HEAD -- apps/frontend claude-design-docs| View | Question |
|---|---|
| Prototype | What was the intended layout, copy, wow moment? |
| Code | What shipped? |
| CHECKPOINT | Does it still serve P0 demo? |
Apply hierarchy from PRODUCT-SOURCE-OF-TRUTH § Source-of-truth hierarchy.
| If… | Then update… |
|---|---|
| Route/flow changed | UX-FLOW + SCREEN-INTENT + SCREEN-INTENT-MAP |
| Colors/type/spacing changed | design-tokens.md + UI-PRINCIPLES if pattern new |
| Code intentionally differs from prototype | PRODUCT-SOURCE-OF-TRUTH → Implementation notes row |
| New shared component | UI-PRINCIPLES component table + Implementation notes |
| Product scope shifted | docs/CHECKPOINT.md (separate issue if major) |
UI product sync complete
- Docs updated: <list>
- Paradigm changes: <summary or "none — cosmetic only">
- Open drift: <items needing Linear issue, or "none">