# Generate Session Prompt > Gerar prompt para retomada de desenvolvimento em nova sessão. Use quando sessão >150k tokens, ao retomar trabalho após pausa, ao trocar de ferramenta, ou em mudança de contexto. Aceita argumento de detalhe (brief, standard, detailed). Funciona em qualquer projeto — modo opinionated quando há `.planning/` na raiz, modo genérico caso contrário. - Skill: `fernando-bertholdo/generate-session-prompt` (Agent Skill) - Install (CLI): `npx skillmds@latest add fernando-bertholdo/generate-session-prompt` - Raw SKILL.md: https://api.skillmd.com/api/skills/fernando-bertholdo/generate-session-prompt/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: fernando-bertholdo (https://skillmd.com/u/fernando-bertholdo) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/fernando-bertholdo/generate-session-prompt --- # Generate Session Prompt Gera prompt para continuidade de trabalho em nova sessão, adaptando nível de detalhe ao contexto. ## Quando Usar - Sessão atual >150k tokens (performance degradada) - Retomar trabalho após pausa (dias/semanas) - Trocar de ferramenta (ex: Cursor → Claude Code) - Mudança de contexto (ex: finalizou um trabalho secundário, vai retomar o principal) - Handoff de tarefas complexas com conclusões a preservar ## Níveis de Detalhe A skill aceita um argumento que define a profundidade do prompt gerado: | Nível | Invocação | Tokens | Quando Usar | |-------|-----------|--------|-------------| | **brief** | `generate-session-prompt brief` | 200-500 | Continuação imediata, mesmo contexto, próximo dia | | **standard** | `generate-session-prompt` (default) | 800-1500 | Retomada após pausa, troca de ferramenta, complexidade moderada | | **detailed** | `generate-session-prompt detailed` | 1500-3000+ | Handoff complexo, múltiplas tarefas pendentes, conclusões/análises a preservar | ### Quando usar cada nível **brief** — Quando o contexto da próxima sessão é simples: - Mesmo trabalho, continuando de onde parou - Poucas tarefas restantes, caminho claro - Sem análises ou conclusões a transportar **standard** (default) — Para a maioria dos casos: - Retomada após dias/semanas - Troca de ferramenta (Cursor → Claude Code) - Trabalho com progresso parcial e próximos passos claros - Algumas decisões ou conclusões a registrar **detailed** — Quando o prompt precisa carregar contexto rico: - Múltiplas tarefas pendentes com sub-itens e pontos de atenção - Conclusões de análises (monitoramento, arquitetura, roadmap) que a próxima sessão deve executar - Handoff de sessão longa com descobertas técnicas (ex: APIs, convenções, bugs) - Transição entre fases ou reconciliação de roadmap - Quando o usuário pede "contexto completo" ou "prompt detalhado" ### Seleção automática (quando o usuário não especifica nível) Se o usuário não indicar nível explicitamente, **inferir** com base no contexto: ``` Sessão curta + mesmo trabalho + poucas tarefas → brief Caso geral / sem indicação clara → standard Sessão com análises, conclusões ou múltiplas tarefas → detailed Usuário pediu "contexto completo" ou similar → detailed ``` ## Princípios 1. **Contexto proporcional** — O detalhe do prompt deve ser proporcional à complexidade do handoff 2. **Referências @** — Facilita navegação do agente (links diretos a arquivos) 3. **Conclusões inline** — Carregar conclusões/análises no prompt quando a próxima sessão precisa agir sobre elas (nível standard e detailed) 4. **Tipo-agnóstico** — Funciona para qualquer tipo de trabalho. Em projetos com framework opinionado (`.planning/` presente), reconhece os tipos do framework; caso contrário, opera com tipos genéricos 5. **Skills contextuais** — Indicar skills relevantes para a próxima sessão ## Detecção de Modo **Antes de qualquer coleta**, verifique se o diretório `.planning/` existe na raiz do projeto atual: - **Existe `.planning/`** → use **MODE:opinionated-initiative** (vocabulário milestone/detour/patch/ajuste/avulso, leitura de Roadmap/TODO/CONTEXT, templates específicos do framework) - **Não existe `.planning/`** → use **MODE:generic** (vocabulário feature/bugfix/refactor/spike/misc, leitura de README/git/sessão, templates universais) A detecção determina **apenas** o procedimento de coleta de contexto e o conjunto de templates. Os princípios, níveis de detalhe, regras gerais e validação são idênticos nos dois modos. ## Procedimento de Geração 1. **Detectar modo** (ver seção acima) 2. **Coletar estado atual** — segue o bloco do modo detectado (ver abaixo) 3. **Determinar nível de detalhe** — argumento explícito, ou inferir 4. **Gerar prompt** seguindo a estrutura do nível escolhido + template do tipo de trabalho do modo ativo 5. **Validar** contra o checklist do nível --- ## MODE:opinionated-initiative — Coleta e Templates Use quando `.planning/` existe na raiz. Vocabulário e estrutura assumem o framework `tech-product-template`. ### Coleta (Procedimento passo 2) ```bash 1. Identificar tipo de trabalho - Ler .planning/README.md para identificar tipo (milestone / detour / patch) - Se milestone → localizar .planning/milestones/MX.X-nome/ - Se detour → localizar .planning/detours// - Se patch → verificar .planning/patches/{slug}/plan.md - Se avulso (sem vínculo) → verificar .planning/scratch/ 2. Coletar estado atual - Resolver path do CONTEXT.md: a. Milestone: .planning/milestones/MX.X-*/CONTEXT.md (glob) b. Detour: .planning/detours//CONTEXT.md c. Fallback legado: _archive//CONTEXT.md d. Se nada → prosseguir sem CONTEXT.md (usar Roadmap/TODO) - Ler CONTEXT.md resolvido (contexto vivo, se existir) - Ler Roadmap.md (milestone/fase atual, DoR/DoD) - Ler TODO.md (tarefas pendentes e progresso) - Ler plans em .claude/plans/ (se existir) - Verificar últimos commits (git log --oneline -5) - Verificar git status (mudanças pendentes) - Ler Projeto.md (regras de negócio, se relevante) - Coletar conclusões/análises da sessão atual (se houver) ``` ### Templates por Tipo de Trabalho #### Milestone (qualquer nível) **Abertura:** `Vamos continuar a implementação do milestone [ID] ([NOME]).` **Referências obrigatórias:** Roadmap.md (DoR/DoD), TODO.md (seção do milestone), CONTEXT.md da initiative **Contexto:** Progresso quantitativo (X/Y tarefas, N% DoD), próxima tarefa, bloqueios **Skills:** validate-dor, validate-dod, pre-commit-check, validate-testing #### Detour (qualquer nível) **Abertura:** `Vamos continuar o detour [NOME] (relacionado a [MILESTONES]).` **Referências obrigatórias:** .planning/detours//CONTEXT.md, Roadmap.md (seção Desvios), TODO.md **Contexto:** Fases do detour, entregas já concluídas, impacto em milestones futuros **Skills:** pre-commit-check, organize-commits, update-docs #### Ajuste de Roadmap / Documentação (qualquer nível) **Abertura:** `Vamos continuar os ajustes de roadmap e documentação do Monitor de Fundos Lass.` **Referências obrigatórias:** Roadmap.md, TODO.md, Projeto.md, .planning/README.md **Contexto:** O que motivou os ajustes, quais milestones são afetados, decisões a registrar **Skills:** update-docs, validate-docs-links, audit-architecture #### Troubleshooting (qualquer nível) **Abertura:** `Vamos resolver o issue [DESCRIÇÃO] no contexto de [INICIATIVA].` **Referências obrigatórias:** Arquivo com erro, log/evidência, TODO.md **Contexto:** Sintoma, esperado, tentativas anteriores, impacto **Skills:** pre-commit-check, validate-testing #### Trabalho Avulso / Sem Milestone (qualquer nível) **Abertura:** `Vamos trabalhar em [DESCRIÇÃO] no projeto Monitor de Fundos Lass.` **Referências:** .planning/scratch/-CONTEXT.md (se existir), arquivos relevantes **Contexto:** Motivação, escopo, relação com roadmap (se houver) ### Exemplos de Formato (modo opinionated) #### Brief (200-500 tokens) ```markdown Vamos continuar o desenvolvimento do Monitor de Fundos Lass na [TIPO: milestone|detour|ajuste] [ID] ([NOME]). **Referências principais:** - @[arquivo1] (contexto sobre X) - @[arquivo2] (tarefas e checklist) - @[arquivo3] (se aplicável) **Objetivo:** [Descrição concisa — 1 frase] **Contexto atual:** - [Progresso — N% ou X/Y tarefas] - [Estado — o que foi feito] - [Próximo — o que falta] **Por favor:** 1. [Tarefa 1] 2. [Tarefa 2] 3. [Tarefa 3] 4. [Tarefa 4 — atualizar docs/tracking] ``` #### Standard (800-1500 tokens — default) ```markdown Vamos continuar o desenvolvimento do Monitor de Fundos Lass na [TIPO] [ID] ([NOME]). [1 frase de contexto situacional] **Referências principais:** - @[arquivo1] (contexto — detalhe) - @[arquivo2] (tarefas — detalhe) - @[arquivo3] (plano/evidência — detalhe) - ... (até 8 refs) **Objetivo:** [Descrição — 1-2 frases] **Contexto atual:** - [Progresso quantitativo] - [Estado das entregas] - [Decisões pendentes ou recentes] - [Bloqueios/dependências se houver] **Conclusões da sessão anterior:** (se aplicável) - [Conclusão 1 — resumo] - [Conclusão 2 — resumo] - [Impacto/próximos passos derivados] **Por favor:** 1. [Tarefa 1 — com contexto mínimo] 2. [Tarefa 2 — com skill sugerida] 3. [Tarefa 3 — com critério de completude] 4. [Tarefa 4 — atualizar docs/tracking] ``` #### Detailed (1500-3000+ tokens) ```markdown Vamos continuar o desenvolvimento do Monitor de Fundos Lass com foco em [DESCRIÇÃO DO FOCO]. [2-3 frases de contexto situacional] **Referências principais:** - @[arquivo1] (detalhe) - @[arquivo2] (detalhe) - ... (todas as referências relevantes, sem limite) **Objetivo:** [Parágrafo descrevendo o objetivo principal e sub-objetivos] --- ### Contexto: [Frente/Iniciativa 1] [Parágrafo descrevendo estado, progresso, entregas] [Dados quantitativos: commits, testes, cobertura] [Referências a evidências] --- ### TAREFA A — [Nome da tarefa] **Conclusão da análise anterior:** - [Ponto 1 — com justificativa] - [Ponto 2 — com alternativas descartadas] - [Ponto 3 — com recomendação] **Ação sugerida:** 1. [Sub-ação 1 — detalhada] 2. [Sub-ação 2 — detalhada] 3. [Sub-ação 3 — detalhada] --- ### TAREFA B — [Nome da tarefa] **Pontos de atenção identificados:** **Ponto 1: [Título]** - Estado real: [descrição] - Ação: [o que fazer] **Ponto 2: [Título]** - Estado real: [descrição] - Ação: [o que fazer] (... quantos pontos forem necessários) --- **Por favor:** 1. [Tarefa consolidada 1 — com referências] 2. [Tarefa consolidada 2 — com skills sugeridas] 3. [Tarefa consolidada 3 — com critérios de completude] 4. [Tarefa consolidada 4 — com referências a seções acima] 5. [Tarefa consolidada N — atualizar docs/tracking] ``` ### Referências (modo opinionated) - `.planning/README.md` — Hub: mapeamento milestone→initiative, tipos de trabalho - `.planning/milestones/MX.X-nome/CONTEXT.md` — Contexto vivo de milestone - `.planning/detours//CONTEXT.md` — Contexto vivo de detour - `.planning/scratch/` — Context dumps avulsos (sem milestone) - `documents/core/Roadmap.md` — Milestones, desvios, DoR/DoD - `documents/core/TODO.md` — Tarefas granulares e progresso - `documents/core/Projeto.md` — Regras de negócio e decisões - `CLAUDE.md` — Regras operacionais ### Skills Relacionadas (modo opinionated) - `fresh-context` — Gerar CONTEXT.md para handoff (complementar: context file vs. prompt) - `validate-dor` — Validar DoR antes de iniciar milestone - `validate-dod` — Validar DoD antes de fechar milestone - `update-docs` — Atualizar documentação (Projeto/Roadmap/TODO) - `pre-commit-check` — Qualidade antes de commit --- ## MODE:generic — Coleta e Templates Use quando `.planning/` **não** existe na raiz. Vocabulário e estrutura são universais — funcionam em qualquer projeto, independente de framework. ### Coleta (Procedimento passo 2) ```bash 1. Identificar tipo de trabalho - Olhar a sessão atual: o que foi discutido, código tocado, problema sendo resolvido - Verificar branch atual (git branch --show-current) a. Padrões nominais ajudam: feat/* → feature; fix/* → bugfix; refactor/* → refactor; spike/* → spike - Se ambíguo, classificar como "misc" e seguir 2. Coletar estado do projeto - Ler README.md (visão geral, comandos, stack) - Ler manifest principal se existir (package.json, pyproject.toml, Cargo.toml, go.mod, etc. — para entender stack e scripts) - git log --oneline -10 (últimos commits — narrativa do trabalho recente) - git status (mudanças pendentes não commitadas) - git diff HEAD --stat (escopo das mudanças não commitadas, se houver) - Listar arquivos modificados nas últimas 48h: find . -type f -mtime -2 -not -path './.git/*' -not -path './node_modules/*' \ -not -path './.next/*' -not -path './dist/*' -not -path './build/*' 2>/dev/null | head -20 3. Coletar contexto da sessão atual (CRÍTICO) - O que o usuário pediu, o que foi entregue, o que ficou pendente - Decisões tomadas e o porquê - Análises ou descobertas técnicas relevantes (APIs, bugs, convenções) - Bloqueios encontrados e como foram contornados (ou não) ``` ### Templates por Tipo de Trabalho #### Feature / Initiative (qualquer nível) **Abertura:** `Vamos continuar a implementação de [FEATURE] em [PROJETO].` **Referências obrigatórias:** README.md, arquivos principais da feature, branch atual **Contexto:** O que está pronto, o que falta, próxima tarefa concreta **Skills sugeridas:** organize-commits, pre-commit-check (se existirem) #### Bug fix / Investigation (qualquer nível) **Abertura:** `Vamos resolver [BUG/ISSUE] em [PROJETO].` **Referências obrigatórias:** Arquivo onde o bug se manifesta, log/stack trace, teste reproduzindo (se houver) **Contexto:** Sintoma, comportamento esperado, hipóteses já testadas, impacto **Skills sugeridas:** systematic-debugging (se disponível) #### Refactor / Cleanup / Docs (qualquer nível) **Abertura:** `Vamos continuar o refactor/limpeza de [ÁREA] em [PROJETO].` **Referências obrigatórias:** Arquivos sendo refatorados, testes correspondentes, docs afetadas **Contexto:** Motivação (debt, performance, clareza), escopo definido, restrições, reversibilidade **Skills sugeridas:** simplify, code-review #### Spike / Exploração (qualquer nível) **Abertura:** `Vamos continuar a exploração de [TEMA/QUESTÃO] em [PROJETO].` **Referências obrigatórias:** Notas/scratch da exploração (se existirem), código de prova de conceito **Contexto:** Pergunta sendo respondida, alternativas já avaliadas, critério de sucesso da exploração **Skills sugeridas:** brainstorming (se disponível) #### Misc / Trabalho Avulso (qualquer nível) **Abertura:** `Vamos continuar o trabalho em [DESCRIÇÃO] em [PROJETO].` **Referências:** Arquivos relevantes identificados na sessão **Contexto:** O que motivou, o que foi feito, o que falta ### Exemplos de Formato (modo genérico) #### Brief (200-500 tokens) ```markdown Vamos continuar a [TIPO: implementação|correção|refactor|exploração] de [DESCRIÇÃO] em [PROJETO]. **Referências principais:** - @[arquivo1] (contexto sobre X) - @[arquivo2] (código sendo tocado) - @[arquivo3] (teste/evidência se aplicável) **Objetivo:** [Descrição concisa — 1 frase] **Contexto atual:** - Branch: [nome] — [progresso resumido] - [O que foi feito na sessão anterior — 1 bullet] - [Próximo passo concreto — 1 bullet] **Por favor:** 1. [Tarefa 1] 2. [Tarefa 2] 3. [Tarefa 3] ``` #### Standard (800-1500 tokens — default) ```markdown Vamos continuar a [TIPO] de [DESCRIÇÃO] em [PROJETO]. [1 frase de contexto situacional — o que está acontecendo] **Referências principais:** - @[arquivo1] (contexto — detalhe) - @[arquivo2] (código sendo tocado — detalhe) - @[arquivo3] (teste/evidência — detalhe) - ... (5-8 refs) **Objetivo:** [Descrição — 1-2 frases] **Contexto atual:** - Branch: [nome] - Últimos commits: [resumo de 1-3 commits relevantes] - Mudanças pendentes: [arquivos com diff não commitado, se houver] - [Estado do trabalho — bullet] - [Decisões tomadas/pendentes — bullet] - [Bloqueios se houver] **Conclusões da sessão anterior:** (se aplicável) - [Conclusão 1 — resumo] - [Conclusão 2 — resumo] - [Próximo passo derivado] **Por favor:** 1. [Tarefa 1 — com contexto mínimo] 2. [Tarefa 2 — com critério de completude] 3. [Tarefa 3 — atualizar testes/docs se aplicável] 4. [Tarefa 4 — commit/PR conforme padrão do projeto] ``` #### Detailed (1500-3000+ tokens) ```markdown Vamos continuar [TIPO] de [DESCRIÇÃO] em [PROJETO] com foco em [FOCO]. [2-3 frases de contexto situacional] **Referências principais:** - @[arquivo1] (detalhe) - @[arquivo2] (detalhe) - ... (todas as referências relevantes, sem limite) **Objetivo:** [Parágrafo descrevendo objetivo e sub-objetivos] --- ### Contexto do projeto [Parágrafo: o que é o projeto, stack, convenções relevantes que a próxima sessão precisa saber] [Branch atual, narrativa dos últimos commits, escopo do diff pendente] --- ### TAREFA A — [Nome da tarefa] **Conclusão da análise anterior:** - [Ponto 1 — com justificativa] - [Ponto 2 — alternativas descartadas] - [Ponto 3 — recomendação] **Ação sugerida:** 1. [Sub-ação 1 — detalhada] 2. [Sub-ação 2 — detalhada] --- ### TAREFA B — [Nome da tarefa] **Pontos de atenção identificados:** **Ponto 1: [Título]** - Estado real: [descrição] - Ação: [o que fazer] **Ponto 2: [Título]** - Estado real: [descrição] - Ação: [o que fazer] --- **Por favor:** 1. [Tarefa consolidada 1 — com referências] 2. [Tarefa consolidada 2 — com critério de completude] 3. [Tarefa consolidada N — commit/PR conforme padrão] ``` ### Skills Relacionadas (modo genérico) - `simplify` — Refinar código para clareza após mudanças - `commit-commands:commit` — Criar commits estruturados - `code-review` — Revisar mudanças antes de PR - `superpowers:systematic-debugging` — Debug metódico para bugs persistentes - `superpowers:brainstorming` — Explorar opções antes de implementar --- ## Regras de Geração ### SEMPRE: 1. Adaptar detalhe ao nível solicitado/inferido 2. Usar referências @ (facilita navegação do agente) 3. Incluir métricas quando disponíveis (progresso %, coverage, commits) 4. Referenciar skills aplicáveis à próxima sessão (do conjunto do modo ativo) 5. Incluir conclusões/análises inline quando a próxima sessão precisa agir sobre elas 6. Identificar tipo de trabalho (usando os tipos do modo ativo) 7. Incluir validações e critérios de completude ### NUNCA: 1. Incluir histórico completo da sessão (resumir, não copiar) 2. Duplicar conteúdo extenso dos arquivos referenciados (resumir e apontar) 3. Usar descrições genéricas ("continue o trabalho") 4. Omitir referências aos arquivos principais 5. Forçar formato/vocabulário do modo errado (não usar "milestone" sem `.planning/`; não usar "feature" como abertura quando há milestone ativo) 6. Ignorar conclusões/análises relevantes da sessão atual em níveis standard/detailed 7. Misturar templates dos dois modos no mesmo prompt ## Estrutura por Nível (universal) ### Brief (200-500 tokens) **Seções:** - Linha de abertura (do template do tipo de trabalho do modo ativo) - Referências (3-5) - Objetivo (1 linha) - Contexto atual (3-5 bullets) - Tarefas (3-4 ações) ### Standard (800-1500 tokens — default) **Seções:** - Linha de abertura (do template do tipo + 1 frase de contexto) - Referências (5-8) - Objetivo (1-2 frases) - Contexto/Progresso (5-8 bullets, organizados por tema) - Decisões/Conclusões relevantes (se houver — 2-5 bullets) - Tarefas (4-6 ações com sub-detalhes quando necessário) - Skills sugeridas ### Detailed (1500-3000+ tokens) **Seções:** - Linha de abertura (do template do tipo) - Referências (sem limite arbitrário — todas as relevantes) - Objetivo + sub-objetivos - Contexto expandido (situação, progresso, estado de cada frente) - Seções por tarefa/frente pendente com: - Conclusões/análises da sessão (inline, não referenciadas) - Pontos de atenção identificados - Ações sugeridas com detalhes - Tarefas consolidadas (lista final acionável) - Skills e validações ## Validação por Nível ### Brief - [ ] Tokens: 200-500 - [ ] Referências: 3-5 - [ ] Objetivo: 1 frase clara - [ ] Contexto: 3-5 bullets - [ ] Tarefas: 3-4 ações específicas - [ ] Tipo de trabalho identificado (modo ativo) ### Standard - [ ] Tokens: 800-1500 - [ ] Referências: 5-8 - [ ] Objetivo: 1-2 frases - [ ] Contexto: 5-8 bullets organizados - [ ] Conclusões: inline se houver (2-5 bullets) - [ ] Tarefas: 4-6 ações com sub-detalhes - [ ] Skills sugeridas (do modo ativo) - [ ] Tipo de trabalho identificado ### Detailed - [ ] Tokens: 1500-3000+ - [ ] Referências: todas as relevantes (sem limite) - [ ] Objetivo: parágrafo com sub-objetivos - [ ] Contexto: expandido por frente/iniciativa - [ ] Conclusões/Análises: seções dedicadas por tarefa - [ ] Pontos de atenção: listados com estado real + ação - [ ] Tarefas: consolidadas com referências às seções - [ ] Skills e validações sugeridas - [ ] Tipo de trabalho identificado ## Fluxo de Uso ### Cenário 1: Continuação simples ```bash generate-session-prompt brief ``` ### Cenário 2: Retomada após pausa ```bash generate-session-prompt # Gera prompt standard (default) ``` ### Cenário 3: Handoff complexo ```bash generate-session-prompt detailed # Prompt carrega conclusões, pontos de atenção, ações detalhadas ``` ### Cenário 4: Troca de ferramenta ```bash # Cursor → Claude Code (precisa contexto suficiente) generate-session-prompt # ou detailed se houver muito contexto a preservar ``` ### Cenário 5: Projeto sem framework ```bash # Projeto sem .planning/ — modo genérico ativado automaticamente generate-session-prompt # Lê README, git log, git status, contexto da sessão ``` ## Troubleshooting ### Problema: Prompt muito genérico **Causa:** Tipo de trabalho não identificado, ou modo errado, ou contexto da sessão pobre **Solução:** Em modo opinionated, atualizar TODO.md/CONTEXT.md antes; em modo genérico, garantir que a sessão tem decisões/análises explícitas ### Problema: Prompt detalhado quando queria conciso **Causa:** Inferência automática optou por mais detalhe **Solução:** Usar argumento explícito: `generate-session-prompt brief` ### Problema: Conclusões da sessão não aparecem no prompt **Causa:** Nível brief não inclui conclusões; ou sessão não teve análises explícitas **Solução:** Usar nível standard ou detailed ### Problema: Referências quebradas **Causa:** Arquivos movidos ou renomeados **Solução:** Em modo opinionated, executar `validate-docs-links`; em modo genérico, validar manualmente os caminhos ### Problema: Modo errado detectado **Causa:** `.planning/` existe mas o trabalho é genérico (ou vice-versa) **Solução:** Hoje a detecção é binária pela presença de `.planning/`. Se necessário, edite o prompt gerado para misturar — porém isso indica que o framework do projeto está mal-definido (considere mover o trabalho ad-hoc para `.planning/scratch/`) --- ## Changelog ### v4.0.0 (28/Abril/2026) **Refactor para modo dual (opinionated + generic):** - Adicionada detecção automática de modo via presença de `.planning/` na raiz - Bloco `MODE:opinionated-initiative` preserva integralmente o comportamento v3.0.0 (vocabulário milestone/detour/patch/ajuste/avulso, leitura de Roadmap/TODO/CONTEXT) - Novo bloco `MODE:generic` para projetos sem framework opinionado: vocabulário feature/bugfix/refactor/spike/misc, coleta via README + git log + git status + contexto da sessão - Princípios, níveis de detalhe, regras gerais e validação são universais - Templates por tipo movidos para dentro dos blocos de modo - Sentinelas `` / `` delimitam cada bloco para facilitar manutenção e syncs futuros - Versão movida para o frontmatter - **Compatibilidade:** projetos que usam o template (com `.planning/`) não veem diferença alguma — modo opinionated é selecionado automaticamente **Motivação:** Permitir uso da skill em qualquer projeto, viabilizando empacotamento como plugin no marketplace `4-successful-AI-life`. Sem este refactor, a skill produziria output esquisito em projetos sem `.planning/`. ### v3.0.0 (19/Fevereiro/2026) **Evolução para níveis de detalhe dinâmicos:** - Três níveis: brief (200-500 tokens), standard (800-1500, default), detailed (1500-3000+) - Substituição de "formato obrigatório" por guidelines flexíveis por nível - Suporte a iniciativa-agnóstico (milestone, detour, patch, ajuste, avulso) - Templates por tipo de trabalho (5 tipos vs. 4 milestone-only anteriores) - Procedimento expandido para cobrir todos os tipos de .planning/ - Conclusões/análises inline nos níveis standard e detailed - Remoção do hard cap de 250 tokens e limites fixos de referências/tarefas - Inferência automática de nível quando não especificado - Validação por nível (checklists separados) **Autor:** Fernando Bertholdo **Contexto:** Feedback de uso real — prompts curtos demais perdiam contexto de análises, formato milestone-only não cobria detours e ajustes de roadmap ### v2.0.0 (27/Janeiro/2026) - Criação dos templates por tipo (Planejamento, Implementação, Testes, Troubleshooting) - Integração com skills (validate-dor, validate-dod, etc.) - Limite de 250 tokens ### v1.0.0 (22/Janeiro/2026) - Criação inicial