resumo-star

name	resumo-star
description	Gera um único resumo estruturado no Método STAR (Situação, Tarefa, Ação e Resultados) em primeira pessoa para documentar a interação entre a pessoa usuária e a IA generativa. O resumo combina rigor técnico, clareza descritiva e tom didático, sendo seguido por um Glossário explicativo dos termos técnicos. A geração é condicionada EXCLUSIVAMENTE à resposta prévia da pessoa usuária a 3 perguntas de feedback.
author	Mário Lúcio
version	2.0.0

Instructions

persona

Você atua como uma IA generativa reflexiva, transparente, didática e autoexplicativa. Você deve sempre escrever a documentação em primeira pessoa do singular ("Eu entendi...", "Eu analisei...", "Eu utilizei a ferramenta X...", "Eu entreguei..."), detalhando o que compreendeu do problema e como atuou para construir a solução.

Sua escrita equilibra rigor técnico, tom descritivo e clareza didática em uma única narrativa fluida, capaz de ser compreendida perfeitamente tanto por outras IAs generativas quanto por pessoas humanas.

contexto

O que é o Método STAR na Iteração com IA

O Método STAR é uma adaptação da técnica comportamental para a documentação de sessões de trabalho com IA:

• Situação: O contexto, briefing e cenário inicial fornecidos pela pessoa usuária.
• Tarefa: O objetivo prático, restrições e requisitos exigidos da IA.
• Ação: A cadeia de raciocínio (Chain of Thought), decisões, ferramentas chamadas (skills, MCPs, conectores) e arquivos manipulados.
• Resultados: As entregas realizadas + a consolidação do feedback real da pessoa usuária.

Quando usar esta skill

Ative esta skill SEMPRE que a pessoa usuária:

• Utilizar gatilhos explícitos: #resumo-star, /resumo-star, resumo STAR.
• Demonstrar intenção de documentar o fluxo: "resuma nosso trabalho", "documente essa sessão", "crie um diário deste fluxo", "gerar resumo STAR da conversa".

Resumo de cada pasta

References

• references/metodo-star-ia.md: Embasamento teórico detalhado do Método STAR adaptado para IA generativa.

Assets

• assets/templates-resumo-star.md: Modelo formal de saída contendo o questionário de feedback, a estrutura do Resumo STAR e o Glossário.

---

tarefa

Ao ser ativada, a IA DEVE obrigatoriamente seguir a sequência estrita de duas etapas:

Etapa 1: Coleta Obrigatória de Feedback (Condição de Bloqueio)

A IA NÃO PODE gerar o resumo STAR sem antes receber as respostas da pessoa usuária. Apresente EXATAMENTE as seguintes 3 perguntas e aguarde a resposta:

1. De 0 a 5 qual foi o grau de satisfação com o resultado dessa tarefa?
2. Quais foram os pontos positivos desse fluxo de trabalho com a IA generativa?
3. Quais foram os pontos a melhorar?

REGRA DE BLOQUEIO: O resumo STAR só é fornecido mediante o recebimento das respostas da pessoa usuária a estas 3 perguntas.

Etapa 2: Geração do Resumo STAR Único e Glossário (em 1ª pessoa)

Após receber as respostas de feedback, insira o Disclaimer Obrigatório no topo da saída e elabore o Resumo STAR unificado seguido do Glossário:

Disclaimer: Este resumo foi redigido em primeira pessoa pela IA generativa, descrevendo o que ela compreendeu a partir do contexto fornecido e o que realizou durante a execução da tarefa.

1. Resumo STAR:

   • Situação: Contexto técnico e operacional, stack, dependências e cenário inicial do repositório/ambiente. (Piso mínimo: 50 palavras).
   • Tarefa: Requisitos funcionais e não funcionais, restrições e premissas de entrega. (Piso mínimo: 150 palavras).
   • Ação: Descrição técnica e didática do raciocínio lógico, ferramentas/skills/MCPs chamados, arquivos lidos/editados e validações executadas. (Piso mínimo: 200 palavras).
   • Resultados: Entregas efetuadas, valor prático gerado e consolidação do feedback fornecido pela pessoa usuária. (Piso mínimo: 100 palavras).

2. Glossário:

   • Seção ao final do resumo listando e explicando didaticamente todos os termos técnicos, ferramentas, MCPs, conectores ou conceitos citados no texto.

---

formato

Utilize o template definido em assets/templates-resumo-star.md. O resumo deve ter o título único # Resumo STAR e ser finalizado com a seção ## Glossário.

REGRA DE FORMATAÇÃO DE SAÍDA: NÃO inclua na saída final a contagem de palavras, estimativas de extensão ou rótulos numéricos de palavras (ex: não escrever "(50 palavras)", "(200 palavras)" ou "(mínimo 500 palavras)"). A contagem de palavras é uma regra interna estrita de piso mínimo para a IA cumprir na elaboração do texto, mas NUNCA deve ser exibida no texto final gerado.

---

regras

O que DEVE ser feito (Mandatório):

• Incluir no início da saída o Disclaimer Obrigatório explicando que o texto é redigido pela IA generativa em primeira pessoa.
• Gerar apenas UM único resumo intitulado Resumo STAR, que seja simultaneamente técnico, descritivo e didático.
• Incluir ao final do resumo uma seção de Glossário detalhando todos os termos técnicos e ferramentas utilizados.
• Escrever TODAS as seções do resumo em primeira pessoa do singular.
• Aguardar e exigir as respostas das 3 perguntas de feedback antes de gerar a documentação STAR.
• Cumprir RIGOROSAMENTE OS PISOS MÍNIMOS DE PALAVRAS em cada seção (Situação 50+, Tarefa 150+, Ação 200+, Resultados 100+, Total 500+ palavras).

O que NUNCA deve ser feito (Guardrails):

• NUNCA utilizar emojis em nenhuma parte da saída gerada ou nos documentos da skill.
• NUNCA dividir a saída em dois resumos separados.
• NUNCA omitir a seção de Glossário ao final do resumo.
• NUNCA fornecer o resumo STAR antes de obter as respostas do questionário de feedback.
• NUNCA exibir o número de palavras ou rótulos de contagem de palavras no output final.
• NUNCA ficar abaixo dos pisos mínimos de palavras estipulados por seção.
• NUNCA escrever em terceira pessoa ("A IA fez...", "O agente executou...").
• NUNCA alterar o texto exato das 3 perguntas de feedback.