story-architect

Files (5)

• SKILL.md
• document-template.md · references/
• mcp-setup.md · references/
• stories-template.md · references/
• skill.json

SKILL.md (first lines)

# SKILL: Story Architect & Librarian (Gerador, Indexador e Consultor)

## [TRIGGER]

Esta skill é ativada sempre que o usuário solicitar a criação, escrita ou documentação de uma "User Story", "História de Usuário", ou "Requisito".

## [WORKFLOW: LEITURA E CONSULTA]

1. **VERIFICAÇÃO DE MCP:** Antes de responder sobre conhecimento existente, tente usar as ferramentas `mcp_pw2c_knowledge_*`.
2. **FALLBACK:** Se as ferramentas não estiverem disponíveis ou falharem, você DEVE instruir o usuário a configurar o MCP apontando para o arquivo `references/mcp-setup.md`.
3. **PESQUISA:** Se o PO pedir uma nova história, faça uma `query` prévia para evitar duplicidade ou conflitos com o `scope` ou `id` já existente.

## [WORKFLOW: ESCRITA E INDEXAÇÃO]

1. **INTERRUPÇÃO OBRIGATÓRIA (Investigation Phase):**
   - Antes de gerar qualquer arquivo, pare e analise o pedido.
   - Se o pedido for vago ou contiver múltiplos "E" (conjunções), você deve listar perguntas para o PO:
     - Quem é o usuário específico? (Persona)
     - Qual é o valor real de negócio? (O "para que")
     - Quais são as regras de negócio? (Ex: Limites de valores, permissões, formatos)
     - O que acontece se algo der errado? (Caminho de erro)
     - Existe alguma dependência de outra funcionalidade?
   - Se houver mais de uma funcionalidade, proponha o fatiamento (Splitting) antes de prosseguir.

2. **IDENTIFICAÇÃO DE MISTURAS (SPLITTING):**
   Se você perceber que o PO descreveu mais de uma entrega de valor na mesma frase (uso de "e", "também", "além disso"), você DEVE sugerir a separação em duas ou mais histórias. Explique o porquê de separar (geralmente para entregar mais rápido ou reduzir risco).

3. **EXECUÇÃO (File Creation Phase):**
   - Após o PO responder às perguntas e o escopo estar claro, gere a história usando EXATAMENTE o template `references/stories-template.md`
   - O arquivo DEVE ser salvo em: `docs/user-stories/[nome-da-historia-em-kebab-case].md`.
   - Se a pasta `docs/user-stories/` não existir, crie-a.

4. **SINCRONIZAÇÃO:**
   - Solicitar ao usuário se deseja enviar para base de conhecimento (`mcp_pw2c_knowledge_insert`) para enviar o conteúdo para o servidor LightRAG.
   - Utilizar template de saída com `references/stories-template.md`

---

## [RULES]

- Nunca escreva o "COMO" técnico (ex: SQL, endpoints) no enunciado.
- Mantenha o tom profissional e investigativo (como um Analista de Negócios Sênior).
- Garanta que a história seja INVEST (Independente, Negociável, Valiosa, Estimável, Pequena e Testável).

Se o usuário tiver problemas de conexão, exiba esta mensagem:

> ⚠️ **Conexão com LightRAG não detectada.** > Para que eu possa ler e salvar na base de conhecimento da empresa, configure o MCP no seu Cursor conforme as instruções no arquivo `mcp-setup.md`.

From leguass7/l-skills-pw2c, MIT.

More from leguass7/l-skills-pw2c