project-scanner

Project Scanner

Static reference for project introspection: file markers, import signals, and bash snippets that identify a repo's languages, frameworks, database, infrastructure, structure, components, and scale. Read the tables and apply them to the project in front of you — this file holds no per-project data.

Use when

• You need to identify an unfamiliar project's stack, structure, or scale from its files alone.
• Building a project summary (languages, frameworks, DB, infra, components, auth, CI/CD) before deeper work.

Do not use when

• The project is already described in CLAUDE.md / AGENTS.md — read that first; only re-detect what it omits.
• You already know the one fact you need from a file you have read (e.g. framework stated in package.json).

Hard Rules

1. Detect from files actually present — read or grep the marker; never infer a stack from the project's name.
2. Report EVERY detected language, not just the first — polyglot repos are common.
3. Multiple structure matches → choose the most specific (see Tie-breaks) and name the signals that fired.
4. No marker matches a category → report UNKNOWN for it. Never guess a value.

Scan procedure

1. Languages — match file markers (Languages table); read each hit's version source. Report all matches.
2. Frameworks — for each detected language, grep dependencies against the Frameworks table.
3. Database & infrastructure — check docker-compose, .env, and schema files (Database + Infrastructure tables).
4. Structure — classify the repo against the Structure Patterns table, applying Tie-breaks.
5. Components — scan top-level and second-level directories (Component Detection table).
6. Scale — run the Scale Estimation snippets for approximate counts.

Done when: every category above has a concrete value or UNKNOWN.

Detection Patterns

Languages

File Marker	Language	Version Source
go.mod	Go	First line: go X.Y
package.json + tsconfig.json	TypeScript	package.json → typescript version
package.json (no tsconfig)	JavaScript	package.json → engines.node
pyproject.toml	Python	[project] → requires-python
requirements.txt	Python	None (check python --version)
Cargo.toml	Rust	[package] → edition
pom.xml	Java	<java.version>
build.gradle / build.gradle.kts	Kotlin/Java	sourceCompatibility