Scanning repository
- ▸Listing the files
- ▸Reading the instructions
- ▸Checking the build tools
- ▸Finding the tests
- ▸Reading the folder layout
- ▸Adding up the score
shadcn-ui/ui
Needs work
200 of 3923 source files inspected. 42 of 42 configs and instructions read. Unmeasured checks are excluded from scores.
No AGENTS.md was found. An agent starting work in this repository has to infer the package manager, the test command, and the layout of 629 directories from the file tree alone.
Create AGENTS.md at the repository root covering:
This project talks to a database but nothing documents how to change the schema. Agents commonly hand-edit generated migration files when this is undocumented.
Add a Database section to AGENTS.md describing:
27 routes were detected with no written convention for request validation, response shape, or error format.
Add an API section to AGENTS.md describing:
154 test files exist but nothing documents how to run just one. Agents run the whole suite for every iteration, which is slow and expensive.
Add the single-test command to AGENTS.md, for example:
No template lists the environment variables this project needs, so an agent cannot tell which ones a feature depends on.
Commit a .env.example that lists every variable with a comment describing it.
The README is 68 words. It is the first file an agent reads.
Cover what the project does, how to run it, and where the main code lives.
Nine in ten files sit 9 levels deep. Deep paths are hard to guess, so agents fall back to listing directories.
Flatten folders that only contain one child folder.