# Project Discovery

> Perform deep repository and software project discovery before implementation.

- Skill: `roadofriot/project-discovery` (Agent Skill)
- Install (CLI): `npx skillmds@latest add roadofriot/project-discovery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/roadofriot/project-discovery/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: roadofriot (https://skillmd.com/u/roadofriot)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/roadofriot/project-discovery

---


# PROJECT DISCOVERY SKILL

## Objective

Build a reliable mental model of an unfamiliar project.

## Inspect

Repository:

- directories
- source
- tests
- docs
- configuration
- scripts
- package manifests
- lock files

Technology:

- language
- framework
- runtime
- package manager
- build system

Application:

- entry points
- routing
- state
- services
- database
- APIs
- authentication
- authorization

Operations:

- run
- build
- test
- lint
- format
- deploy
- CI/CD

## Git

Run:

git status

Inspect history when useful.

## Output

Create:

docs/PROJECT_ANALYSIS.md

Include:

Executive Summary
Product Purpose
Current Functionality
Technology Stack
Repository Structure
Architecture
Data Flow
Authentication
APIs
UI/UX
Testing
Performance
Security
Strengths
Weaknesses
Technical Debt
Missing Features
Risks
Unknowns
Recommendations

## Rule

Discovery does not automatically mean implementation.

Report before modifying substantial code unless explicitly instructed otherwise.