convez.ai
SkillDevOps & InfraestruturaAvançado
nrwl

Polygraph Skills

nrwl/polygraph-skills

Skills de IA para coordenação multi-repo com Polygraph

Ver no GitHub
InicialPluginScore · de 0 a 100

Conjunto de skills e subagentes para coordenação de mudanças em repositórios múltiplos via Polygraph. Fornece integração nativa com Claude Code, GitHub Copilot, Gemini e outras plataformas de IA através de plugins para Codex e OpenCode.

Instalação

$npx convez-ai nrwl/polygraph-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
15
Forks
4
Acompanhando
0
Saúde
37%
Último commit
há 1 mês
Versão
—
Issues abertas
3
Contribuidores
5

Casos de uso

  • Inicializar e gerenciar sessões de coordenação multi-repositório
  • Delegar tarefas para agentes filhos em outros repositórios
  • Monitorar e aguardar pipelines CI/CD em múltiplos repos
  • Investigar falhas de CI e apresentar opções de correção

Veredito

Solução especializada para times que trabalham com monorepos ou múltiplos repositórios coordenados. Integração robusta com agentes Claude e outras plataformas, mas requer entendimento de fluxos multi-repo e CI/CD para aproveitar adequadamente.

README

A tradução para o português deste README ainda está na fila.

What is Polygraph?

Polygraph is a standalone product for coordinating changes across multiple repositories. It lets AI agents delegate work to child agents in other repos, monitor CI across repos, and manage multi-repo sessions.

Skills

  • polygraph — Comprehensive guidance for multi-repo coordination: session init, delegation, branch pushing, PR creation, and session management
  • await-polygraph-ci — Wait for CI pipelines to settle across all repos in a session, investigate failures, and present fix options
  • get-latest-ci — One-shot fetch of the latest CI pipeline execution for the current branch

Agents

  • polygraph-init-subagent — Discovers candidate repositories and initializes a Polygraph session
  • polygraph-delegate-subagent — Delegates work to a child agent in another repository, polls for completion

Codex Installer

The publishable Codex package now exposes an explicit installer CLI:

npx @polygraph/codex-plugin

That command copies the packaged Codex plugin into:

~/.agents/plugins/polygraph

installs the packaged custom Codex subagents into:

$CODEX_HOME/agents

updates the personal Codex marketplace at:

~/.agents/plugins/marketplace.json

so the polygraph plugin points at ./.agents/plugins/polygraph, and enables the plugin in:

$CODEX_HOME/config.toml

CODEX_HOME defaults to ~/.codex when unset.

To verify an install, run:

npx @polygraph/codex-plugin check

OpenCode Plugin

The publishable OpenCode package exposes the skills and subagents through OpenCode's native plugin system. Add it to opencode.json:

{
  "plugin": ["@polygraph/opencode-plugin"]
}

For repeatable installs, pin the npm version:

{
  "plugin": ["@polygraph/opencode-plugin@0.4.18"]
}

The plugin adds its packaged skills/ directory to OpenCode's skill paths and registers the packaged Markdown agents as subagent entries in OpenCode config during startup.

Development

# Install dependencies
npm install

# Regenerate generated artifacts
npm run sync-artifacts

Releasing

Run the Release PR GitHub Actions workflow with a version bump (patch, minor, or major). It opens a release PR against main instead of pushing directly. When that PR is merged, the Stage Release workflow automatically tags the release and publishes the Claude, Codex, and OpenCode npm packages. A maintainer must then review and approve each staged package with 2FA before it is published to the live registry.

Configure each npm package's trusted publisher to allow npm stage publish from .github/workflows/publish.yml. For the strictest release flow, do not allow direct npm publish for the trusted publisher and disallow token-based publishing after the staged workflow has been verified.

Learn More

License

License information is defined in the package metadata.

Ver o original no GitHub

Bom para

Relacionados