Gestão de Equipe

Convide colaboradores, atribua papéis e gerencie membros do projeto.

Projetos SpecForge suportam múltiplos membros de equipe com acesso baseado em papéis. Gerencie sua equipe pelo painel ou pela CLI.

Papéis

Todo membro do projeto tem um de quatro papéis:

Papel	Permissões
owner	Acesso total. Pode deletar o projeto, gerenciar faturamento e transferir propriedade. Um owner por projeto.
admin	Pode gerenciar membros, chaves de API, padrões de qualidade e todas as especificações. Não pode deletar o projeto ou transferir propriedade.
member	Pode criar e editar especificações, executar sessões de planejamento e implementação, e gerenciar tickets. Não pode gerenciar outros membros ou configurações do projeto.
viewer	Acesso somente leitura a todos os dados do projeto. Não pode criar ou modificar nada.

ℹ️ O usuário que cria um projeto recebe automaticamente o papel de owner.

Escolhendo o Papel Certo

Owner — A pessoa responsável pelo projeto. Geralmente o fundador, tech lead ou gerente de projeto que decide adoção e configuração. Um por projeto por design.

Admin — Líderes de equipe que precisam gerenciar padrões de qualidade, chaves de API e membros. Eles podem configurar quão rigorosos os gates são, convidar novos membros e ajustar configurações do projeto. Dê admin a pessoas que precisam mudar como a equipe trabalha, não apenas o que a equipe constrói.

Member — Desenvolvedores que usam o SpecForge diariamente. Criam specs, planejam com agentes, implementam e revisam. Este é o papel padrão para a maioria dos membros da equipe.

Viewer — Stakeholders que precisam de visibilidade sem acesso de edição. Gerentes de produto revisando progresso, executivos monitorando painéis, clientes acompanhando entregas. Veem tudo mas não podem mudar nada.

Convidando Membros da Equipe

Pelo Painel

Abra seu projeto e vá em Settings > Team
Clique em Invite Member
Insira o endereço de email
Selecione um papel
Clique em Send Invitation

O usuário convidado recebe um email com um link para aceitar. Eles devem ter uma conta SpecForge (ou criar uma) para entrar.

Pela CLI


# Convidar com papel padrão (member)
specforge members add alice@example.com
 
# Convidar com papel específico
specforge members add bob@example.com --role admin

Gerenciando Convites

Usuários convidados podem aceitar ou recusar pelo painel ou pela CLI.


# Aceitar um convite
specforge invitations accept <invitation-id>
 
# Recusar um convite
specforge invitations decline <invitation-id>

✅ Encontre IDs de convites pendentes verificando suas notificações no painel do SpecForge, ou através da ferramenta MCP list com type: invitations.

Alterando Papéis

Pelo Painel

Vá em Settings > Team
Encontre o membro na lista
Selecione um novo papel no dropdown
Confirme a mudança

Pela CLI


specforge members role alice@example.com admin

⚠️ Apenas owners e admins podem alterar papéis de membros. Você não pode promover alguém para owner — transferência de propriedade é feita separadamente pelo painel.

Removendo Membros

Pelo Painel

Vá em Settings > Team
Clique em Remove ao lado do membro
Confirme a remoção

Pela CLI


specforge members remove alice@example.com

Membros removidos perdem acesso imediatamente. Suas contribuições anteriores (sessões, commits, reviews) permanecem no histórico do projeto.

Ferramentas MCP para Gestão de Equipe

As seguintes ferramentas MCP estão disponíveis para gerenciar equipes programaticamente:

Ferramenta	Descrição
`invite_to_project`	Enviar um convite para um novo membro da equipe
`list_project_members`	Listar todos os membros atuais e seus papéis
`update_member_role`	Alterar o papel de um membro
`remove_project_member`	Remover um membro do projeto
`list_invitations`	Ver convites pendentes
`accept_project_invitation`	Aceitar um convite recebido
`decline_project_invitation`	Recusar um convite recebido

Padrões Práticos

Desenvolvedor solo começando: Você é o owner. Sem gestão de equipe necessária. Crie seu projeto, gere sua chave de API e vá.

Equipe pequena (2-5): Owner + members. Todos criam e implementam specs. Uma pessoa (owner) gerencia padrões de qualidade e chaves de API. Mantenha plano.

Equipe crescendo (5-15): Owner + 1-2 admins + members + viewers. Admins lidam com mudanças de configuração do dia a dia. Viewers para gerentes de produto e stakeholders que monitoram progresso. Use chaves de API separadas por desenvolvedor.

Equipe grande com múltiplos projetos: Cada projeto tem seu próprio owner e estrutura de papéis. Um desenvolvedor pode ser admin em um projeto e member em outro. Chaves de API são por projeto, então o acesso é naturalmente escopado.

Veja Também

Chaves de API — Gere chaves para membros da equipe
Padrões de Qualidade — Configurações que admins podem ajustar