Pular para o conteúdo principal

Todo agente de código lê.

O SpecWeave não precisa de serviço nem de conta. Os agentes de código leem os arquivos do seu repositório, então Claude Code, Codex, Grok e os demais retomam a mesma spec e o mesmo ledger.

Ilustração · todos os agentes leem os mesmos arquivos no seu repositório

Agentes de código

O CLI é o mesmo em todas as ferramentas, então uma ferramenta sem skills ainda executa o loop. Alternar entre elas, ou entre duas assinaturas da mesma, é um handoff e uma retomada. Mais em Codex, Grok e outros.

  • Claude Code, incluindo threads de Projects

    Lê
    CLAUDE.md, que importa o AGENTS.md
    Skills
    .claude/skills/
  • Codex

    Lê
    AGENTS.md
    Skills
    .agents/skills/
  • Grok Build

    Lê
    AGENTS.md e CLAUDE.md
    Skills
    .grok/skills/, .agents/skills/, skills do Claude Code
  • Cursor, GitHub Copilot, Gemini CLI, OpenCode

    Lê
    AGENTS.md
    Skills
    Pastas próprias, ou o CLI diretamente

Issue trackers (opcional)

Um push é uma escrita externa, então só acontece quando você o executa. Iniciar, pausar ou retomar um incremento nunca toca um tracker, e nada cria issues além de um push. Concluir um incremento fecha a issue vinculada por um push somente quando a opção de fechar ao concluir está ativada; sync setup a ativa, e você pode desativá-la. sync pull informa o que mudou no tracker para você revisar; ele não reescreve os seus arquivos locais.

  • GitHub Issues

    Útil quandoIssues e código ficam no mesmo lugar.

    GitHub
  • Jira

    Útil quandoProduto e engenharia compartilham um processo de entrega já existente.

    Jira e Azure DevOps
  • Azure DevOps

    Útil quandoSua organização planeja com work items e quadros.

    Jira e Azure DevOps
specweave sync setup           # conectar um tracker
specweave sync status          # credenciais, saúde, o que mudaria
specweave sync push 0042       # publicar o progresso, quando você escolher
specweave sync pull            # informar mudanças feitas no tracker

Quem é dono de quê

Uma issue fechada não prova que os critérios de aceitação passaram; um relatório de verify aprovado prova.

No seu repositório

A spec e o ledger

A spec e o ledger registram o que significa concluído e o que foi verificado.

No tracker

Contexto de planejamento

O tracker guarda o contexto de planejamento: prioridade, responsável, rótulos e o lugar onde os stakeholders olham.

Preciso de um tracker?

Não. Specs, ledger, handoffs e o painel funcionam localmente. Adicione um tracker quando ele facilitar a colaboração.

Mover um card no painel atualiza o Jira?

Não. As mudanças no quadro são locais. Execute specweave sync push para o incremento quando quiser atualizar o tracker.

Como uma equipe deve avaliar isso?

Comece com um repositório e um projeto de tracker descartável. Confira o mapeamento, as permissões, as issues reabertas e as falhas parciais com sync push --dry-run antes de conectar o tracker de verdade.

Também do SpecWeave