Startvest-LLC/decision-memory

Habilidade do Claude para capturar decisões de produto com justificativa e contexto. Abordagem focada na conversa que reconhece momentos de decisão, pergunta o porquê e constrói trilhas de auditoria.

O que é decision-memory?

Esta habilidade (skill) para Claude (e outros agentes de IA como Cursor e Codex) permite que o agente capture automaticamente decisões de produto durante uma conversa, documentando não apenas o que foi decidido, mas também o raciocínio e o contexto por trás da decisão. É especialmente útil para equipes de desenvolvimento que desejam manter uma trilha de auditoria clara das escolhas de design, arquitetura ou funcionalidade, evitando que informações importantes se percam em conversas informais. A habilidade utiliza uma abordagem conversacional, reconhecendo momentos de decisão (quando o usuário toma uma decisão explícita ou implícita) e solicitando educadamente a justificativa (o 'porquê'). As decisões capturadas são estruturadas em um formato legível por máquina e armazenadas para referência futura. Suporta integração com plataformas como Claude Code e pode ser facilmente adicionada a projetos existentes. O fluxo de trabalho é simples: ao identificar uma decisão, o agente pergunta o motivo e registra a entrada em um arquivo de log ou banco de dados local.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add Startvest-LLC/decision-memory

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

O que decision-memory faz?

Habilidade do Claude para capturar decisões de produto com justificativa e contexto. Abordagem focada na conversa que reconhece momentos de decisão, pergunta o porquê e constrói trilhas de auditoria.

Visão Geral

Esta habilidade permite que o Claude registre decisões importantes durante a conversa, junto com sua justificativa, mantendo um histórico rastreável e auditável.

Funcionalidades

  • Detecção de Decisões: Identifica automaticamente quando uma decisão de produto, arquitetura ou design é tomada.
  • Solicitação de Contexto: Pergunta educadamente o motivo da decisão para capturar o raciocínio.
  • Registro Estruturado: Armazena decisões em formato JSON para fácil consulta e integração.
  • Trilha de Auditoria: Mantém um histórico completo que pode ser revisitado posteriormente.

Como Usar

  1. Inicie uma conversa com o Claude habilitando esta skill.
  2. Durante a conversa, ao expressar uma decisão, o Claude perguntará: "Qual é o motivo dessa decisão?"
  3. Forneça a justificativa e o contexto.
  4. O Claude registrará a decisão no arquivo decisions.json no diretório do projeto.

Estrutura do Registro

Cada decisão é registrada no seguinte formato:

{
  "timestamp": "2025-03-28T14:30:00Z",
  "decision": "Descrição da decisão",
  "rationale": "Justificativa fornecida",
  "context": "Contexto adicional",
  "tags": ["produto", "arquitetura"]
}

Plataformas Suportadas

  • Claude Code
  • Cursor
  • Codex (compatível com ferramentas similares)

Exemplo de Conversa

Usuário: Vamos usar PostgreSQL para o banco de dados.

Claude: Entendi. Qual é o motivo de escolher o PostgreSQL?

Usuário: Precisamos de suporte a consultas geográficas e alta consistência.

Claude: OK, registrado! Decisão: usar PostgreSQL. Justificativa: suporte a queries geográficas e consistência forte.

Instalação

Adicione o arquivo skill.md ao seu diretório de configuração do Claude (.claude/skills/ ou similar) ou utilize o gerenciador de skills.

Contribuição

Pull requests são bem-vindos. Para mudanças maiores, abra uma issue primeiro para discutir o que deseja alterar.

Habilidades Relacionadas