Troubleshooting
Esta pagina cobre os problemas mais comuns no uso do looply com Codex, Claude Code e os workflows publicados pelo software-delivery-suite.
O comando aparece no Claude, mas nao no Codex
Sintoma
Claude Codedetecta/looply:*Codexnao mostra o mesmo comando como slash command nativo
Causa
Hoje a experiencia dos hosts e diferente:
Claude Codeusa.claude/commandsCodexusaAGENTS.md,LOOPLY_COMMANDS.mde.agents/skills
O que fazer
- confirme que o projeto foi instalado para
codex - abra
AGENTS.md - abra
LOOPLY_COMMANDS.md - confira
.agents/skills - rode
looply doctor --host codex --scope project - no host, rode
/skillse procurelooply
O que esperar
No Codex, os comandos do looply continuam funcionando como aliases operacionais documentados, mas a camada oficial de extensao do host agora fica em .agents/skills.
workflow-status nao encontra a feature
Sintoma
- o host nao consegue retomar a feature
- o estado salvo parece ter sumido
O que verificar
.looply/custom/features/<feature-name>/workflow-status.md.looply/custom/session-links.json
O que fazer
- confirme o
feature-nameusado no workflow - se houver varias sessoes, informe
session-label - rode:
bash
looply sessions list- no host, tente:
text
/looply:workflow-status <feature-name>
/looply:resume <feature-name> <session-label>Existem varias sessoes abertas e nao sei qual retomar
Sintoma
- ha duas ou mais trilhas de trabalho para a mesma feature
- ficou ambiguo qual sessao deve continuar
O que fazer
- liste os vinculos:
bash
looply sessions list- ajuste o label se necessario:
bash
looply sessions link backend-afternoon pix-webhook-retry --workflow story-to-production- retome pelo label:
text
/looply:resume pix-webhook-retry backend-afternoondoctor reporta manifesto inconsistente
Sintoma
doctorinforma falta de entrypoint, hints ou manifesto- a instalacao parece parcial
O que verificar
.looply/state/install-manifest.json.looply/state/execution-hints.jsonAGENTS.mdouCLAUDE.md
O que fazer
- rode:
bash
looply doctor --host codex,claude --scope project- se a instalacao estiver incompleta:
bash
looply reinstall --host codex,claude --scope project --yes- se houver mudancas do pack:
bash
looply check-updates --host codex,claude --scope project
looply upgrade --host codex,claude --scope project --yesO host esta perguntando demais
Sintoma
- cada passo vira uma nova rodada de confirmacao
- o fluxo perde ritmo
Causa provavel
interaction-modeesta emguided- ou o projeto esta com ambiguidade real
O que fazer
Reinstale ou reinstale com:
bash
looply reinstall --host codex,claude --scope project --interaction-mode autonomous --yesTambem confira Comportamento dos Hosts.
O host esta assumindo demais e ignorando contexto importante
Sintoma
- respostas muito rápidas
- pouca validacao contra o codebase
- inferencias erradas no projeto existente
O que verificar
project-modeinteraction-mode- arquivos de contexto em
.looply/custom
O que fazer
- confirme que a instalacao esta em:
--project-mode existing-project
- se precisar reduzir autonomia:
bash
looply reinstall --host codex,claude --scope project --interaction-mode balanced --yes- valide o estado atual:
text
/looply:workflow-status <feature-name>install ou upgrade nao refletem mudancas novas
Sintoma
- artefatos parecem antigos
- comandos nao mudaram depois do update
O que fazer
- verifique mudancas:
bash
looply check-updates --host codex,claude --scope project- aplique:
bash
looply upgrade --host codex,claude --scope project --yes- consulte historico:
bash
looply history --host codex
looply history --host claudeA documentacao abre, mas parece antiga
O que fazer
bash
looply docs open --rebuildSe quiser validar a referencia:
bash
npm run docs:checkQuando escalar
Considere parar e revisar a instalacao quando:
doctorfalha repetidamente- o manifesto mostra host ausente ou entrypoint faltando
- o estado da feature nao bate com os artefatos existentes
- ha conflito entre sessoes paralelas e o
session-labelnao resolve