Back to articles
I Made a Command That Documents My Entire Repo Every Time I Take a Break
How-ToTools

I Made a Command That Documents My Entire Repo Every Time I Take a Break

via Dev.toAmit Raz

I work with AI coding agents every day. Cursor, Claude Code, sometimes both in the same project. And the thing that used to slow me down the most wasn't writing code. It was re-orienting the agent at the start of every session. "Here's the folder structure." "We use Provider for state." "Don't put new screens in the root of lib." "Android alarm testing needs a real device." Over and over. Every session. So I built a fix. I call it /document-project, and the prompt file is here if you want to skip straight to it: https://gist.github.com/razamit/b28d7d8b0acaf995969673df47333d58 What it actually is It's a markdown prompt file I keep in my projects. When I type the command in Cursor or Claude Code, the agent reads the file, walks the entire repo, and produces or updates two things: AGENTS.md at the root — a machine-oriented map with build commands, tech stack, layout, conventions, and known footguns Folder-level README.md files — short, only where they add navigation value The file tells t

Continue reading on Dev.to

Opens in a new tab

Read Full Article
5 views

Related Articles