kharmanskyi/open-steps

O que é?

Recursos principais

• 01Relata o trabalho concluído em um veredito de uma única tela, com o status, as ações necessárias do usuário e a nova dívida técnica.
• 02Apresenta etapas numeradas para usuários sem conhecimentos técnicos e tenta executar as tarefas antes de pedir ajuda.
• 03Confere as afirmações de outras sessões com base no que realmente aconteceu.
• 04Reescreve textos carregados de jargão de engenharia em linguagem simples, sem perder os fatos.
• 05Mantém um arquivo BIG-PICTURE.md que acompanha os recursos, o código não utilizado e a fila de trabalho.
• 06É compatível com Claude Code, Codex CLI, Cursor CLI e Gemini CLI.

Casos de uso

• Pessoas que não são engenheiras, criam produtos com um agente de programação com IA e precisam saber se o trabalho foi concluído.
• Fundadores ou gerentes de produto que preferem relatórios de status em linguagem simples a logs de commits.
• Equipes que querem que uma segunda sessão verifique as afirmações de outro agente antes de aceitá-las.
• Decidir se devem avançar com uma mudança difícil de reverter, como uma migração ou um lançamento.

Início rápido

1. 1

   Clone o repositório

   git clone https://github.com/kharmanskyi/open-steps.git
2. 2

   Instale o pacote como um plugin do Claude Code

   claude plugin marketplace add ./open-steps && claude plugin install open-steps@open-steps
3. 3

   Adicione o bloco de roteamento ao arquivo de instruções do Claude Code

   grep -q 'os-done-or-not' ~/.claude/CLAUDE.md 2>/dev/null || cat open-steps/docs/routing-block.md >> ~/.claude/CLAUDE.md

Antes de usar

• !O README testa apenas o Claude Code de forma completa; as permissões das skills no Codex CLI, Cursor CLI e Gemini CLI não foram testadas.
• !O pacote pode mesclar pull requests por conta própria quando as verificações são aprovadas e uma revisão é aprovada, a menos que uma observação na tarefa diga o contrário.
• !Para atualizar, é preciso executar git pull no clone e atualizar o plugin. Caso contrário, uma cópia antiga continuará instalada.

Tópicos

Perguntas frequentes

O que é open-steps?

Skills em linguagem simples para Claude Code, Codex CLI, Cursor CLI e Gemini CLI transformam relatórios de sessão em um veredito fácil de entender, exibido em uma única tela. Open Steps é um conjunto de skills para agentes que muda a forma como eles relatam o trabalho. Em vez de hashes de commit e jargão de engenharia, o agente apresenta um relatório curto com um veredito claro: se o trabalho foi concluído, se precisa de algo do usuário, que dívida técnica foi criada e se é seguro encerrar a sessão.

open-steps é gratuito? Qual é a licença?

open-steps é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

open-steps ainda é mantido?

Manutenção ativa. O último commit de open-steps foi em 5 de out. de 2026.

Para que posso usar open-steps?

Pessoas que não são engenheiras, criam produtos com um agente de programação com IA e precisam saber se o trabalho foi concluído. Fundadores ou gerentes de produto que preferem relatórios de status em linguagem simples a logs de commits. Equipes que querem que uma segunda sessão verifique as afirmações de outro agente antes de aceitá-las. Decidir se devem avançar com uma mudança difícil de reverter, como uma migração ou um lançamento.

Como instalar open-steps?

Clone o repositório: git clone https://github.com/kharmanskyi/open-steps.git Instale o pacote como um plugin do Claude Code: claude plugin marketplace add ./open-steps && claude plugin install open-steps@open-steps Adicione o bloco de roteamento ao arquivo de instruções do Claude Code: grep -q 'os-done-or-not' ~/.claude/CLAUDE.md 2>/dev/null || cat open-steps/docs/routing-block.md >> ~/.claude/CLAUDE.md

Onde consigo open-steps?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/kharmanskyi/open-steps