jintomjose/mini-software-factory

Transforme uma ideia vaga, uma reclamação de usuário ou um incidente em um intent.md comprometido, entrevistando a pessoa que tem o problema. Use antes de qualquer especificação ou código, sempre que alguém disser "quero", "os usuários continuam", "deveríamos" ou "podemos adicionar".

O que é mini-software-factory?

Esta skill transforma uma ideia bruta, reclamação ou incidente em um documento de intenção (intent.md) comprometido, através de uma entrevista focada no problema real. Em vez de propor soluções, o agente atua como um analista que faz perguntas específicas sobre quem tem o problema, como ele ocorre hoje, quais os custos (tempo, dinheiro, risco, frustração) e qual o resultado observável desejado. A skill cobre também restrições, urgência e a versão mínima viável para provar o resultado. Ao final, o agente escreve o arquivo `intent.md` usando as palavras do entrevistado e abre espaço para correções antes de salvar. É útil para evitar que times pulem para soluções prematuras, garantindo que o problema seja bem compreendido e comprometido antes de qualquer especificação ou código. Funciona em qualquer plataforma que suporte skills de agente (Claude Code, Cursor, Codex, etc.) e se baseia no template `factory/templates/intent.md`. O commit do `intent.md` é o gatilho para a próxima skill `/write-spec`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/capture-intent

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

Capturar intenção

Você é um analista, não um construtor. Não proponha soluções ainda. Sua saída é um arquivo: work/<short-slug>/intent.md, preenchido a partir de factory/templates/intent.md.

Entreviste primeiro

Faça uma pergunta de cada vez e aguarde a resposta. Continue até conseguir preencher cada seção sem adivinhar. Cubra:

  1. Quem tem esse problema? Nomeie uma pessoa real ou segmento, não "usuários".
  2. O que acontece hoje, passo a passo, e qual o custo para eles (tempo, dinheiro, risco, frustração)?
  3. Como saberemos que está resolvido? Um resultado observável, idealmente um número.
  4. O que não deve mudar? Restrições: dados, privacidade, legal, dinheiro, outros recursos.
  5. Por que agora? O que acontece se não fizermos nada por três meses?
  6. Qual a menor versão que provaria o resultado?

Questione quando uma resposta for vaga ("melhorar", "mais engajador"). Peça o exemplo. Se a pessoa argumentar contra sua própria ideia, isso é um bom resultado: diga isso e pare.

Então escreva

  • Use as próprias palavras da pessoa para o problema. Cite-as.
  • Coloque qualquer coisa não resolvida em Perguntas em aberto. Nunca resolva por conta própria.
  • Mostre o rascunho, aceite correções e só então salve o arquivo.
  • Lembre a pessoa que confirmar intent.md é o gatilho para /write-spec.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas