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 três papéis:

Papel	Permissões
owner	Acesso total. Pode deletar o projeto, gerenciar faturamento, gerenciar membros e transferir propriedade. Um owner por projeto.
editor	Pode criar e editar especificações, executar sessões de planejamento e implementação, e gerenciar tickets. Não pode deletar o projeto ou transferir propriedade.
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. Owners gerenciam membros, chaves de API, padrões de qualidade e faturamento.

Editor — Desenvolvedores que usam o SpecForge diariamente. Criam specs, planejam com agentes, implementam e revisam. Este é o papel padrão para os colaboradores que você convida.

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 (editor)
specforge members add alice@example.com
 
# Convidar com papel específico (editor ou viewer)
specforge members add bob@example.com --role viewer

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 executando specforge invitations na CLI.

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 editor

⚠️ Apenas owners 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.

Operações de Compartilhamento (CLI)

A gestão de equipe roda pelos comandos specforge members e specforge invitations da CLI acima. Elas não são ferramentas MCP chamáveis por agente — um agente não tem nenhuma ferramenta de gestão de equipe na sua superfície de 17 ferramentas. Por baixo, a CLI despacha para as operações de compartilhamento da plataforma:

Operação	Comando CLI	Descrição
`invite_to_project`	`specforge members add`	Enviar um convite para um novo membro da equipe
`list_project_members`	`specforge members list`	Listar todos os membros atuais e seus papéis
`update_member_role`	`specforge members role`	Alterar o papel de um membro
`remove_project_member`	`specforge members remove`	Remover um membro do projeto
`list_invitations`	`specforge invitations`	Ver convites pendentes
`accept_project_invitation`	`specforge invitations accept`	Aceitar um convite recebido
`decline_project_invitation`	`specforge invitations decline`	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 + editors. Todos criam e implementam specs. Uma pessoa (owner) gerencia padrões de qualidade e chaves de API. Mantenha plano.

Equipe crescendo (5-15): Owner + editors + viewers. O owner lida com mudanças de configuração e membros. 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 editor em um projeto e viewer 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 owners podem ajustar