{"skill":{"slug":"document-multiple-repository","displayName":"Document Multiple Repository","summary":"Gera documentação técnica consolidada para sistemas de software com múltiplos repositórios (frontend, backend, microservices, wikis). Use quando o usuário pedir documentação de multi-repo, visão de arquitetura consolidada, mapeamento de repositórios ou documentação a partir de vários repos locais.","description":"---\nname: document-multiple-repository\ndescription: Gera documentação técnica consolidada para sistemas de software com múltiplos repositórios (frontend, backend, microservices, wikis). Use quando o usuário pedir documentação de multi-repo, visão de arquitetura consolidada, mapeamento de repositórios ou documentação a partir de vários repos locais.\nversion: 0.1.0\n---\n\n# Skill: document-multiple-repository\n\n## Propósito\nGerar documentação técnica consolidada para sistemas de software compostos por múltiplos repositórios\n(frontend, backend, microservices, infra, docs, wikis) armazenados localmente em um sistema de arquivos compartilhado.\n\n## Premissas\n- Todos os repositórios (incluindo Wikis) já estão clonados localmente.\n- Múltiplos repositórios podem compor um único sistema lógico.\n- Wikis são tipicamente repositórios git com o sufixo `.wiki`.\n- As linguagens podem incluir Java, Python, JavaScript.\n- Não existem convenções rígidas de nomenclatura.\n- A execução é manual via agente de IA (VS Code, Copilot, Gemini CLI, etc).\n\n## Entradas (Inputs)\n- ROOT_PATH: pasta contendo múltiplos sistemas.\n- OUTPUT_PATH: destino para a documentação gerada.\n- TEMPLATES_PATH: templates para README, ARCHITECTURE, API, CODE_COMMENTS.\n\n## Etapas de Processamento\n\n### 1. Descoberta de Sistemas (Discover Systems)\n- Escanear ROOT_PATH recursivamente.\n- Detectar repositórios git (pastas .git).\n- Identificar repositórios de Wiki (nome da pasta termina com `.wiki`).\n- Agrupar (cluster) repositórios por proximidade no sistema de arquivos.\n- Tratar cada grupo (código + wikis) como um único sistema lógico.\n\n### 2. Análise de Repositórios (Analyze Repositories)\nPara cada repositório:\n- Detectar o tipo (code, docs ou wiki).\n- Se for Code (Código):\n  - Detectar linguagem e framework (Spring, Django, Node, etc).\n  - Detectar o tipo de serviço (backend, frontend, microservice, infra).\n  - Extrair: README, build files, manifests, API routes, entities, configs.\n- Se for Wiki:\n  - Detectar páginas principais (Home.md, index.md).\n  - Extrair: guias de infraestrutura, tutoriais de setup, processos de negócio (DoR/DoD) e links para legislação externa ou ativos.\n- Se for Docs:\n  - Detectar geradores estáticos (MkDocs, Sphinx, etc).\n  - Extrair: manuais funcionais e guias de usuário.\n\n### 3. Geração de Documentação (Generate Documentation)\nCriar para cada sistema:\n- SYSTEM_OVERVIEW.md (Visão consolidada incluindo negócio e tecnologia).\n- ARCHITECTURE.md.\n- REPOSITORY_MAP.md.\n- DEPLOYMENT.md (Informações mescladas de manifests de código e guias de wiki).\n- PROCESSES_AND_GUIDELINES.md (Extraído de Wikis: DoR, DoD, regras de contribuição).\n\nCriar para cada repositório:\n- README.generated.md.\n- API.generated.md.\n- CODE_STRUCTURE.md (para repositórios de código).\n- WIKI_SUMMARY.md (para repositórios de wiki).\n\n### 4. Estrutura de Saída (Output Structure)\nOUTPUT_PATH/\n  system-name/\n    SYSTEM_OVERVIEW.md\n    ARCHITECTURE.md\n    REPOSITORY_MAP.md\n    DEPLOYMENT.md\n    PROCESSES_AND_GUIDELINES.md\n    repos/\n       repo-name/\n         README.generated.md\n         API.generated.md\n         CODE_STRUCTURE.md\n         WIKI_SUMMARY.md\n\n## Execução\nO agente recebe o comando:\n\"Run skill document-multiple-repository on <ROOT_PATH>\"\n\n## Restrições (Constraints)\n- Não executar código.\n- Não modificar os repositórios originais.\n- Apenas documentação.","tags":{"latest":"0.1.0"},"stats":{"comments":0,"downloads":1421,"installsAllTime":0,"installsCurrent":0,"stars":1,"versions":1},"createdAt":1770857191445,"updatedAt":1778487906275},"latestVersion":{"version":"0.1.0","createdAt":1770857191445,"changelog":"Initial release: generate consolidated technical documentation for multi-repository systems.\n\n- Detects and clusters local git repositories (including wikis) into logical systems.\n- Analyzes each repository to extract language, structure, API routes, manifests, and key documentation.\n- Generates comprehensive documentation: overviews, architecture, deployment, repo maps, and process guidelines per system and repository.\n- Outputs structured documentation folders without modifying source repositories.\n- Supports Java, Python, JavaScript; recognizes backend, frontend, microservices, infra, docs, and wikis.","license":null},"metadata":null,"owner":{"handle":"dannyxyz22","userId":"s17arzgw4f6zdxp4209sj5gs018676pd","displayName":"Daniel Lélis Baggio","image":"https://avatars.githubusercontent.com/u/56499?v=4"},"moderation":null}