Skip to content

Viniciustda/OiTenta / .agents/skills/config-package-shared

config-package-shared

Verified

Reconstrói o pacote compartilhado base da aplicação, concentrando contratos reutilizáveis, classes base, erros de domínio, casos de uso e validações consumidas pelo backend, frontend e módulos de negócio.

Config Package Shared

Usar o script scripts/rebuild-shared.js para reconstruir packages/shared ou materializar uma variante derivada, como packages/shared-v2, de forma deterministica.

Fluxo

  1. Executar a partir da raiz do monorepo:
node .agents/skills/config-package-shared/scripts/rebuild-shared.js
node .agents/skills/config-package-shared/scripts/rebuild-shared.js --package-name shared-v2
  1. O script deve:
    • recriar packages/<package-name> a partir de assets/shared-template/;
    • materializar primeiro o pacote com @temp/shared;
    • detectar dinamicamente o scope real a partir dos package.json da raiz, apps/*, modules/* e packages/*, sem fixar namespace de cliente;
    • renomear packages/<package-name>/package.json para @<scope>/<package-name>;
    • quando package-name for shared, adicionar ou normalizar "@<scope>/shared": "*" nos package.json de apps/* e modules/* que usam a base compartilhada;
    • quando package-name for diferente de shared, nao sobrescrever automaticamente dependencias internas existentes;
    • executar npm i;
    • validar com npx turbo run build --filter=@<scope>/<package-name>;
    • reportar o scope detectado, o pacote recriado e os workspaces atualizados.

Base canonica

Toda a base deterministica fica dentro desta skill:

  • assets/shared-template/package.json
  • assets/shared-template/tsconfig.json
  • assets/shared-template/jest.config.ts
  • assets/shared-template/src/**
  • assets/shared-template/test/**

Nao depender de templates, scripts ou pastas externas para reconstruir o pacote.

Restricoes

  • Nao copiar dist, coverage, .turbo ou node_modules.
  • Nao embutir @poupig ou qualquer outro scope fixo nos arquivos-base da skill.
  • Nao pular a deteccao dinamica de scope.
  • Nao usar file: ou links locais ao normalizar a dependencia do pacote shared.
  • Nao recriar os arquivos do pacote em tempo de execucao por geracao ad hoc; sempre copiar a base fiel de assets/shared-template/.
  • Nao sobrescrever um pacote alternativo ja existente sem intencao explicita; para nomes diferentes de shared, falhar se packages/<package-name> ja existir.

Manutencao

Quando packages/shared mudar e a skill precisar acompanhar a nova base canonica, atualizar primeiro os arquivos de assets/shared-template/, mantendo @temp/shared no package.json do template.

brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 319kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 196kUpdated Claude CodeCodexVerifiedInstall