fluxo-de-entrega

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

Qu'est-ce que fluxo-de-entrega ?

Esta skill automatiza o fluxo de entrega e memória para agentes de IA como Claude Code, integrando-se diretamente ao Obsidian (VAULT_MEMORIA). Ela orquestra a documentação, commit, push e salvamento de histórico de forma obrigatória e sequencial. Útil para desenvolvedores que desejam rastrear cada alteração, manter um histórico detalhado e sincronizado entre sessões, e ter registros compactados e indexados para consultas futuras. A skill suporta Conventional Commits, push para branch `dev`, merge opcional para produção e escrita estruturada no Obsidian com frontmatter YAML, links `[[ ]]` e um índice global giratório.

Compatible avec✓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 Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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]

Skills associés