Skill: document-multiple-repository

---

name: document-multiple-repository

description: 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.

version: 0.1.0

---

# Skill: document-multiple-repository

Propósito

Gerar documentação técnica consolidada para sistemas de software compostos por múltiplos repositórios

(frontend, backend, microservices, infra, docs, wikis) armazenados localmente em um sistema de arquivos compartilhado.

Premissas

Entradas (Inputs)

Etapas de Processamento

1. Descoberta de Sistemas (Discover Systems)

2. Análise de Repositórios (Analyze Repositories)

Para cada repositório:

- Detectar linguagem e framework (Spring, Django, Node, etc).

- Detectar o tipo de serviço (backend, frontend, microservice, infra).

- Extrair: README, build files, manifests, API routes, entities, configs.

- Detectar páginas principais (Home.md, index.md).

- Extrair: guias de infraestrutura, tutoriais de setup, processos de negócio (DoR/DoD) e links para legislação externa ou ativos.

- Detectar geradores estáticos (MkDocs, Sphinx, etc).

- Extrair: manuais funcionais e guias de usuário.

3. Geração de Documentação (Generate Documentation)

Criar para cada sistema:

Criar para cada repositório:

4. Estrutura de Saída (Output Structure)

OUTPUT_PATH/

system-name/

SYSTEM_OVERVIEW.md

ARCHITECTURE.md

REPOSITORY_MAP.md

DEPLOYMENT.md

PROCESSES_AND_GUIDELINES.md

repos/

repo-name/

README.generated.md

API.generated.md

CODE_STRUCTURE.md

WIKI_SUMMARY.md

Execução

O agente recebe o comando:

"Run skill document-multiple-repository on <ROOT_PATH>"

Restrições (Constraints)