roadofriot 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.