An agent that audits a GitHub repo and writes its CLAUDE.md

Your first day on an unfamiliar codebase goes on the same questions. What is this, how do I run it, what's going to bite me?

An AI coding agent asks those questions every single session, and gets them wrong when nobody wrote the answers down.

Groundwork does that first day in a couple of minutes. Point it at a GitHub repo and you get a plain-English technical audit and a ready-to-commit CLAUDE.md.

Try it: groundwork-audit-iy.web.app

An agent, not a summariser

It doesn't dump the repo into a prompt. The model plans, then calls two tools against the GitHub API:

• list_tree to see the file tree, with lockfiles, binaries and build output filtered out
• read_file to open the files that actually matter: manifests, entry points, CI

It works within a step and file budget, and the only way out is finish, which has to return both documents. No half-finished audits.

Two providers, one prompt

One prompt and one tool schema drive both Anthropic and Google Gemini. You pick the provider and paste your own API key. Keys stay in your browser and only go to that provider.

If you'd rather use the terminal, there's a Claude Code CLI that runs the same audit on a local checkout with no API key.

Stack

• React 19, Vite and TypeScript on Firebase Hosting
• The official Anthropic SDK in browser mode, with strict tool schemas and a cached system prompt
• Gemini through REST function calling

Why I made it

Write down the first day on a codebase once, so no one, human or agent, has to rediscover it.

Full write-up: ibraryunus.com/work/groundwork