Skip to main content
skill CX Codex

project-discovery — Claude Code skill: codebase map and stack

project-discovery is a Claude Code skill that maps a codebase’s structure, tech stack, entry points, and documentation mismatches against actual code.

MIT ★ 587 updated 2026-10-26

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startup
Open on GitHub

What project-discovery does

project-discovery reads manifests, configs, and file layout to identify architecture, frameworks, package managers, and key modules. It verifies claims from README and specs against real code and highlights discrepancies.

The skill uses search patterns from reference/search-patterns.md and reference/framework-signatures.md to detect frameworks through multiple signals at once: dependencies plus config plus file structure. The final report lists technologies, conventions, verified and outdated documentation parts.

It skips node_modules and vendor unless explicitly asked. Returns confidence level for findings and suggests what to inspect next.

What it helps with

  • map an unfamiliar codebase during onboarding
  • locate entry points and key modules in a project
  • identify frameworks and tools from configs and dependencies
  • verify documentation against actual implementation
  • flag outdated or conflicting README sections

Example prompts for the agent

  • Build a map of the project: architecture, stack, entry points
  • Check if the README matches the actual code structure
  • Find frameworks and package managers in this repo

How to install project-discovery

1Plugin marketplace

/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startup

This installs the whole team plugin with all its skills

2Skills CLI (Vercel)

npx skills add rsmdt/the-startup --skill project-discovery -a claude-code

3Manually: put the files in place

~/.claude/skills/project-discovery/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/project-discovery/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about project-discovery

How to install project-discovery in Claude Code?

Run /plugin marketplace add rsmdt/the-startup, then /plugin install team@the-startup.

What does project-discovery do?

The skill analyzes project structure, detects the tech stack, and cross-checks documentation against real code. It outputs a report with architecture, frameworks, entry points, and documentation mismatches.

How does project-discovery identify frameworks?

It checks dependencies in manifests, presence of configs, and file layout simultaneously, not relying on a single indicator. The reference/framework-signatures.md reference holds detection signatures.

Source text

SKILL.md · MIT
---
name: project-discovery
description: Unified codebase discovery across structure navigation, tech-stack detection, and documentation extraction. Use when onboarding to a project, locating implementation paths, identifying frameworks/tooling, or validating docs against code reality.
---

## Persona

Act as a project discovery specialist that builds a fast, reliable map of a codebase: structure, stack, and documentation truth.

**Discovery Target**: $ARGUMENTS

## Interface

ProjectDiscoveryReport {
  architecture: string
  techStack: string[]
  packageManagers: string[]
  keyEntryPoints: string[]
  criticalDocs: string[]
  docMismatches: string[]
  conventions: string[]
  confidence: HIGH | MEDIUM | LOW
}

State {
  target = $ARGUMENTS
  files = []
  docs = []
  findings = []
}

## Constraints

**Always:**
- Start with repo/documentation overview, then narrow to target scope.
- Verify framework detection using multiple signals (manifest + config + structure).
- Cross-check critical documentation claims against implementation.
- Prefer narrow searches in relevant directories after initial mapping.

**Never:**
- Assume stack or architecture from a single indicator.
- Treat docs as authoritative without verification for high-impact claims.
- Scan dependency/vendor directories unless explicitly required.

## Reference Materials

- `reference/search-patterns.md` — Glob/Grep patterns for structure analysis, implementation tracing, and architecture mapping
- `reference/framework-signatures.md` — Detection signatures for frontend, backend, build, CSS, DB, testing, API, monorepo, mobile, and deployment frameworks
- `reference/error-handling-patterns.md` — Error classification, handling patterns, and logging level guidance

## Workflow

### 1. Map Structure
- Identify top-level modules, entry points, and test locations.
- Identify config/manifests for language/tooling.

### 2. Detect Stack
- Detect ecosystems/package managers from lock/manifests.
- Detect frameworks/build/test tooling from dependency + config + file layout.

### 3. Extract and Verify Docs
- Read README/spec/config docs relevant to target.
- Flag outdated, conflicting, or missing documentation.

### 4. Build Discovery Report
- Summarize architecture, stack, conventions, and verified/mismatched doc claims.
- Highlight unknowns and next best inspection steps.

© Rudolf S. · MIT · rsmdt/the-startup

Similar skills

All skills for Agent setup: memory, context, orchestration →
bmad-document-project aj-geddes The bmad-document-project Claude Code skill scans an existing codebase in read-only mode to generate project-documentation.md. It maps runtime dependencies and entry points before downstream planning. CX Codex +1 104installs code-documentation-docs-architect Seth Hobson The code-documentation-docs-architect subagent for Claude Code, Codex, and Cursor analyzes a codebase and produces long-form technical documentation, from architecture decisions to security. CX Codex ★ 42,780repo stars project-creator itechmeat project-creator scaffolds structured technical documentation in a .project/ directory and guides you through specs, architecture, and user stories. CX Codex +1 113installs project-workflow-analysis-blueprint-generator official github project-workflow-analysis-blueprint-generator — a GitHub Copilot skill that maps project architecture and documents end-to-end workflows. Use it when you need implementation blueprints for similar features. CX Codex +1 9,366installs project-docs jezweb project-docs scans your codebase to generate or refresh ARCHITECTURE.md, API_ENDPOINTS.md, and DATABASE_SCHEMA.md. It helps when onboarding new contributors or updating stale project documentation. CX Codex +1 1,300installs project-documenter official Awesome Copilot Community project-documenter — a GitHub Copilot plugin that generates project documentation with draw.io diagrams and a Word file. Scans the repo, builds C4 architecture diagrams, and assembles a .docx with embedded PNG images. ★ 41,430repo stars

From the same set50

The whole set →
frontend-patterns The frontend-patterns skill gives Claude Code task-specific guidance for React UI work with shadcn/ui and Tailwind CSS. Use it for component choices, theming, forms, and accessibility. CX Codex +1 ★ 587repo stars agentic-patterns agentic-patterns fetches current LangChain, Vercel AI SDK and assistant-ui docs, then turns them into guidance for the agent, chat UI, RAG or tool-calling task you name. CX Codex +1 ★ 587repo stars code-quality-review code-quality-review evaluates code across eight dimensions, prioritizing correctness and security risks over cosmetic formatting. CX Codex +1 ★ 587repo stars domain-modeling The domain-modeling skill turns business rules into domain models, aggregate boundaries, and storage decisions. Use it when shaping a business model or changing schema consistency rules. CX Codex +1 ★ 587repo stars user-research Plans user research studies, analyzes usability tests and customer interviews, and turns findings into prioritized product recommendations. CX Codex +1 ★ 587repo stars constitution This skill examines a codebase and drafts a project constitution grounded in its existing patterns. Use it to establish or revise governance rules with file-and-line evidence. CX Codex +1 ★ 587repo stars research-user research-user — a subagent for planning and conducting user research. Surfaces genuine user motivations and pain points before building features, when conversion drops, or when your team disagrees on what users actually need. CX Codex ★ 587repo stars design-visual design-visual — a design-systems subagent for Claude Code that establishes design tokens, component standards, and WCAG 2.1 AA accessibility foundations. CX Codex ★ 587repo stars

Project sponsors

Companies that keep this analytics open