project-discovery — скилл для Claude Code: карта кодбейса
Скилл project-discovery строит карту проекта: структуру, стек, точки входа и несоответствия документации коду.
MIT ★ 587 обновлён 2026-10-26
/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startupЧто делает project-discovery
project-discovery читает манифесты, конфиги и файловую структуру, чтобы определить архитектуру, фреймворки, менеджеры пакетов и ключевые модули. Проверяет утверждения из README и спецификаций против реального кода и выделяет расхождения.
Скилл использует паттерны поиска из справочников reference/search-patterns.md и reference/framework-signatures.md для детекции фреймворков по нескольким сигналам одновременно: зависимости плюс конфиг плюс расположение файлов. Итоговый отчёт включает список технологий, соглашений, проверенных и устаревших частей документации.
Не сканирует node_modules и vendor без явного запроса.
Какие задачи решает
- построить карту незнакомого проекта при онбординге
- найти точки входа и ключевые модули кодбейза
- определить фреймворки и инструменты по конфигам и зависимостям
- проверить документацию против реального кода
- выявить устаревшие или противоречащие друг другу части README
Примеры запросов агенту
- Построй карту проекта: архитектура, стек, точки входа
- Проверь, соответствует ли README реальной структуре кода
- Найди фреймворки и менеджеры пакетов в этом репозитории
Как установить project-discovery
1Через маркетплейс плагинов
/plugin marketplace add rsmdt/the-startup/plugin install team@the-startupКоманда ставит плагин team целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill project-discovery -a claude-code3Вручную: положить файлы
~/.claude/skills/project-discovery/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/project-discovery/
1Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill project-discovery -a codex2Вручную: положить файлы
.agents/skills/project-discovery/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill project-discovery -a cursor2Вручную: положить файлы
.cursor/skills/project-discovery/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rsmdt/the-startup plugins/team/skills/cross-cutting/project-discovery2Вручную: положить файлы
.github/skills/project-discovery/SKILL.md1Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill project-discovery -a gemini-cli2Командой платформы
gemini skills install https://github.com/rsmdt/the-startup --path plugins/team/skills/cross-cutting/project-discoveryВручную: положить файлы
.devin/skills/project-discovery/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о project-discovery
Как установить project-discovery в Claude Code?
Выполни /plugin marketplace add rsmdt/the-startup, затем /plugin install team@the-startup.
Что делает project-discovery?
Скилл анализирует структуру проекта, детектирует технологический стек и сверяет документацию с реальным кодом. Выдаёт отчёт с архитектурой, фреймворками, точками входа и расхождениями в документации.
Как project-discovery определяет фреймворки?
Скилл проверяет зависимости в манифестах, наличие конфигов и расположение файлов одновременно, а не полагается на один индикатор. Справочник reference/framework-signatures.md содержит сигнатуры для детекции.
Исходный текст
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