Criei uma pipeline de planejamento no OpenCode e olha no que deu

Source: Dev.to

Introdução

Você é como eu e vem buscando formas de otimizar o uso de ferramentas como o OpenCode?
Este conteúdo pode ajudar a ter novas ideias e a entender alguns fluxos dessa e de outras ferramentas.

Enquanto eu estudava a documentação do OpenCode, encontrei a aba de plugins feitos pela comunidade. Ali, identifiquei três plugins que, na minha visão, se complementam bem. Um deles já utilizava: o Plannotator.

A partir daí passei a estudar como funcionam os comandos, os agentes e como montar um fluxo que realmente faça sentido e, principalmente, que funcione. A seguir explico o que cada plugin faz e como fica o fluxo entre eles.

---

Objetivo da Integração

---

Fluxo Proposto

+---------------------------------------------------------------+
|                                                               |
|  IDEIA -> CONTEXTO -> PLANO -> REFINAMENTO -> REVISÃO -> OK   |
|                                                               |
+---------------------------------------------------------------+

O resultado é um único comando que orquestra todo o processo:

/generate-plan "descrição do objetivo"

---

Descrição dos Plugins

1. Plannotator – Revisão Visual

• Ao final de um planejamento, abre uma página no navegador contendo todo o plano gerado.
• Permite selecionar trechos do planejamento e dar feedback, que volta ao processo de planejamento.
• Também possibilita aprovar o plano e seguir diretamente para a etapa de build (aplicação do plano).

2. Octto – Coleta Estruturada de Contexto

• Quando o primeiro prompt é enviado, Octto abre uma página no navegador com perguntas relacionadas ao que foi pedido.
• Essa página funciona como uma interface interativa de brainstorming.
• As respostas geram novas perguntas dentro da mesma sessão, aprofundando o entendimento do problema e estruturando melhor o contexto.
• Ao final, gera um arquivo .md no diretório /docs/plans do projeto.

Configuração mínima adicionada

A primeira pergunta foi configurada como um campo de texto livre, permitindo ao usuário descrever o contexto com total liberdade (ex.: “colocar uma task completa”).

+----------------------+
|       ask_text       |   **Importante:** este comando **não** usa `subtask: true`, pois precisa rodar na sessão primária para abrir a UI do browser.

```text
/review-plan               # usa o plano mais recente
/review-plan docs/plans/meu-plano.md   # plano específico

---

4️⃣ Pipeline completo de planejamento

description: Pipeline completo de planejamento
agent: octto
subtask: true
return:
  - /refine-plan
  - /review-plan

Prompt – lembre‑se de usar $ARGUMENTS dentro do seu prompt.
O prompt usado no comando generate-plan está disponível no gist (link não incluído aqui).

---

5️⃣ Exemplo de JSON de configuração (início do documento)

{
  "sitos não-funcionais": [
    "Crie branches focados em: requisitos, arquitetura, riscos"
  ],
  "bootstrapper": [
    "Crie branches focados em: requisitos, arquitetura, riscos"
  ]
}

---

6️⃣ Fluxo completo de execução (resumo)

1. /generate-plan – cria o plano inicial.
2. /refine-plan – (subtask) adiciona detalhes técnicos, arquitetura e diagramas.
3. /review-plan – (sessão primária) abre o Plannotator para revisão interativa.

Resultado: funciona! É uma “bazuca”, mas demonstra o potencial da combinação de Octto, Subtask2 e os demais plugins.

---

7️⃣ Observações finais

• Quando usar: novas features, refatoração de projetos, estruturação de estudos.
• Quando evitar: tarefas triviais (ex.: “trocar a cor de um botão”) – o overhead pode ser desnecessário.
• Ponto alto: o agente Octto gera perguntas dinâmicas que ajudam muito na contextualização.
• Próximos passos: criar novos comandos, refinar prompts e explorar mais o plugin Subtask2.

Citação do Tech Lead:
“Faça código inútil e quebre alguma coisa.”

---

8️⃣ Links úteis (referência)

• OpenCode – Comandos
• OpenCode – Agentes
• Subtask2 – GitHub
• Plannotator – Plugin
• Octto – GitHub

---

9️⃣ Pergunta adicional

what does ad‑hoc

Ad‑hoc (do latim ad hoc, “para isto”) refere‑se a algo criado ou feito para um propósito específico, geralmente de forma pontual e sem planejamento prévio.

---