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 → Specify → Task → Apply → Verify.

---

Instalação

Via pip (em um ambiente virtual):

python -m venv .venv
source .venv/bin/activate
python -m pip install git+https://github.com/LucasFerrDev/NexusSpec.git

Via uv (recomendado):

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

Se o seu sistema bloquear pip install globalmente, use um virtualenv como acima.

Após instalar, o comando nspec estará disponível no terminal do ambiente ativo.

---

Uso

Novo projeto

nspec init meu-projeto

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

meu-projeto/
├── docs/
│   ├── prd/
│   │   ├── prd.md
│   │   ├── personas.md
│   │   └── metrics.md
│   └── architecture/
│       ├── architecture.md
│       └── epics.md
├── features/
│   ├── specs/
│   │   └── .gitkeep
│   └── done/
│       └── .gitkeep
└── README.md

Ao escolher a ferramenta no menu final do init, o NexusSpec gera automaticamente as skills para a plataforma selecionada.

Projeto existente

cd meu-projeto-existente
nspec add

Adiciona a estrutura NexusSpec e gera skills via menu.

Inicializar no diretório atual

nspec init .

Sobrescrever skills existentes

nspec init meu-projeto --force
nspec add --force

Ver skills disponíveis

nspec list

Gerar skills manualmente

nspec skills add --tool vscode
nspec skills add --tool codex
nspec skills add --tool claude --force
nspec skills add --tool cursor --skill prd

Remover skills de uma ferramenta

nspec skills remove --tool cursor
nspec skills remove --tool codex --skill prd
nspec skills remove --tool antigravity --yes
nspec skills remove --tool vscode --skill prd

---

Integração automática de skills

Durante nspec init e nspec add, ao selecionar a ferramenta no menu, os templates internos são convertidos para o formato de skills correspondente.

GitHub Copilot / VSCode

Cada prompt vira uma skill em:

.github/skills/<nome-da-skill>/SKILL.md

Exemplo:

Exemplo: .github/skills/prd/SKILL.md

Claude Code

Cada prompt vira um comando em:

.claude/commands/<nome-da-skill>.md

OpenAI Codex

Cada prompt vira uma skill local do repositório em:

.agents/skills/<nome-da-skill>/SKILL.md

As skills podem ser usadas explicitamente no Codex com $nome-da-skill ou descobertas automaticamente a partir do campo description.

Cursor

Cada utility vira uma regra em:

.cursor/rules/<nome-da-skill>.mdc

Antigravity

Cada utility vira uma skill em:

.agent/skills/<nome-da-skill>/SKILL.md

---

Fluxo recomendado

Depois de rodar nspec init, use as skills instaladas na sua ferramenta de IA na ordem:

1. prd — gera docs/prd/
2. Specify — gera features/specs/[feature]/spec.md e design.md
3. task — gera features/specs/[feature]/task.md
4. apply — implementa as tasks pendentes
5. verify — valida a implementação e recomenda arquivamento

---

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/          ← templates de skills empacotados
│           ├── prd.md
│           ├── Specify.md
│           ├── task.md
│           ├── apply.md
│           ├── verify.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.