{
  "markdown": "# equipping-stack-docs\n\nPlugin/skill para agentes de código que gera, na hora certa, **skills de documentação locais ao projeto** com docs na versão que o projeto realmente usa — via [Context7](https://context7.com) (API REST anônima, sem MCP, sem API key).\n\nO conhecimento de treino do modelo sobre frameworks desatualiza rápido — e falha mais forte em **sistemas legados**, onde o modelo escreve os idiomas de hoje contra as APIs de ontem. Este plugin resolve os dois lados: stacks novas (docs atuais da versão exata) e legados (docs da versão antiga, com anotações de delta baseadas em evidência).\n\n## Sumário\n\n- [Instalação](#instalacao)\n- [O que funciona em cada agente](#o-que-funciona-em-cada-agente)\n- [Como funciona](#como-funciona)\n- [Quando dispara](#quando-dispara)\n- [Uso como skill avulsa (qualquer agente)](#uso-como-skill-avulsa-qualquer-agente)\n- [Compatibilidade e requisitos](#compatibilidade-e-requisitos)\n\n## Instalação\n\nA instalação muda conforme o agente. Se você usa mais de um, instale em cada um separadamente.\n\n> **Repositórios privados.** Todos os repos da Framework System são privados. Qualquer comando abaixo\n> que busque pela URL exige que você já esteja autenticado no GitHub (`gh auth login`, credential\n> helper ou chave SSH no `ssh-agent`). Sem isso o download falha com erro de autenticação, não de\n> \"não encontrado\".\n\n### Claude Code\n\nEntrega completa: skill, comandos de barra e templates.\n\n- Registre o marketplace:\n\n  ```bash\n  /plugin marketplace add Framework-System/frwk-plugins\n  ```\n\n- Instale o plugin:\n\n  ```bash\n  /plugin install equipping-stack-docs@frwk-plugins\n  ```\n\n### GitHub Copilot CLI\n\nO Copilot CLI lê o mesmo `marketplace.json` do Claude Code.\n\n- Registre o marketplace:\n\n  ```bash\n  copilot plugin marketplace add Framework-System/frwk-plugins\n  ```\n\n- Instale o plugin:\n\n  ```bash\n  copilot plugin install equipping-stack-docs@frwk-plugins\n  ```\n\n### GitHub Copilot (VS Code, JetBrains, cloud agent, code review)\n\nO Copilot descobre skills por diretório. Copie a skill para o repositório onde vai trabalhar:\n\n```bash\nmkdir -p .agents/skills\ncp -R /caminho/para/equipping-stack-docs/skills/equipping-stack-docs .agents/skills/\n```\n\nOu para o diretório pessoal, valendo em todos os projetos: `~/.copilot/skills/`.\n\n### Codex (app e CLI)\n\nO repositório traz `.codex-plugin/plugin.json` com a skill declarada. O plugin não está publicado no\nmarketplace oficial do Codex — instale a partir do repositório clonado, ou copie a skill:\n\n```bash\nmkdir -p ~/.agents/skills\ncp -R /caminho/para/equipping-stack-docs/skills/equipping-stack-docs ~/.agents/skills/\n```\n\nNo Codex a skill é acionada por `$equipping-stack-docs` ou pela descrição dela.\n\n### Cursor\n\n**Testado com o Cursor Agent 2026.08.11.** O Cursor lê o mesmo `marketplace.json` do Claude Code,\nmas exige a URL completa — o atalho `owner/repo` é recusado com `Invalid URL format`.\n\n```bash\ncursor-agent login\ncursor-agent plugin marketplace add github.com/Framework-System/frwk-plugins\n```\n\nO registro vale para a conta e o Cursor já clona os repositórios no ato. A ativação de cada plugin\né feita no app: o CLI só tem `plugin marketplace`.\n\n\n### Factory Droid\n\n- Registre o marketplace:\n\n  ```bash\n  droid plugin marketplace add https://github.com/Framework-System/frwk-plugins\n  ```\n\n- Instale o plugin:\n\n  ```bash\n  droid plugin install equipping-stack-docs@frwk-plugins\n  ```\n\n### Gemini CLI\n\n- Instale a extensão:\n\n  ```bash\n  gemini extensions install https://github.com/Framework-System/equipping-stack-docs\n  ```\n\n- Atualize depois:\n\n  ```bash\n  gemini extensions update equipping-stack-docs\n  ```\n\nA extensão injeta o `GEMINI.md`, que inclui o conteúdo da skill no contexto da sessão.\n\n### Kimi Code\n\nO manifesto `.kimi-plugin/plugin.json` declara a skill.\n\n```text\n/plugins install https://github.com/Framework-System/equipping-stack-docs\n```\n\n### Antigravity\n\n```bash\nagy plugin install https://github.com/Framework-System/equipping-stack-docs\n```\n\n### OpenCode\n\nO OpenCode descobre skills por diretório. **Testado com o OpenCode 1.18.21.** Clone o repositório e\ndeclare o caminho no `opencode.json` do seu projeto — note que `skills` é um **objeto com `paths`**,\nnão uma lista:\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"skills\": { \"paths\": [\"/caminho/para/equipping-stack-docs/skills\"] }\n}\n```\n\nConfira com `opencode debug skill`. O OpenCode não recarrega config a quente: reinicie depois de editar.\n\n\n### pi\n\n```bash\npi install git:github.com/Framework-System/equipping-stack-docs\n```\n\n### Qualquer outro agente com suporte a Agent Skills\n\nA skill segue o formato aberto [Agent Skills](https://agentskills.io). Copie\n`skills/equipping-stack-docs/` para o diretório de skills do seu agente — os caminhos mais comuns são\n`.agents/skills/` (no repositório) e `~/.agents/skills/` (pessoal).\n\nSem descoberta automática de skills, cole o conteúdo de\n[`skills/equipping-stack-docs/SKILL.md`](skills/equipping-stack-docs/SKILL.md) no contexto do agente\n(`AGENTS.md`, arquivo de instruções do projeto, system prompt) e peça: *\"siga a skill equipping-stack-docs\"*.\n\n## O que funciona em cada agente\n\nTestado de verdade com o GitHub Copilot CLI 1.0.80 e com o validador de referência da spec\n(`skills-ref`), não inferido da documentação.\n\n| Recurso | Claude Code | Copilot CLI | Demais agentes |\n|---|---|---|---|\n| Skill (`SKILL.md`) | sim | sim | sim |\n| Scripts, templates e referências | sim | sim | sim |\n| Comandos (`commands/`) | sim, como `/equipping-stack-docs:<cmd>` | sim, viram skills soltas | não |\n| Subagentes em paralelo | — | — | — |\n| Hooks de ciclo de vida | — | — | — |\n\nO padrão aberto [Agent Skills](https://agentskills.io) cobre `SKILL.md` + `scripts/` +\n`references/` + `assets/`. O Copilot CLI vai além e também importa `commands/` — mas **num espaço\nde nomes plano, sem o prefixo do plugin**.\n\nEste plugin não tem comandos de barra: ele é só a skill. Em qualquer agente, incluindo o Claude\nCode, o acionamento é o mesmo — descreva o que quer e o agente carrega a skill pela descrição dela.\n\n## Como funciona\n\n1. **Descobre a stack** em cascata: design aprovado → manifestos (`package.json`, `pom.xml`, `go.mod`...) → inferência do código (imports, jars, `web.xml`, script tags — versão marcada como aproximada).\n2. **Confirma com você** a lista (tecnologia, versão real do projeto, fonte) antes de gastar qualquer chamada.\n3. **Despacha um subagente por tecnologia**, cada um consultando a API anônima do Context7 e destilando uma skill de ~150 linhas em `.claude/skills/<tech>-<major>-docs/` do seu projeto.\n4. **Versões antigas**: escada de resolução (versão exata → vizinha de mesmo major → docs latest em modo delta). Anotações `[not in 2.x]` só entram com evidência nas próprias docs baixadas (guias de migração, notas \"since v\") — nunca da memória de treino. Distância grande demais → variante query-only honesta (`version-gap`).\n5. As skills geradas são versionadas no git do seu projeto e disparam automaticamente quando qualquer agente futuro tocar código daquela stack.\n\nFalha do Context7 nunca bloqueia seu fluxo — degradação é sempre para variantes honestas, nunca para silêncio ou docs enganosas.\n\n## Quando dispara\n\n- **Com design/spec aprovado**: após o refinamento do design, antes do plano de implementação — o plano já nasce referenciando as doc skills geradas.\n- **Autônomo em codebase existente**: ao começar trabalho substancial (feature, mudança multi-arquivo) num projeto cuja stack não tem doc skills locais. Hotfix trivial não interrompe — guarda anti-ruído explícita.\n\n\n## Uso como skill avulsa (qualquer agente)\n\nNão precisa de sistema de plugins. A skill é um único arquivo Markdown auto-suficiente — o template do subagente, a escada de versão e o tratamento de erros estão todos embutidos nele:\n\n```bash\ngit clone https://github.com/Framework-System/equipping-stack-docs.git\n# skill só deste projeto:\ncp -r equipping-stack-docs/skills/equipping-stack-docs SEU_PROJETO/.claude/skills/\n# ou pessoal, para todos os projetos (Claude Code):\ncp -r equipping-stack-docs/skills/equipping-stack-docs ~/.claude/skills/\n```\n\nEm harnesses sem descoberta automática de skills, cole o conteúdo de [`skills/equipping-stack-docs/SKILL.md`](skills/equipping-stack-docs/SKILL.md) no contexto do agente (arquivo de instruções do projeto, `AGENTS.md`, system prompt) e peça: *\"siga a skill equipping-stack-docs\"*. Requisitos mínimos do ambiente: executar `curl`, criar arquivos e — idealmente — despachar subagentes; sem subagentes, o próprio agente executa o template de geração para uma tecnologia por vez.\n\n## Compatibilidade e requisitos\n\n- **Context7**: acesso anônimo, sem cadastro e sem API key — decisão de design. O rate limit anônimo é baixo; a skill economiza chamadas (confirmação antes de gerar, reaproveitamento de skills existentes, backoff em 429).\n- **Fluxos de planejamento**: se o ambiente tiver uma skill de planos de implementação (ex.: writing-plans), o passo final a invoca informando quais doc skills existem; sem ela, o plugin reporta as skills geradas e devolve o controle. Funciona sozinho.\n- **Testado de ponta a ponta** contra a API real do Context7 nos cenários: stack nova com versão exata, legado com versão vizinha (Spring Boot 2.1), legado sem manifesto (inferência de Struts por `web.xml`/jar), e AngularJS 1.x (resolução do repo arquivado correto, sem vazamento de Angular moderno).\n",
  "bytes": 9390,
  "sha": "2e4568fdb83e548cecf12319ae207cee46cae051eb54232d634bb66c4252d75f",
  "repo_slug": "framework-system/equipping-stack-docs",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_framework_system_equipping_stack_docs_8ec12424/readme"
}