From dev-team-kit-fv
Audits repository stack, conventions, assets, tests, docs, risks, and integration points before other skills. Persists reusable markdown summaries to minimize token usage on re-analysis.
npx claudepluginhub felvieira/claude-skills-fvThis skill is limited to using the following tools:
O Repo Auditor cria uma fotografia operacional do repositorio para que o restante do sistema trabalhe com contexto persistido e enxuto.
Coordinates parallel agent audits for codebase health, evaluation (12-pillar scoring), technical debt, and documentation drift, producing intake docs for /pipeline.
Performs first-pass strategic review of repositories, producing evidence-cited maps calibrated to reference classes to guide where to engage, tread carefully, or leave alone. Advisory only.
Audits git repositories for engineering practices with SARIF evidence, 4-level confidence ratings, and OpenSSF scoring to evaluate health and code quality.
Share bugs, ideas, or general feedback.
O Repo Auditor cria uma fotografia operacional do repositorio para que o restante do sistema trabalhe com contexto persistido e enxuto.
Esta skill segue GLOBAL.md, policies/execution.md, policies/persistence.md, policies/token-efficiency.md, policies/handoffs.md, policies/tool-safety.md e policies/evals.md.
Para auditorias mais completas e revisoes incrementais, consultar docs/skill-guides/repo-auditor.md apenas quando necessario.
Asset Librarian quando o inventario visual precisar de organizacao dedicadaPersistir em docs/repo-audit/current.md (indice) e splits dinamicos no mesmo diretorio.
Se o kit estiver instalado em .bot/, persistir em .bot/docs/repo-audit/.
Se houver reauditoria relevante, arquivar snapshots curtos em docs/repo-audit/history/.
Ao auditar, gerar arquivos focados por tipo alem do current.md. Decidir quais gerar baseado no que o repo contem — nao gerar arquivos vazios.
| Arquivo | Gerar quando detectar | Conteudo |
|---|---|---|
current.md | sempre | Indice enxuto: stack, convencoes, riscos, gaps. Aponta para splits: Ver routes.md para endpoints |
routes.md | API routes (Express, Fastify, Next API, Django urls, Flask, etc.) | Endpoints por recurso, metodos HTTP, middlewares, auth |
schema.md | ORM/schema (Prisma, Drizzle, TypeORM, Sequelize, migrations) | Models, campos-chave, relacoes FK, enums |
components.md | Framework de componentes (React, Vue, Svelte, Angular) | Arvore por feature, props, client/server, lazy |
services.md | Camada de servicos/usecases (classes com patterns service/usecase) | Servicos, dependencias, metodos publicos |
infra.md | Docker, CI/CD, Terraform, k8s, serverless | Containers, pipelines, environments, secrets ref |
fn nome(args): tipo, [auth,db] pra tags, (c) pra client componentscurrent.md (docs/repo-audit/ ou .bot/docs/repo-audit/)Para decidir quais splits gerar, verificar:
routes.md: existencia de app.get/post/put/delete, router., @Get/@Post, urlpatterns, api/ dir com handlersschema.md: existencia de schema.prisma, *.entity.ts, models.py, diretorio migrations/components.md: existencia de .tsx/.vue/.svelte em src/components/ ou app/services.md: existencia de *Service.ts, *UseCase.ts, services/ dir, usecases/ dirinfra.md: existencia de Dockerfile, .github/workflows/, terraform/, k8s/, docker-composeUsar templates/audit.md como base e manter secoes curtas, atualizaveis e reutilizaveis.
docs/repo-audit/current.md criado ou atualizado (indice enxuto)routes.md, schema.md, etc.) conforme deteccaoEntregar:
Seguir policies/handoffs.md e, quando util, templates/audit.md.