> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchbord.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills para contribuidores

> Skills de agentes locais ao repositório para isolamento de worktree, disciplina de release e futuros fluxos de contribuidores.

# 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:

```bash theme={null}
pnpm worktree:new <branch-name>
```

### `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

* [Fluxo de contribuição](/pt-BR/contributing/workflow)
* [Limite de persistência](/pt-BR/contributing/persistence)
* [Worktrees](/pt-BR/contributing/worktrees)
* [Versionamento](/pt-BR/contributing/versioning)