# Sync Sphere > Orientações específicas para trabalhar no SyncSphere, app React/Vite + Node/Express para migrar playlists do Spotify para o YouTube Music. Use quando Codex precisar implementar, revisar, depurar, documentar ou planejar mudanças neste repositório, especialmente em tarefas envolvendo cookies de autenticação, MongoDB/Mongoose, filas Redis/BullMQ, progresso via Socket.io, integrações Spotify/YouTube Music, UI Tailwind, configuração MCP ou contexto reutilizável para agentes. Use when this capability is needed. - Skill: `tomevault-io/sync-sphere` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/sync-sphere` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sync-sphere/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/sync-sphere --- # Sync Sphere ## Visão Geral Use esta skill para trabalhar no repositório SyncSphere com o contexto do projeto já carregado. Prefira mudanças concisas e nativas do repositório, preserve as decisões de autenticação, fila e segurança, e atualize os documentos de contexto de IA quando surgir conhecimento recorrente. ## Início Rápido 1. Leia `AGENTS.md` na raiz do repositório. 2. Leia `docs/ai/project-context.md` para arquitetura, portas, convenções e mapa de arquivos. 3. Leia `docs/ai/agent-tooling.md` e `docs/ai/skill-policy.md` para comportamento de agentes, uso de Caveman/RTK e escopo de skills. 4. Leia `docs/ai/mcp-catalog.md` quando a tarefa precisar de MCPs ou ferramentas externas. 5. Leia `docs/ai/prompt-recipes.md` quando a tarefa for um fluxo recorrente. 6. Use os scripts do subprojeto relevante antes de inventar comandos. ## Regras do Projeto - Mantenha o back-end em ESM. - Mantenha JWT em cookies HttpOnly; não mova tokens de autenticação para storage do navegador. - Mantenha requisições Axios com credenciais via `withCredentials`. - Mantenha transferências longas fora do caminho HTTP request/response; use trabalhadores BullMQ. - Emita progresso de transferência via Socket.io quando o painel depender disso. - Valide entradas sensíveis com Zod e middleware de validação de rotas. - Criptografe credenciais de terceiros antes de persistir. - Não registre segredos, tokens, cookies, senhas ou dados reais de usuários. - Preserve a linguagem visual escura do React/Tailwind e as pastas de componentes existentes. - Mantenha respostas concisas e precisas; use o modo profissional curto inspirado no Caveman documentado em `docs/ai/agent-tooling.md`. - Se `rtk` estiver disponível, prefira-o para saídas shell ruidosas. Use comandos normais quando a saída completa for necessária ou quando `rtk` estiver ausente. ## Validação Back-end: ```bash cd backend npm run dev ``` Front-end: ```bash cd frontend npm run lint npm run build ``` Se uma mudança tocar integração, confira porta do back-end, `FRONTEND_URL`, `VITE_API_URL` do front-end, CORS, cookies, MongoDB e Redis em conjunto. ## Referências - `references/architecture.md`: arquitetura e convenções compactas. - `references/mcp-workflow.md`: seleção de MCPs e notas de segurança. --- > Source: [nicolassmotta/sync-sphere](https://github.com/nicolassmotta/sync-sphere) — distributed by [TomeVault](https://tomevault.io).