Skip to main content

​
Skills para contribuidores

Este repositório possui skills locais para manter o trabalho conduzido por agentes alinhado aos mesmos padrões esperados de contribuidores humanos. O objetivo não é automação pela automação. O objetivo é preservar:
  • conjuntos de mudanças estreitos e revisáveis
  • documentação fiel à realidade
  • semver deliberado
  • isolamento limpo de worktree

​
Skills locais atuais do repositório

​
gb-worktree-feature-flow

Use esta skill quando uma mudança deve ir para sua própria branch e checkout. Ela padroniza:
  • um worktree por concern coerente
  • uma branch por worktree
  • fatias revisáveis em vez de edições não relacionadas empilhadas
Entrypoint padrão:

​
gb-oss-release-discipline

Use esta skill quando uma mudança envolve:
  • versionamento em package.json
  • tags de release
  • documentação para contribuidores
  • higiene do repositório voltada ao público
Ela reforça a separação entre:
  • semver como identidade de release
  • buildVersion como identidade de deployment em runtime
Ela também padroniza a disciplina de CI pós-push:
  • verificar execuções recentes do GitHub Actions com gh
  • relatar jobs ou steps que falharam em vez de apenas dizer que o CI falhou
  • propor a próxima correção quando um workflow estiver vermelho

​
next-forge

Use esta skill quando uma tarefa envolve estrutura do monorepo, responsabilidade de packages compartilhados, trabalho no design-system, Storybook, feature flags ou convenções de deployment herdadas do template. Neste repositório, ela deve ser lida como uma referência estrutural, não como um comando para ativar toda superfície de scaffold dormente. O limite de workspace ativo em README.md continua sendo a fonte da verdade. Ela padroniza:
  • apps e packages compartilhados autocontidos
  • Storybook como a superfície de review para UI compartilhada
  • packages/design-system como o único alvo suportado do CLI do shadcn neste repositório
  • pnpm dlx shadcn@latest info -c packages/design-system --json antes de trabalho em UI compartilhada
  • radix-nova mais tokens semânticos olive como a baseline atual de UI compartilhada
  • Mintlify como superfície de documentação de primeira classe
  • mudanças estruturais com consciência de boundaries
  • comandos de manutenção como pnpm boundaries, pnpm bump-deps e pnpm bump-ui
  • manutenção de dependências como uma fatia dedicada de nível raiz, em vez de atualizações espalhadas package a package
  • Biome via pnpm lint e pnpm format como o caminho de formatação/lint do repositório
  • pnpm build:tracked <target> e pnpm typecheck:tracked <target> para tarefas longas de Storybook, Next.js e validação
  • @repo/database como o único limite de data-plane suportado
  • @repo/auth como o único limite de auth/sessão do Supabase suportado
  • nenhum acesso a dados via @supabase/supabase-js direto em nível de app sem uma mudança explícita de boundary

​
gb-linear-execution

Use esta skill quando uma tarefa envolve organização de roadmap, planejamento de projetos, divisão de issues, milestones ou sincronização com o Linear. Ela padroniza:
  • planning/linear/* como o pacote canônico de planejamento
  • iniciativas, projetos, milestones e issues em vez de documentos de roadmap paralelos
  • pnpm linear:sync para pré-visualização e pnpm linear:sync:apply para importação
  • o formato atual do workspace do Linear ancorado no time GB
  • criação ou atualização de uma issue no Linear quando o trabalho de implementação revelar um bloqueador substancial, uma lacuna de paridade ou uma lacuna arquitetural

​
Adequação ao repositório

Essas skills são intencionalmente moldadas em torno da mesma postura de repositório usada no gb-travio-webhooks, preservando a disciplina estrutural herdada do next-forge:
  • documentação direta
  • PRs pequenos
  • deployment conduzido pelo repositório
  • comportamento operacional explícito
  • limites claros entre apps/packages
  • documentação e Storybook como superfícies de primeira classe

​
Adicionando mais skills

Ao adicionar uma nova skill para este repositório:
  1. mantenha o escopo estreito
  2. escreva a skill em torno de um fluxo de trabalho repetido, não de uma tarefa pontual
  3. aponte para a documentação existente em vez de duplicá-la
  4. adicione metadados para que sessões futuras consigam descobri-la rapidamente

​
Localizações atuais

  • .agents/skills/shadcn
  • skills/gb-worktree-feature-flow
  • skills/gb-oss-release-discipline
  • skills/gb-linear-execution
  • skills/next-forge

​
Leia a seguir