Skip to content

feat: adiciona suporte ao Pi Coding Agent como engine#1

Open
quantmind-br wants to merge 3 commits intosandeco:mainfrom
quantmind-br:feat/pi-coding-engine
Open

feat: adiciona suporte ao Pi Coding Agent como engine#1
quantmind-br wants to merge 3 commits intosandeco:mainfrom
quantmind-br:feat/pi-coding-engine

Conversation

@quantmind-br
Copy link
Copy Markdown

@quantmind-br quantmind-br commented Apr 29, 2026

Resumo

Registra o Pi Coding Agent (pi-coding-agent) como novo engine no installer do reversa, permitindo que projetos que usam o pi recebam todas as skills do reversa via npx reversa install.

Por que

O pi é um coding-agent CLI baseado em terminal que segue o Agent Skills standard — o mesmo formato que o reversa já usa. Ele auto-descobre skills em .agents/skills/ (pasta que o reversa já popula para outros engines). Falta apenas registrar o engine para que o usuário possa selecioná-lo no installer.

Como funciona

  • Skills: instaladas em .agents/skills/ (mesma estratégia do Codex — auto-descoberta nativa pelo pi, sem duplicar arquivos)
  • Entry file: .pi/prompts/reversa.md — prompt template nativo do pi. O filename reversa.md registra automaticamente o slash command /reversa no autocomplete do pi, mantendo a mesma UX dos outros engines
  • Detecção: via diretório .pi/ no projeto OU binário pi no PATH

Mudanças

Arquivo Mudança
lib/installer/detector.js Nova entrada no array ENGINES + detector
templates/engines/pi Novo prompt template (3 linhas + frontmatter)
agents/reversa-agents-help/SKILL.md name: agents_helpname: reversa-agents-help (underscore inválido no spec; precisa bater com diretório pai)
agents/reversa-reconstructor/SKILL.md description envolto em aspas — Ativação: era interpretado como mapping aninhado pelo parser YAML
docs/agentes/agents-help.{md,pt.md,es.md} Atualiza slash command para /reversa-agents-help

As correções acima são necessárias porque o pi valida o frontmatter de forma mais estrita que outros engines — sem elas, pi reporta "Skill conflicts" e os skills afetados não carregam.

Test plan

  • detectEngines() retorna pi-coding com detected: true quando .pi/ existe ou binário pi está no PATH
  • Writer.installSkill() copia agentes do reversa para .agents/skills/<agent-id>/ corretamente
  • Writer.installEntryFile() cria .pi/prompts/reversa.md com frontmatter description válido
  • Manifest registra os 8+ arquivos por skill instalado (uninstall seguro)
  • Frontmatter dos SKILL.md compatível com a validação estrita do pi (sem warnings de "Skill conflicts")
  • Após merge: validar fluxo end-to-end com pi instalado: pi/reversa deve aparecer no autocomplete e ativar a skill principal

UX final no pi

Após npx reversa install selecionando "Pi Coding Agent":

cd projeto
pi
> /reversa            # ativa via prompt template
> /skill:reversa      # ativa via skill auto-registrada (alternativa nativa do pi)

@quantmind-br quantmind-br force-pushed the feat/pi-coding-engine branch from ea0ddae to 9698b8c Compare May 1, 2026 00:21
quantmind-br and others added 3 commits April 30, 2026 21:23
Registra o pi-coding-agent (binário `pi`) como novo engine no installer,
permitindo que o reversa instale suas skills em projetos que usam o pi.

- detector.js: nova entrada no array ENGINES + detector via `.pi/` ou
  binário `pi` no PATH
- templates/engines/pi: prompt template do pi (filename `reversa.md` no
  destino vira o slash command `/reversa` no autocomplete do pi)
- skillsDir reusa `.agents/skills` (auto-descoberto pelo pi), mesma
  estratégia adotada pelo Codex — sem duplicar arquivos

Toda a maquinaria existente (Writer, manifest, uninstall) é reaproveitada;
nenhuma mudança em writer.js, install.js ou prompts.js.
Add the pi-coding agent skill to the project, including its full
documentation suite and metadata. This allows the reversa
- reversa-agents-help: renomeia name de `agents_help` para `reversa-agents-help`
  (underscore inválido no spec; nome precisa bater com diretório pai)
- reversa-reconstructor: envolve description em aspas — colon de "Ativação:"
  era interpretado como mapping aninhado pelo parser YAML
- atualiza docs/agentes/agents-help.{md,pt.md,es.md} para o novo slash command
  /reversa-agents-help

Sem essas correções, `pi` reporta "Skill conflicts" e os skills afetados
não carregam.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@quantmind-br quantmind-br force-pushed the feat/pi-coding-engine branch from 9698b8c to b0f507f Compare May 1, 2026 00:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant