Configure seu ecossistema de plugins

• plugin-template — um ponto de partida para criar um único plugin (ou alguns deles).
• team-marketplace-template — o padrão completo do ecossistema: um monorepo de plugins mais um meta-plugin cujo manifest define sua base e política.

​

1. Crie seus plugins

my-plugin/
├── .devin-plugin/
│   └── plugin.json     # name, version, dependency + policy lists
├── AGENTS.md           # always-on rule
├── rules/              # triggered rules
├── agents/<name>.md   # subagentes personalizados (somente CLI/Desktop por enquanto); agents/<name>/AGENT.md também funciona
├── hooks.json          # lifecycle hooks
├── .mcp.json           # MCP servers
└── skills/<name>/SKILL.md   # skills, exposed as /<plugin>:<skill>

​

2. Validar e testar localmente

devin plugins install --local ./plugins/my-plugin   # vinculado, apenas nesta máquina: as edições são aplicadas na próxima sessão
devin plugins list

​

3. Hospede-os em um único repo

​

4. Defina sua base com um meta-plugin

// .devin-plugin/plugin.json (raiz do repo)
{
  "name": "team-starter-pack",
  "requiredPlugins": [
    // instalado automaticamente para todos, recursivamente
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/engineering-baseline" },
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/security-guardrails" }
  ],
  "optionalPlugins": [
    // aprovado, não instalado automaticamente; também uma exceção aos itens proibidos deste manifest
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/frontend-standards" }
  ],
  "forbiddenPlugins": [
    "untrusted-vendor/*"
  ]
}

​

5. Distribuir a partir do Customize

{
  "requiredPlugins": ["acme/plugins"]
}

• O manifest da enterprise alcança todas as organizações da enterprise.
• Um manifest de organização alcança as sessão em nuvem daquela organização e o CLI/Desktop dos membros que a têm como organização primária.

​

6. Governança

{
  "forbiddenPlugins": ["*"],
  "requiredPlugins": [
    "acme/plugins",
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/engineering-baseline" },
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/security-guardrails" }
  ],
  "optionalPlugins": [
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/frontend-standards" }
  ]
}

​

7. Evolua

• Fazer merge na branch padrão do repo do seu plugin é a própria release: novas sessões incorporam isso automaticamente — veja como as atualizações são implementadas.
• Teams adicionam plugins por PR ao repo do marketplace; a CI do template valida a estrutura em cada PR.
• Plugins existentes do Claude são instalados sem modificações (o Devin usa .claude-plugin/plugin.json como fallback), então você pode recomendar plugins da comunidade em optionalPlugins sem incorporá-los ao repositório.

​

Limitações atuais

• Os plugins são carregados em sessões em nuvem, no Devin CLI e no Devin Desktop (ao usar Devin Local); eles não se aplicam ao agente Cascade clássico.
• Subagentes (agents/<name>.md or agents/<name>/AGENT.md) são carregados apenas em agentes locais do Devin (CLI e Devin Desktop), não em sessões em nuvem.
• Atualmente, os Hooks funcionam com melhor esforço e falha aberta — um hook que não consegue carregar ou executar não interrompe a sessão — portanto, ainda não dependa deles para guardrails cruciais. Consulte a referência de hooks da CLI para configuração local.
• A governança tem falha aberta: se um manifest gerenciado não puder ser obtido no início da sessão, os plugins daquele nível não são instalados e seus forbids não são aplicados naquela sessão.
• O conteúdo de plugin de um repo private aparece em Customize apenas para organizações cuja integração Git consegue alcançar o repo; nos demais casos, ele fica retido até que o repo seja concedido em Configurações → Repositories.

​

Saiba mais

• Guia de plugins — a parte do app web: Customize, escopos, indexação, MCPs
• Referência de plugins da CLI — formato de arquivo, criação e instalações por usuário
• Skills — os procedimentos SKILL.md que os pacotes de plugins incluem