Solução de problemas
Use esta página quando algo impedir o seu uso. Ainda com dificuldades? Envie um e-mail para support@raaghu.ai.
Acesso e autorização
Solicitação de acesso pendente — "Request submitted. Retry authorization after admin approval"
Peça a um administrador da organização para aprová-lo em Azure DevOps → Organization settings → Extensions → Raaghu Spec Kit → Users → Pending requests e, em seguida, clique em Authorize Now novamente. Consulte Access Requests.
Acesso negado ou aprovado, mas ainda bloqueado — Entre em contato com um administrador da organização. Peça que ele verifique Users (e Pending requests) em Azure DevOps → Organization settings → Extensions → Raaghu Spec Kit, e use Assign se você ainda não tiver um seat.
Authorize falha / pop-up bloqueado — Permita pop-ups para o Azure DevOps, tente outro navegador e tente novamente.
"Setup Required" no on-premises — Conclua o Server Deployment Setup e, em seguida, autorize. Usuários na nuvem não devem ver isso.
Verificação de e-mail no on-premises — Informe seu e-mail corporativo e o código de 6 dígitos enviado para esse endereço. Consulte Instalação e abertura.
Seats e assinatura
"You need a seat" / não assinado / trial encerrado — O administrador da organização abre Organization Settings, inicia o trial gratuito, conclui o checkout ou ativa uma chave de licença e, em seguida, atribui seats em Users.
Start Free Trial / Choose Your Plan indisponível — O seletor de plano de trial gratuito só aparece para administradores da organização quando a organização é elegível para trial (geralmente uma org nova que ainda não usou trial ou teve licença anterior). Caso contrário, use Subscribe for $…/month ou License Keys.
Falha ao ativar chave de licença — Verifique erros de digitação (RAAGHU-XXXX-XXXX-XXXX), confirme que a chave ainda não foi ativada em outra conta e que não está expirada ou revogada. Consulte License Keys.
Se o hub mostrar "You need a seat to use Raaghu Spec Kit" (assinado, mas sem seat) ou que a organização não está assinada, clique em Open org settings (administradores) ou peça a um administrador para iniciar o trial, assinar, ativar uma chave e atribuir seats em Users:
Cancelar / desfazer — Em Subscription, use Undo cancellation ou Undo seat change enquanto a alteração ainda estiver pendente.
IA e chat
Settings ausente no menu — Somente administradores da organização e Project Administrators do projeto atual veem Settings. Peça a um deles para conectar a IA, ou a um admin da org para configurar conexões em AI Settings. Consulte Settings.
LLM não configurado — Um admin da org ou do projeto abre o menu do Raaghu Spec Kit → Settings → LLM Settings, liga Project LLM e adiciona uma chave de provedor de IA, ou um admin da org atribui conexões / habilita Use Raaghu AI em Organization settings → Extensions → Raaghu Spec Kit → AI Settings e completa créditos. Consulte Settings.
Saldo Raaghu AI zerado / precisa de mais créditos — O administrador da organização adiciona créditos em Organization Settings → Subscription → Add credits (ou AI Settings → Raaghu AI Credits). Usuários finais veem orientação em My AI usage.
Nomes de comando inesperados — Um admin verifica Settings → Commands Mapping (Default vs Spec Kit). Nomes amigáveis como "Create Specification" são o mesmo que /speckit.specify. Consulte Comandos do Raaghu Spec Kit.
Erros de provedor / limite de taxa — Aguarde e tente novamente; verifique a cota do provedor ou o saldo de créditos.
Intake ou chat parado no meio — Use Retry na mensagem interrompida. No Intake, o retry reutiliza os mesmos arquivos quando o conteúdo já foi extraído. Consulte Intake e Chat.
Análise de Intake incompleta em documento grande — Arquivos BRD/PRD muito grandes são analisados em chunks; se a execução atingir o limite de segurança, a análise indica que foi truncada. Divida o documento ou mova requisitos críticos para o início e execute de novo. Consulte Intake.
Menu de contexto ausente no Boards / painel do work item bloqueado — Confirme que a extensão Raaghu Spec Kit está instalada na organização, que você tem um seat atribuído e que um provedor de IA está conectado. Administradores da organização atribuem seats em Organization Settings. Consulte Menu de contexto.
Inicialização e Wiki
Inicialização falha — Confirme o acesso ao Wiki do projeto, permissão de escrita no wiki e acesso de rede ao GitHub.com. Consulte Initialize Raaghu Spec Kit.
Não encontra arquivos do Raaghu Spec Kit no Wiki — Procure a raiz Raaghu Spec Kit no Wiki (ou Speckit em projetos mais antigos). Se estiver ausente, inicialize novamente.
Hub splash fica reaparecendo após ociosidade — Atualize a página e abra o Raaghu Spec Kit de novo. Uma verificação inconclusiva de wiki ou auth após ociosidade não significa que você precise reinicializar.
"Unable to verify LLM settings…" — Atualize a página e tente o chat ou Settings novamente. Após uma sessão ociosa longa, a extensão pode precisar de um token novo.
Dashboard e Visuals
Dashboard vazio — Selecione a iteration correta. Conclua Sua primeira Feature para que existam artefatos.
Visuals Sync desabilitado — Confirme que constitution/spec/tasks existem, que a IA está configurada e que você tem permissão para criar work items. Sincronize um nível por vez. Consulte Visuals.
Auto-link skipped — Inicialize o Raaghu Spec Kit primeiro e conecte um provedor de IA ou ative o Raaghu AI em Settings. O Chart Sync auto-vincula Epics correspondentes quando o Raaghu Spec Kit está inicializado e a IA está configurada. Consulte Visuals.