Communitygithub.com

jintomjose/mini-software-factory

Transforma um intent.md confirmado em spec.md (requisitos e design em um único artefato), com questões de política e decisões em aberto sinalizadas inline. Use após capture-intent e antes do modo plan.

O que é mini-software-factory?

Esta skill, parte da mini-software-factory, gera um artefato completo de especificação (spec.md) a partir de uma intenção registrada (intent.md), seguindo um template padronizado. Ela é projetada para agentes de IA como Claude Code, Cursor ou Codex, que operam em modo de planejamento incremental. A skill garante que o agente leia o código existente e o arquivo CLAUDE.md para capturar restrições, evitando especificações que ignorem o contexto real. O spec.md resultante inclui histórias de usuário priorizadas (P1, P2, P3), identificadores estáveis (FR-xxx, SC-xxx) para rastreabilidade, e sinaliza explicitamente decisões pendentes ([NEEDS CLARIFICATION]) e preocupações de política ([POLICY: ...]) sem resolução silenciosa. A seção de design é mantida no nível adequado para o plano (alterações de dados, interfaces, estados e casos de erro). Por fim, a skill lista explicitamente o que está fora do escopo, requer que o humano resolva todas as necessidades de clarificação antes de salvar, e o commit do spec.md aciona o modo de planejamento.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/write-spec
Ver original→Navegar por todas as habilidades

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentação

Escrever especificação

Entrada: work/<feature>/intent.md. Saída: work/<feature>/spec.md a partir de factory/templates/spec.md.

  1. Leia intent.md, CLAUDE.md e as partes do código que a alteração afetará. Uma especificação escrita sem ler o código ignora restrições; essa é a falha mais comum.
  2. Escreva histórias de usuário em ordem de prioridade (P1, P2, P3). Cada história P1 deve ser independentemente entregável e testável.
  3. Atribua a cada requisito funcional um ID estável (FR-001) e a cada critério de sucesso um também (SC-001). Revisões e testes referenciam esses IDs.
  4. Sinalize inline, nunca resolva silenciosamente:
    • [NEEDS CLARIFICATION: ...] para qualquer decisão que a intenção não resolva
    • [POLICY: privacidade | segurança | legal | dinheiro | marca] sempre que uma regra se aplicar, informando a regra
  5. Escreva a seção de design apenas na profundidade que o plano necessitar: alterações de dados, interfaces, estados, casos de erro.
  6. Liste o que está explicitamente fora do escopo.
  7. Apresente a especificação, resolva cada [NEEDS CLARIFICATION] com o humano e, em seguida, salve. Fazer commit de spec.md é o gatilho para o modo de plano.

Habilidades Relacionadas

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community