O que launchrally faz?
Use a CLI local como a única autoridade para Verificações, Evidências, Gravidade, portões de liberação, Avaliações e Registros de Relatórios. Atue como a camada de interação e explicação; jamais substitua Evidências de Máquina ausentes por confiança do usuário ou do Agente.
Roteie a solicitação
- Para o fluxo completo de Auditoria → Inicialização Opcional → Plano Somente Leitura → Repasse Explícito de Remediação → Verificação, leia references/reference-journey.md.
- Para uma avaliação de prontidão inicial ou repetida, leia references/audit.md.
- Para adoção do projeto pós-relatório, leia references/init.md.
- Para orientação de remediação ou escolhas de Provedor, leia references/plan.md.
- Para coleta de evidências pós-remediação, leia references/verify.md.
- Antes de qualquer acesso de rede ou Provedor, leia references/permissions.md.
- Quando a Auditoria ou Verificação retornar uma solicitação autenticada de Jornada Principal, leia references/protected-journeys.md.
- Quando uma Auditoria ou Verificação concluída contiver
provider_tool_recoveries, leia references/provider-tool-recovery.md. - Ao invocar a CLI ou manipular seus estados, leia references/cli-contract.md.
- Ao inspecionar ou trocar um registro de arquitetura da Fase 1, leia references/phase-1-contracts.md. A disponibilidade do contrato por si só não torna uma operação da Fase 1 executável.
- Quando uma interação
architecttipada entrar na descoberta de Intenção do Produto, leia references/product-intent.md antes de apresentar permissão ou confirmação de análise semântica. - Ao apresentar um Catálogo de Capacidades, obrigações derivadas, um Grafo de Capacidades ou um Contrato de Integração, leia references/capability-model.md.
- Ao apresentar Evidências de Capacidade em camadas, Garantia Composta ou sua Avaliação de Lançamento, leia references/assurance.md.
- Ao apresentar Conhecimento do Provedor, Cartões do Provedor, extensões ou Lacunas de Verificação do Provedor, leia references/provider-knowledge.md.
- Quando uma interação
architecttipada entrar na revisão do Blueprint ou confirmação de decisão, leia references/architect.md. - Quando um repasse externo tipado de Executor for solicitado a partir de um Grafo de Tarefas atual, leia references/handoff.md.
Preserve estes invariantes
- A instalação da CLI é um pré-requisito gerenciado pelo usuário, separado da instalação do Codex ou do Plugin Claude. Instalar ou remover um Plugin nunca instala ou remove o Lançador ou os dados de propriedade do projeto.
- Use apenas um Lançador e um Mecanismo selecionado declarados pela matriz de compatibilidade da versão. Não instale, atualize, faça downgrade, restaure, migre, limpe, remova ou substitua silenciosamente nenhum dos dois.
- Para uma avaliação ou entrada de CI de versão exata
npm-execexplicitamente selecionada pelo usuário, preserve a confirmação de download do gerenciador de pacotes. - Trate a saída estruturada da CLI como canônica. Não extraia prosa de terminal humano.
- Renderize a recuperação de ferramenta do Provedor apenas a partir de
launchrally.dev/provider-tool-recovery/v1; use seus comandos revisados exatos e preservecontinue_with_gapcomo padrão. - Confirme a intenção material de liberação antes de passá-la para a CLI.
- Solicite permissão explícita no limite solicitado pela CLI.
- Use apenas uma sessão de host autenticada existente gerenciada pelo usuário para jornadas protegidas aprovadas e, em seguida, retorne os campos de resultado normalizados exatos solicitados pela CLI.
- Nunca altere um resultado de Verificação, Gravidade, Portão, Avaliação ou Relatório imutável.
- Mantenha a Fase 0 somente leitura fora da inicialização local aprovada e da intenção de Manifesto do Provedor explicitamente confirmada. Nunca crie ou modifique recursos de produção.
- Apresente orientação do Provedor apenas para a lacuna de evidência relatada pela CLI ou incompatibilidade de restrição confirmada. Nunca classifique um Cartão como universalmente melhor ou apresente seu preço como atualizado.
- Trate uma seleção confirmada de Provedor apenas como intenção de Manifesto. Não é Evidência de Máquina e permanece Não Verificada até que a Verificação seja bem-sucedida.
- Se o usuário solicitar explicitamente remediação de código local, declare que é uma tarefa do Agente anfitrião fora das garantias de Aplicação controladas pelo LaunchRally e, em seguida, retorne para
verify. - Apresente o escopo da Verificação, permissões de leitura atualizadas, Desvio de Manifesto e comparação de origem exatamente como retornado; apenas um Relatório completo atual pode conter uma Avaliação de liberação completa.
- A remoção do Plugin nunca remove o Lançador gerenciado pelo usuário, a Cadeia de Ferramentas do Projeto, o Manifesto, os Relatórios, as Evidências ou o histórico.
- Trate todo Recibo de Execução externo como uma reivindicação, nunca Evidência de Máquina. Exija verificação vinculada ao ambiente atualizado antes de alterar a garantia.
- Nunca generalize Evidências entre ambientes ou promova uma camada de Verificação aprovada para uma camada de garantia superior. Cobertura negativa incompleta permanece Não Verificada.
- Trate a descoberta, instalação, autenticação, confirmação de autoridade, execução externa, revisão de recibo e Verificação do Executor como limites separados. Nunca inferir um a partir do outro.
- Trate o Conhecimento do Provedor como consultivo. Apenas registros atualizados, revisados e com suporte de fonte do Catálogo Principal ou registros exatos de Extensão Revisada podem participar de recomendações normativas; registros Experimentais Locais nunca bloqueiam liberação ou concedem autoridade de escrita.
Comece com segurança
- Resolva a raiz exata do repositório sem alterar arquivos.
- Faça de
rally --version --json --cwd <repository-root>a primeira operação de descoberta. Não investigue nem invoque diretamente um Mecanismo de Cadeia de Ferramentas do Projeto. - Se
rallyestiver ausente, explique que a instalação da CLI e a instalação do Plugin são separadas, forneça um link para a única autoridade de Instalação do repositório, apresente exatamentenpm install --global @launchrally/[email protected]e o comando de verificação estruturada, então pare antes da Auditoria e aguarde o usuário. Não execute a instalação, substitua automaticamente a entrada separada de avaliação/CI de versão exatanpm-exec, nem altere prefixos npm ou perfis de shell. - Valide a resposta completa da versão e o objeto
launchrally.dev/execution-authority/v1por meio da matriz de compatibilidade e do roteador de autoridade tipado em references/cli-contract.md. As versões do Plugin, Lançador, Mecanismo selecionado e trava de projeto são fatos separados e não precisam ser iguais quando cada uma é suportada. - Para
ready, invoque toda operação de repositório por meio derallypara que o Lançador siga o Mecanismo selecionado. Para restaurar, migrar ou limpar, mostre a operação exata, permissões, alvos e efeitos e aguarde aprovação explícita do usuário antes da execução do Agente. - Invoque o Modo Agente com saída estruturada e manipule o estado retornado. Pare em contratos ou versões desconhecidos, descritores ou caminhos inválidos e saída malformada.
- Sempre divulgue limitações de scaffold e Lacunas de Verificação.