marcosbarrosdemiranda/claude-skill-fluxo-de-entrega

Gerencia automaticamente o ciclo completo de entrega de tarefas, sincronização entre sessões e persistência de memória estruturada no Obsidian.

O que é claude-skill-fluxo-de-entrega?

Esta skill automatiza todo o fluxo de término de uma sessão de desenvolvimento com Claude, garantindo que o progresso seja documentado, versionado e armazenado de forma estruturada no Obsidian. Ao finalizar qualquer solicitação que altere arquivos do projeto (implementação, correção, refatoração, documentação, etc.), ou ao receber comandos como 'finaliza', 'salva', 'commita' ou 'encerrar sessão', ela executa na ordem obrigatória: (1) atualiza a documentação (README, CHANGELOG, comentários), (2) realiza commit com Conventional Commits após testes e verificação de segredos, (3) faz push para a branch dev, (4) pergunta se deseja subir para produção (se sim, merge e deploy), e (5) salva histórico compactado no Obsidian — incluindo registros detalhados por data, estado compactado do projeto (ESTADO.md), índice global (INDICE.md), sessões ativas e recados. É ideal para equipes que usam Claude Code, Cursor ou Codex e desejam manter rastreabilidade, evitar perda de contexto entre sessões e integrar com o Obsidian como base de conhecimento persistente.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/marcosbarrosdemiranda/claude-skill-fluxo-de-entrega/tree/HEAD/.claude/skills/fluxo-de-entrega

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Fluxo de Entrega e Memória Integrada ao Obsidian

Esta skill gerencia o ciclo completo de entrega de tarefas, sincronização entre sessões e persistência de memória estruturada no Obsidian (VAULT_MEMORIA).

ORDEM OBRIGATÓRIA DOS PASSOS

  1. DOCUMENTAR

    • Atualizar a documentação afetada (README.md, comentários, CHANGELOG.md com data e descrição).
    • Se não houver documentação a alterar, registrar ao menos no CHANGELOG.md.
  2. COMMIT & SINCRONIZAÇÃO

    • Rodar testes (se houver). Se falhar, parar.
    • Verificar ausência de segredos (.env, tokens, senhas).
    • Executar git pull --rebase na branch dev. Se houver conflito, parar e mostrar os arquivos (nunca descartar alteração de outra sessão).
    • Fazer commit de tudo alterado usando Conventional Commits (feat, fix, docs, refactor, chore...), mensagem clara em português (indicar - parcial se for o caso).
  3. PUSH PARA O GITHUB

    • Push para a branch dev (criar se não existir). Nunca usar push --force.
  4. PERGUNTAR SOBRE PRODUÇÃO

    • Perguntar: "Deseja subir esta versão para produção?"
    • Se sim: rodar testes, merge de dev para main e deploy.
    • Se não: avançar para o passo 5.
  5. SALVAR HISTÓRICO NO OBSIDIAN (Compactação & Sincronização)

    • Histórico Detalhado (historico/AAAA-MM-DD.md) : Frontmatter YAML no topo (data, projeto, tags #feat|#fix|#config|#decisao, commits). Registros com formato ## HH:MM - Título #tag, Pedido, Feito, Decisões, Arquivos, Commit, Produção, Problemas, Pendências. Usar links [[ ]] para alimentar o grafo.
    • Estado Compactado (ESTADO.md) : Reescrever o ESTADO.md do projeto (máximo 60 linhas, estilo telegráfico):
      • Estado atual
      • Últimas 10 alterações (1 linha cada: data, resumo, hash)
      • Decisões vigentes
      • Pendências abertas
    • Índice Global (INDICE.md) : Adicionar 1 linha no Claude/INDICE.md global: "AAAA-MM-DD HH:MM [projeto] resumo curto". Manter apenas 30 dias (mais antigos vão para INDICE-ARQUIVO.md).
    • Sessões Ativas & Recados: Atualizar SESSOES-ATIVAS.md e RECADOS.md. Ao encerrar sessão, remover o registro ativo.

RESUMO FINAL

Mostrar um resumo de uma linha por passo:

  • Documentado: [ok]
  • Sincronizado/Commit: [ok/hash]
  • Push: [ok/dev]
  • Produção: [sim/não]
  • Histórico Obsidian: [ok]

Habilidades Relacionadas