full-dev-cycle

name	full-dev-cycle
description	"Receber qualquer feature request, bug fix ou refactoring task (vago ou detalhado)"

Full Dev Cycle — Super-Skill

Pipeline determinístico de 8 fases que leva qualquer feature request do vague idea ao PR pronto para merge, com gates de qualidade verificáveis entre cada fase.

Why This Skill Exists

O engineering_agentops tem o melhor pipeline end-to-end nativo do repo APEX — brainstorming → writing-plans → subagent-driven-development → TDD → verification-before-completion → finishing → code-review. Porém, nenhuma skill existente orquestra esse pipeline completo; cada skill é invocada isoladamente, perdendo os gates e a sequência determinística. Esta super-skill resolve isso: é o orquestrador declarativo que garante que nenhum código chega ao PR sem passar pelos 8 gates.

When to Use

Use esta skill quando:

• Receber qualquer feature request, bug fix ou refactoring task (vago ou detalhado)
• Quiser garantir que todo o ciclo de qualidade (design → test → review) seja executado
• Operar em modo subagente para paralelizar tasks independentes
• Precisar de um pipeline auditável com timestamps por fase (phases_completed)

Não use para: hotfixes urgentes sem gate (use verification-before-completion diretamente), ou exploração exploratória sem output definido (use brainstorming isolado).

What If Fails

Fase	Falha	Ação
1 – Brainstorming	Design não converge	Iterar socrático; nunca avançar sem aprovação explícita
2 – Writing Plans	Spec ambíguo	Retornar à fase 1; nunca criar plan de spec incompleto
3 – Execução	Bloqueado	PARAR imediatamente; pedir ajuda humana; nunca adivinhar
4 – TDD	Sem cobertura	Escrever teste antes de qualquer código — RED obrigatório
5 – Verificação	Sem evidência	Nunca declarar "provavelmente funciona"; executar e citar output
6 – Finishing	Teste falha	Não criar PR; corrigir e re-verificar
7 – Code Review	PR bloqueado	Adereçar todos os comments antes de merge

Orchestration Protocol

PHASE 1: brainstorming
  → Input: feature_request + project_context
  → Output: design_doc_path
  → HARD_GATE: usuário aprova design antes de prosseguir

PHASE 2: writing-plans
  → Input: design_doc_path
  → Output: plan_file_path (tasks de 2-5 min cada)
  → GATE: plan_file_path existe e não está vazio

PHASE 3 [subagent]: subagent-driven-development
  → Input: plan_file_path
  → Dispatch: 1 subagente por task independente
  → GATE: todos os subagentes retornaram com sucesso

PHASE 3 [inline]: executing-plans
  → Input: plan_file_path
  → Executa task a task na mesma sessão

PHASE 4: test-driven-development (por task)
  → RED: escrever failing test → GREEN: mínimo para passar → REFACTOR
  → GATE: test_coverage >= projeto_baseline

PHASE 5: verification-before-completion (por claim)
  → Executar comando → ler output completo → citar evidência
  → GATE: nenhum claim sem evidência de execução

PHASE 6: finishing-a-development-branch
  → Rodar suíte completa → formatar commits → criar PR
  → GATE: PR url retornado

PHASE 7: requesting-code-review
  → Contexto do PR + checklist → solicitar review
  → Output: phases_completed[] com timestamps

Diff History

• v00.36.0: Criado via OPP-Phase4-super-skills — super-skill compositora do pipeline engineering_agentops