Iniciar Contexto — Development skill for Claude Code

/iniciar-contexto

Comando personalizado para [Claude Code](https://claude.com/claude-code) que analisa um projeto e cria (ou atualiza) uma estrutura de contexto persistente, para reduzir a dependência de memória de sessão e facilitar handoffs entre sessões futuras.

Nota: `.claude/commands/*.md` é o formato clássico de comando personalizado. A documentação oficial já trata esse formato como legado em favor de `.claude/skills//SKILL.md`, mas o formato antigo continua funcionando normalmente. Se preferir o formato novo, o conteúdo deste arquivo pode ser movido para `.claude/skills/iniciar-contexto/SKILL.md` sem mudanças no texto.

O que ele faz

• Inventaria o que já existe no projeto (CLAUDE.md, .claude/, README.md, handoffs, changelogs) antes de criar qualquer coisa nova.
• Nunca move, renomeia ou apaga arquivos existentes: adiciona uma camada de contexto por cima do que já está lá.
• Classifica o projeto (pergunta ao usuário, nunca infere) entre "projeto/setor com trabalho técnico" ou "pasta-raiz agregadora de vários projetos", e cria só os arquivos que fazem sentido para cada caso.
• Cria/atualiza um conjunto padrão de arquivos:
  • CLAUDE.md: visão geral estável do projeto (arquitetura, stack, convenções).
  • .claude/context.md: conhecimento estável (regras de negócio, integrações, limitações).
  • .claude/tasks.md: Current / Next / Done, sempre atual, sempre pequeno.
  • .claude/handoff.md: log cronológico completo, nunca sobrescrito, com changelog datado no topo.
  • .claude/decisions.md: só decisões relevantes (arquiteturais, técnicas, de negócio).
  • .claude/historico/: arquivamento de handoffs antigos quando o log crescer demais.
  • .claude/project-index.md e .claude/README.md: navegação e explicação da própria estrutura.
• Define regras de manutenção: quando um arquivo cresce demais, como dividir e arquivar sem perder rastreabilidade de pendências.

Onde funciona

Comandos personalizados são um recurso do Claude Cod