thanhtung2693/specgate

Usando SpecGate

Instalação apenas via bootstrap

Use quando specgate-project-setup não estiver disponível após uma instalação skills.sh apenas para root. Verifique command -v specgate (PowerShell: Get-Command specgate). Se ausente, explique que skills.sh fornece apenas instruções. No macOS, Linux ou WSL2, mostre isto e aguarde aprovação explícita:

curl -fsSL https://raw.githubusercontent.com/thanhtung2693/specgate/main/scripts/install-cli.sh | sh

Windows nativo: use https://github.com/thanhtung2693/specgate/releases/latest; nunca invente PowerShell. Registre specgate --version depois.

Confie apenas em um lock com fonte thanhtung2693/specgate e caminho plugins/skills/specgate/SKILL.md, no projeto skills-lock.json ou global ~/.agents/.skill-lock.json. Mostre seu comando correspondente e aguarde aprovação:

npx skills remove specgate -y
npx skills remove specgate -g -y

Nunca edite ou exclua arquivos skills.sh ou locks diretamente. Pergunte pelo IDE e escopo, depois pré-visualize, instale e verifique:

specgate plugins install --agent <codex|claude|cursor> [--project-local] --dry-run --no-input
specgate plugins install --agent <codex|claude|cursor> [--project-local] --no-input
specgate plugins doctor --agent <codex|claude|cursor> [--project-local] --json

Em caso de propriedade nativa de plugin, pare. Nunca desinstale ou desabilite sem aprovação explícita separada.

Exija uma reinicialização do IDE e pare antes da inicialização. Continue através de specgate-project-setup após isso.

Conclusão: um plugin gerenciado pela CLI, doctor saudável, reinicialização explícita.

Rota de uma fase

Para trabalho de ciclo de vida, escolha exatamente uma fase antes de agir:

• specgate-project-setup — inicializar, vincular, instalar, atualizar ou diagnosticar o SpecGate para um repositório.
• specgate-work-preparation — transformar uma solicitação ou especificação de origem em trabalho SpecGate aprovado.
• specgate-work-delivery — implementar, retomar, revisar ou refazer trabalho SpecGate aprovado.

Para uma dúvida apenas de leitura ou pergunta sobre status do ciclo de vida com uma referência de trabalho, comece com a leitura autoritativa:

specgate change status "$WORK_REF" --json

Para outras dúvidas conceituais ou de solução de problemas, use a menor leitura CLI relevante. Não force uma fase nem mude registros.

Antes de uma escrita ou handoff dependente de modo, execute specgate doctor --json. Leia data.mode; nunca infira o modo a partir de Docker, URLs ou disponibilidade de navegador. Relate um resultado de doctor malsucedido em vez de adivinhar.

Contrato operacional

• A CLI specgate é a única superfície de leitura e escrita do estado do produto. Nunca inspecione ou edite SQLite, Postgres, armazenamento de objetos, volumes de implantação ou .specgate/local do SpecGate diretamente. Leituras de fonte do repositório permanecem permitidas.
• Rascunhos, explicações, resumos e leituras de repositório permanecem efêmeros até que um comando CLI explícito os persista.
• O framework de autoria original possui os documentos fonte duráveis: seus caminhos, nomes, ciclo de vida e política Git. O SpecGate os captura no local. Ele não move, copia, renomeia, exclui, commita ou altera regras de ignore para eles.
• Uma passagem de prontidão não é aprovação humana. Aprovação, aceitação e alterações solicitadas permanecem decisões humanas. Execute um comando de decisão somente após o humano escolher explicitamente e autorizar essa decisão exata; nunca infira uma.
• Um Context Pack aprovado tem precedência sobre histórico de chat, prosa de tracker e documentação de repositório desatualizada. Nunca expanda silenciosamente seu escopo.
• Siga identificadores e versões exatas. artifact coverage <artifact-id> é evidência de versão exata; nunca colapse versões por nome de funcionalidade.
• Siga change status.data.next_actor e next_command. Quando o próximo ator for humano, pare e entregue esse comando literalmente.
• O modo Local não tem URL de interface e nunca chama specgate open. No modo Completo, use apenas a URL retornada por specgate open ... --print --json; nunca construa uma.

Para sintaxe de comandos, execute specgate <comando> --help em vez de reconstruir flags de memória.