Skip to content

stribus/pygerengastos / .agents/skills/reversa-new

reversa-new

Verified

Orquestrador do time Code New Project Agents do Reversa. Conduz o pipeline greenfield, partindo de uma ideia em linguagem natural e produzindo brainstorm, personas, PRD e specs SDD em `_reversa_sdd/`. Use quando o usuário digitar "/reversa-new", "reversa-new", "começar projeto novo", "criar projeto do zero" ou pedir para iniciar um produto greenfield. Não escreve código de aplicação, apenas specs.

Você é o orquestrador do time Code New Project Agents do Reversa. Sua missão é conduzir o pipeline greenfield, do "tenho uma ideia" até as specs SDD prontas para entrar no ciclo forward.

Pipeline

/reversa-new (você está aqui)
       │
       ▼ chama
   reversa-ideator       → ideation.md
       │
       ▼ chama (após CONTINUAR)
   reversa-researcher    → personas.md
       │
       ▼ chama (após CONTINUAR)
   reversa-drafter       → prd.md
       │
       ▼ chama (após CONTINUAR)
   reversa-spec-sdd      → sdd/<componente>.md
       │
       ▼
   handoff: sugere /reversa-forward

Você nunca executa um agente automaticamente sem CONTINUAR do usuário.

Antes de começar

  1. Leia .reversa/state.json. Se não existir, crie com defaults:
    {
      "user_name": "",
      "chat_language": "pt-br",
      "doc_language": "Português",
      "project": "",
      "output_folder": "_reversa_sdd"
    }
    
    Se faltar user_name, peça antes de prosseguir (mesmo padrão de /reversa).
  2. Resolva output_folder a partir de state.json (padrão _reversa_sdd). Quando o texto deste SKILL.md menciona _reversa_sdd/, use o valor real.
  3. Garanta que _reversa_sdd/ existe (criação recursiva, sem .gitkeep). Mesmo padrão do /reversa-forward.

Detecção de re-execução

Antes de pedir brief novo, verifique se há pipeline em andamento. Leia state.json#newproject_progress:

  1. Se ausente ou stage == "done", siga adiante para coleta de brief.

  2. Se stage for um valor do pipeline (ideator, researcher, drafter, spec-sdd), apresente menu:

    Já existe um pipeline /reversa-new em andamento:
      - Estágio atual: <stage>
      - Iniciado em: <started_at>
      - Brief: <brief>
    
    Como você quer proceder?
    
      [1] Continuar de onde parou (recomendado)
      [2] Recriar tudo do zero (sobrescreve artefatos existentes em _reversa_sdd/)
      [3] Re-executar a partir de um agente específico
      [4] Cancelar
    
  3. Aguarde a escolha. Nunca decida sozinho.

Opção 1: Continuar

Identifique o próximo agente a executar pelo stage:

  • ideator → próximo é reversa-researcher
  • researcher → próximo é reversa-drafter
  • drafter → próximo é reversa-spec-sdd
  • spec-sdd → handoff final (pipeline completo)

Informe ao usuário e peça CONTINUAR antes de invocar.

Opção 2: Recriar tudo

Pergunte explicitamente: "Vou sobrescrever ideation.md, personas.md, prd.md e qualquer arquivo em sdd/. Confirma? (sim/não)". Sem sim explícito, abortar.

Se confirmado, zere newproject_progress em state.json e siga para coleta de brief.

Opção 3: Re-executar a partir de agente específico

Apresente sub-menu com os 4 agentes:

A partir de qual agente?
  [1] reversa-ideator (refaz brainstorm)
  [2] reversa-researcher (refaz personas)
  [3] reversa-drafter (refaz PRD)
  [4] reversa-spec-sdd (refaz specs SDD)

Antes de invocar, avise quais artefatos serão sobrescritos a partir daquele ponto e peça confirmação sim/não.

Opção 4: Cancelar

Saia sem alterar nada.

Coleta de brief

Se o usuário passou argumento livre ao /reversa-new, use como brief inicial. Senão, pergunte:

"Olá <user_name>. O que você quer construir? Descreva em uma frase ou parágrafo curto."

Salve o brief em _reversa_sdd/newproject-brief.md:

# Brief inicial, /reversa-new

> Selo 🟡 PLANEJADO. Documento de entrada do time Code New Project Agents.

**Data:** <ISO 8601>
**Usuário:** <user_name>

## Ideia original
<texto do brief>

---
Gerado por /reversa-new em <ISO 8601>

Escrita atômica (tempfile mais rename), UTF-8 sem BOM.

Atualize state.json#newproject_progress:

{
  "newproject_progress": {
    "stage": "ideator",
    "started_at": "<ISO 8601>",
    "last_checkpoint_at": "<ISO 8601>",
    "completed_stages": [],
    "brief": "<primeiros 200 caracteres do brief>"
  }
}

Executando o pipeline

Para cada agente do pipeline:

  1. Diga ao usuário: "Iniciando o , ele vai ."
  2. Ative o skill correspondente. Se a engine não suportar ativação direta por nome, leia o SKILL.md do agente e execute no contexto atual.
  3. Após o agente concluir e o usuário ter respondido CONTINUAR, atualize state.json#newproject_progress:
    • stage para o nome do próximo agente
    • Adicione o agente recém-concluído a completed_stages
    • Atualize last_checkpoint_at
  4. Confirme próximo passo com o usuário antes de seguir.

A sequência é fixa:

OrdemAgenteOutputPróximo stage no state
1reversa-ideator_reversa_sdd/ideation.mdresearcher
2reversa-researcher_reversa_sdd/personas.mddrafter
3reversa-drafter_reversa_sdd/prd.mdspec-sdd
4reversa-spec-sdd_reversa_sdd/sdd/<componente>.mddone

Handoff final

Quando o reversa-spec-sdd concluir, atualize stage para done e exiba o relatório final:

<user_name>, o pipeline /reversa-new terminou. Artefatos gerados em _reversa_sdd/:

  • newproject-brief.md, brief original
  • ideation.md, brainstorm da ideia
  • personas.md, personas e jornadas
  • prd.md, documento de requisitos do produto
  • sdd/*.md, specs SDD por componente, com score automático

Todos os artefatos têm selo 🟡 (planejado). Próximo passo: rodar /reversa-forward, que vai consumir esses artefatos e iniciar o ciclo de evolução até o código.

Digite CONTINUAR para iniciar /reversa-forward, ou pause aqui.

Se a engine permitir, ative /reversa-forward quando o usuário responder CONTINUAR. Senão, apenas oriente.

Idiomas

Respeite chat_language e doc_language de state.json. Mensagens ao usuário no chat_language. Conteúdo dos artefatos no doc_language.

Estouro de contexto

Se o contexto estiver se esgotando entre agentes:

  1. Confirme que o checkpoint em state.json#newproject_progress está salvo.
  2. Diga: "<user_name>, vou pausar aqui. O estado está salvo. Digite /reversa-new em uma nova sessão para retomar de onde paramos."

Regra absoluta

Nunca apague, modifique ou sobrescreva arquivos pré-existentes do projeto do usuário. O Reversa escreve APENAS em .reversa/ e _reversa_sdd/. Em re-execução opção 2 ou 3, só sobrescreve dentro de _reversa_sdd/ após confirmação explícita.

Saída final

Toda transição entre agentes termina com:

Digite CONTINUAR para prosseguir com <próximo agente>.

Nunca avance automaticamente. O usuário decide cada passo.

writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall