NexusSpec

CLI para workflows de Spec-Driven Development com GitHub Copilot (e outros agentes de IA).

NexusSpec padroniza como times criam e mantêm documentação de produto antes de escrever código, seguindo o fluxo: PRD Geral → PRD Tarefa → TechSpec → Plano → Implementação.

---

Instalação

Via pip (a partir do GitHub):

pip install git+https://github.com/LucasFerrDev/NexusSpec.git

Via uv (recomendado):

uv tool install git+https://github.com/LucasFerrDev/NexusSpec.git

Após instalar, o comando nexusspec estará disponível globalmente no terminal.

---

Uso

Novo projeto

nexusspec init meu-projeto

Cria a pasta meu-projeto/ com toda a estrutura pronta:

meu-projeto/
├── docs/
│   └── tarefas/
├── prompts/
│   ├── pdr_geral.md
│   ├── prd_tarefa.md
│   ├── techspec_tarefa.md
│   └── plan.md
└── README.md

Projeto existente

cd meu-projeto-existente
nexusspec add

Adiciona os prompts na pasta prompts/ sem sobrescrever nada que já existe.

Inicializar no diretório atual

nexusspec init .

Sobrescrever prompts existentes

nexusspec init meu-projeto --force
nexusspec add --force

Ver prompts disponíveis

nexusspec list

---

Fluxo recomendado

Depois de rodar nexusspec init, abra o projeto no VS Code com GitHub Copilot (modo Agent) e siga a sequência:

1. PRD Geral

#pdr_geral.md

Saída: docs/PRD_GERAL.md

2. PRD da tarefa

#prd_tarefa.md

Saída: docs/tarefas/tarefa-001/PRD_TAREFA_001.md

3. TechSpec da tarefa

#techspec_tarefa.md

Saída: docs/tarefas/tarefa-001/TECHSPEC_TAREFA_001.md

4. Plano automático

#plan.md

O agente varre docs/tarefas/, identifica quais tarefas ainda não têm plano e gera automaticamente.

Saídas:

• docs/tarefas/tarefa-001/PLANO_TAREFA_001.md
• implementation_plan.md (raiz do projeto — visão consolidada de todas as tarefas)

5. Implementação

Implemente o plano salvando os arquivos na raiz do projeto

---

Pré-requisitos

• Python 3.11+
• uv (recomendado) ou pip
• VS Code com GitHub Copilot, Claude Code, ou outro agente de IA compatível

---

Estrutura do repositório

NexusSpec/
├── src/
│   └── nexusspec/
│       ├── __init__.py
│       ├── cli.py              ← lógica dos comandos
│       └── templates/          ← prompts empacotados
│           ├── pdr_geral.md
│           ├── prd_tarefa.md
│           ├── techspec_tarefa.md
│           └── plan.md
├── docs/
│   └── tutorial.md
├── pyproject.toml
└── README.md

---

Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.