mcpField
P
project-discovery

project-discovery

github.com/danieldxdDevelopment036 installsUpdated 7w ago
Repository

About project-discovery

project-discovery is a development skill for mapping a repository before making changes. It asks agents to confirm the actual stack, structure, conventions, and risks from project files, then recommend a proportionate next step.

Key features

  1. 01Identifies project type and entry points
  2. 02Derives stack from manifests and imports
  3. 03Maps architecture and existing conventions
  4. 04Surfaces risks and untested areas
  5. 05Recommends a minimal aligned plan

Use cases

  1. 01Inspect a codebase before editing
  2. 02Assess conventions and risk hotspots
  3. 03Scope work in a monorepo

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/danieldxd/myapp-skills --skill project-discovery

After installing, type/project-discoveryin Claude Code to confirm it loaded.

Details

From the project README

Project Discovery

Antes de editar, mapeie o sistema. Não proponha mudanças estruturais sem evidência no repositório.

Fluxo

  1. Identifique o tipo de projeto: app web, API, mobile, monorepo ou biblioteca.
  2. Localize entrypoints, configs e scripts de build/test/lint.
  3. Extraia a stack real a partir de manifests e imports, não de suposições.
  4. Mapeie pastas de domínio, camadas e limites (UI, API, dados, auth).
  5. Liste padrões existentes: naming, state, erros, testes, CI.
  6. Liste riscos: dívida técnica, arquivos críticos, áreas sem testes.
  7. Só então proponha o menor plano alinhado às convenções encontradas.

O que inspecionar

  • Manifests: package.json, pnpm-workspace.yaml, Cargo.toml, Podfile, Package.swift, .xcodeproj
  • Frameworks: Next.js, Vite, Expo, SwiftUI, Nest, Express, Prisma
  • Rotas e entrypoints: app/, pages/, src/main, App.tsx, ContentView
  • Dados: schemas Prisma/Drizzle, migrations, clients HTTP
  • Auth e middlewares
  • Testes e CI: *.test.*, Playwright, GitHub Actions
  • Variáveis de ambiente e secrets (sem expor valores)

Relatório mínimo

Entregue um resumo curto:

  • Stack e versão aproximada
  • Arquitetura em 3–6 bullets
  • Convenções a respeitar
  • Hotspots de risco
  • Próximo passo recomendado

Regras

  • Prefira evidência de arquivos a memória de padrões genéricos.
  • Se houver conflito entre docs e código, o código vence.
  • Não refatore “de passagem” durante discovery.
  • Preserve o estilo local; não imponha outra arquitetura sem pedido explícito. Se o usuário pedir estrutura: software-architecture.
  • Em monorepos, declare qual pacote/app está no escopo.

Critérios de conclusão

  • Stack e entrypoints confirmados
  • Convenções principais listadas
  • Riscos e dependências críticas identificados
  • Plano de mudança proporcional ao pedido

Comments

Markdown supported