L-Spec Agentes — Spec-Driven Development Skills

Pipeline completo de Discovery (5 fluxos) → Clarify → Specify → Discuss → Design → Tasks → Execute → Validate → Finalize. Com Bug Flow e Reverse Engineering.

Skills instaláveis em OpenCode e Claude Code — no formato padrão SKILL.md com frontmatter YAML.

Quick Install

Interativo:

curl -fsSL https://raw.githubusercontent.com/by-lua/l-spec-agentes/main/install.sh | bash

Não-interativo (quick, sem perguntas):

# Global (OpenCode + Claude)
curl -fsSL https://raw.githubusercontent.com/by-lua/l-spec-agentes/main/install.sh | bash -s -- --target both --scope global

# Projeto específico (exemplo)
curl -fsSL https://raw.githubusercontent.com/by-lua/l-spec-agentes/main/install.sh | bash -s -- --target opencode --scope project --project-root /caminho/do/projeto

Parâmetros suportados:

• --target opencode|claude|both
• --scope global|project
• --project-root /caminho (opcional; obrigatório na prática quando quiser instalar em projeto fora do diretório atual)

Ajuda:

bash install.sh --help

Ordem garantida: o instalador sempre resolve alvo/escopo primeiro e só depois instala. Nada é instalado antes da sua escolha.

Em --scope project, os diretórios são criados na raiz do projeto alvo (.opencode/ e/ou .claude/), não dentro do repositório clonado do instalador.

Para evitar erro em curl | bash quando read não recebe input, prefira o modo não-interativo com parâmetros.

Ou clone e instale localmente:

git clone https://github.com/by-lua/l-spec-agentes.git
cd l-spec-agentes
bash install.sh

O que o instalador pergunta

1. Qual agente? — OpenCode, Claude Code ou Ambos
2. Escopo? — Global (skills pra todos os projetos) ou Só neste projeto

O que acontece em cada escolha

• OpenCode

  • Skills: 14 skills
  • Path global: ~/.config/opencode/skills/<nome>/SKILL.md
  • Path projeto: .opencode/skills/<nome>/SKILL.md
  • Slash commands /... (OpenCode):
    • Global: ~/.config/opencode/commands/<nome>.md
    • Projeto: .opencode/commands/<nome>.md
  • Em escopo de projeto, o instalador cria .opencode/opencode.json com skills.paths (se não existir), para garantir descoberta das skills.
  • Observação: em OpenCode, skill e slash command são coisas diferentes; o instalador agora gera os dois.

• Claude Code

  • Skills: 14 skills
  • Path global: ~/.claude/skills/<nome>/SKILL.md
  • Path projeto: .claude/skills/<nome>/SKILL.md

• Ambos

  • Instala OpenCode + Claude na mesma execução.

Atualizar

Mesmo comando — sobrescreve skills e scripts anteriores.

Desinstalar

bash uninstall.sh

Skills Disponíveis (14)

No seu agente, digite /<nome> pra carregar a skill.

Pipeline principal

Skill	/comando	O que faz
l-spec	/l-spec	Skill raiz — fluxo completo e regras
lspec-discovery	/lspec-discovery	Discovery adaptativo — 5 fluxos + deploy
lspec-clarify	/lspec-clarify	Resolver áreas cinzentas / ambiguidades
lspec-specify	/lspec-specify	Definir WHAT com requisitos testáveis (FEAT-01...)
lspec-discuss	/lspec-discuss	Capturar trade-offs e decisões
lspec-design	/lspec-design	Definir HOW — arquitetura, componentes
lspec-tasks	/lspec-tasks	Quebrar em tarefas atômicas com dependências
lspec-execute	/lspec-execute	Implementar (RED/GREEN/GATE/COMMIT)
lspec-validate	/lspec-validate	Executar testes definidos no Specify
lspec-finalize	/lspec-finalize	Atualizar status, docs, handoff

Bug Flow

Skill	/comando	O que faz
lspec-bug	/lspec-bug	Criar pasta de bug com documentação
lspec-debug	/lspec-debug	Depurar e corrigir
lspec-revalidate	/lspec-revalidate	Reexecutar validações
lspec-bugfix	/lspec-bugfix	(compatibilidade) Correção rápida

Projeto

Skill	/comando	O que faz
lspec-reverse	/lspec-reverse	Reverse engineering — reconstrói .specs/
lspec-ask	/lspec-ask	Perguntar sobre código existente
lspec-pause	/lspec-pause	Salvar STATE + HANDOFF
lspec-resume	/lspec-resume	Carregar estado salvo
lspec-next	/lspec-next	Avançar fase manualmente
lspec-auto	/lspec-auto	Executar pipeline completo automaticamente
lspec-help	/lspec-help	Listar todos os comandos

Fluxo

→ Discovery → Clarify? → Specify → Discuss? → Design? → Tasks → Execute → Validate → Finalize

Se falhar: → Bug → Debug/Fix → Revalidate → volta pra Validate

Discovery — 5 Fluxos Adaptativos

Tipo	Perguntas
Projeto Novo	28 perguntas (6 fases) + Deploy adaptativo
Sem .specs	lspec-reverse primeiro → Discovery reduzido
Nova Feature	Discovery focado na feature
Bug	Mínimo (reprodução, severidade, validação)
Pequena Mudança	Ultra reduzido (o quê, onde, validação)

O sistema pula perguntas óbvias se o usuário já deu contexto suficiente.

Estrutura .specs/

.specs/
├── project/
│   ├── PROJECT.md        # Visão e objetivos
│   ├── ROADMAP.md        # Milestones
│   └── STATE.md          # Estado persistente (auto-atualizado)
├── design-references/    # Prints, mockups, HTML
├── features/
│   └── [feature]/
│       ├── spec.md       # Requisitos testáveis
│       ├── context.md    # Decisões do usuário
│       └── state.md      # Feature state persistente
├── bugs/
│   └── [bug-id]/
│       ├── report.md     # Passos, logs, hipóteses
│       └── context.md    # Decisões do usuário
└── handoffs/
    └── [session]/        # Pause/resume

Licença

CC-BY-4.0 — baseado em TLC Spec-Driven v2.0.0 por Felipe Rodrigues.

Integrações opcionais (recomendado)

• codenavi (exploração de código)
• mermaid-studio (diagramas de arquitetura/fluxo)

Referência de uso e fallback:

• references/integrations-codenavi-mermaid.md