| name | cp-requisitos |
| description | Engenharia de Requisitos — cria uma crew CrewAI com Analista de Negócios, Especificador, Validador e PO Proxy para elicitar, especificar, validar e priorizar requisitos de software. Use quando o usuário disser 'levantar requisitos', 'especificar', 'documentar requisitos', 'fazer análise de negócio', 'criar user stories', ou precisar transformar um briefing em documento de requisitos. |
cp-requisitos — Engenharia de Requisitos
Cria uma crew CrewAI com agentes especializados para executar o ciclo completo de engenharia de requisitos:
- Analista de Negócios — Elicitação: entrevista o briefing, descobre regras de negócio, stakeholders, riscos
- Especificador de Requisitos — Especificação: user stories, casos de uso, critérios de aceitação (BDD), requisitos não-funcionais
- Validador de Requisitos — Validação: verifica completude, consistência, clareza, testabilidade, viabilidade
- Product Owner (Proxy) — Priorização: MoSCoW, definição de MVP, dependências
Agentes
| Agente | Função |
|---|
| Analista de Negócios | Entrevista stakeholders, descobre regras de negócio implícitas |
| Especificador de Requisitos | Redige user stories, casos de uso, critérios de aceitação |
| Validador de Requisitos | Verifica consistência, completude, viabilidade |
| Product Owner (Proxy) | Prioriza e valida alinhamento com visão do produto |
Entrada
Briefing do cliente — descrição do problema, domínio, necessidades. Pode ser:
- Texto direto no argumento:
"sistema de agendamento para clínicas"
- Arquivo:
--input briefing.txt
Saída
Documento de requisitos completo contendo:
- Análise de negócio (stakeholders, regras, riscos)
- Épicos e features
- User stories com critérios de aceitação (BDD)
- Casos de uso (fluxo principal + alternativos)
- Regras de negócio formais
- Requisitos não-funcionais
- Backlog priorizado (MoSCoW)
- Sugestão de MVP
Quality Gate
O Validador de Requisitos emite veredito PASS/FAIL. Se FAIL, o documento precisa de correções antes de seguir para a próxima fase.
Uso
python .hermes/skills/cp-requisitos/scripts/run.py "sistema de agendamento para clínicas"
python .hermes/skills/cp-requisitos/scripts/run.py --input briefing.txt
python .hermes/skills/cp-requisitos/scripts/run.py "app de estoque" --output docs/requisitos.md
python .hermes/skills/cp-requisitos/scripts/run.py "teste" --dry-run
Exemplo
python .hermes/skills/cp-requisitos/scripts/run.py \
"preciso de um sistema para clínica de estética onde a recepcionista agenda clientes, \
a esteticista vê sua agenda do dia, e a dona da clínica quer relatórios de faturamento. \
Também precisa enviar lembrete por WhatsApp automaticamente."
Script
O script scripts/run.py é self-contained — todos os agentes estão embutidos no próprio código Python. Não depende de diretório externo.
