Documentar

Documentar — Spec & Resolução por item

Recebe um ID de item + o contexto que o Gabriel descrever e grava um documento markdown na pasta do cliente. Dois modos: Spec (antes de fazer, planejamento) ou Resolução (depois de feito: o problema + como foi resolvido).

Localização

• Vault de tarefas (para achar o item pelo ID): C:\Users\gabriel.dalacorte\Documents\Dalacorte\Tarefas — principalmente o Kanban.md. (Cofre único Dalacorte.)
• Base dos documentos de cliente (DOCS_BASE): C:\Users\gabriel.dalacorte\Documents\Dalacorte\Proximas Tarefas e Ajustes
• Caminho final do doc: {DOCS_BASE}/{Cliente}/{Projeto}/{ID} - {nome do card}/{Tipo} {YYYY-MM-DD}.md
  • {ID} - {nome do card} é a pasta do card (o item vira uma pasta própria — cabem Spec, Resolução, prints e anexos dele lá dentro).
  • {Tipo} = Spec ou Resolução.
  • Ex.: .../PersonalizeIT/Site Institucional/PER-014 - Melhorar as mensagens enviadas no WhatsApp/Resolução 2026-07-21.md

Prefixo do ID → empresa → pasta do cliente

Fluxo

1. Pegue o ID que o Gabriel citou (ex.: PER-014). O prefixo já define a empresa e a pasta base.
2. Ache o item pelo ID para saber a descrição: grep -n "{ID}" "C:\Users\gabriel.dalacorte\Documents\Dalacorte\Tarefas\Kanban.md" (se não achar no Kanban, grep recursivo em Tarefas/). Se não achar o ID, avise e peça a descrição.
3. Extraia o nome do card da linha encontrada: tire o prefixo - [ ] {ID} · e limpe sufixos redundantes entre parênteses — data (ex.: (20/07)) e o próprio nome do projeto (ex.: (Site Institucional)). Esse texto limpo é o {nome do card}.
   • Ex.: PER-014 · Melhorar as mensagens enviadas no WhatsApp (Site Institucional) → nome = Melhorar as mensagens enviadas no WhatsApp.
4. Decida o modo pelo que ele disser:
   • "vou fazer", "planeja", "cria a spec", "antes de começar" → Spec.
   • "resolvi", "consertei", "fiz assim", "como resolvi", "já está pronto" → Resolução.
   • Se ambíguo, pergunte curto: "Spec (planejamento) ou Resolução (como foi feito)?".
5. Defina o Projeto a partir do que ele falar (ex.: "Site Institucional", "Brunetto", ou um caminho com mais níveis como "Novo Intranet / Desenvolvimento"). Se não deixar claro, pergunte só isso. Não invente.
6. Monte o caminho e grave:
   • Pasta: {DOCS_BASE}/{Cliente}/{Projeto}/{ID} - {nome do card}/ (crie se não existir).
   • Arquivo: {Tipo} {YYYY-MM-DD}.md (Spec ou Resolução; data = hoje, date +%Y-%m-%d). Se já existir um do mesmo dia, acrescente (2), (3)…
   • Sanitize nomes de pasta/arquivo para o Windows: os caracteres \ / : * ? " < > | não podem aparecer — troque : por - e remova os demais.
7. Confirme mostrando o caminho completo do arquivo e um resumo do conteúdo. Nada mais.

Template — Spec (planejamento)

# {ID} — {nome do card} · Spec

- **Item:** {ID} — {descrição do card}
- **Cliente / Projeto:** {Cliente} / {Projeto}
- **Data:** {YYYY-MM-DD}

## Problema / Contexto
{o que motiva, dor atual, situação hoje}

## Objetivo
{o que se quer alcançar, em uma frase}

## Escopo
- Inclui: {...}
- Não inclui: {...}

## Requisitos
- [ ] {requisito 1}
- [ ] {requisito 2}

## Plano de implementação
1. {passo}
2. {passo}

## Critérios de aceite
- [ ] {como saber que está pronto}

## Observações / riscos
{dependências, pontos de atenção}

Template — Resolução (o problema + como foi resolvido)

# {ID} — {nome do card} · Resolução

- **Item:** {ID} — {descrição do card}
- **Cliente / Projeto:** {Cliente} / {Projeto}
- **Data:** {YYYY-MM-DD}

## Problema
{qual era o problema, sintoma, como aparecia}

## Diagnóstico / Causa
{o que estava por trás}

## Solução aplicada
{o que foi feito, passo a passo}

## Mudanças
- {arquivos, serviços, configs, PRs, migrations tocados}

## Como validar / testar
1. {passo para reproduzir/verificar que resolveu}

## Observações
{efeitos colaterais, follow-ups, o que ficou de fora}

Regras

• O nome da pasta é sempre {ID} - {nome do card} — NUNCA invente um título curto próprio.
• O texto sai do que o Gabriel descrever — NÃO invente detalhes técnicos que ele não deu; deixe placeholders curtos ou pergunte.
• Preencha o que o próprio card já diz (descrição, empresa) sem perguntar de novo.
• Só peça informação que realmente falta (Projeto/modo). Uma pergunta curta, não um questionário.
• Responder sempre em português.
• Não edite o Kanban nem os arquivos de tarefa aqui — esta skill só gera o documento na pasta do cliente. (Marcar tarefa como feita é a skill registrar.)