The latest articles on DEV Community by Ibrar Yunus (@ibraryunus). https://dev.to/ibraryunus https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4170503%2F29ad3e47-4358-4996-ad4b-4896eab02606.jpg https://dev.to/ibraryunus en Ibrar Yunus Wed, 14 Oct 2026 11:57:14 +0000 https://dev.to/ibraryunus/an-agent-that-audits-a-github-repo-and-writes-its-claudemd-2pbp https://dev.to/ibraryunus/an-agent-that-audits-a-github-repo-and-writes-its-claudemd-2pbp <p>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?</p> <p>An AI coding agent asks those questions every single session, and gets them wrong when nobody wrote the answers down.</p> <p>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.</p> <p>Try it: <a href="https://groundwork-audit-iy.web.app" rel="noopener noreferrer">groundwork-audit-iy.web.app</a></p> <h2> An agent, not a summariser </h2> <p>It doesn't dump the repo into a prompt. The model plans, then calls two tools against the GitHub API:</p> <ul> <li> <code>list_tree</code> to see the file tree, with lockfiles, binaries and build output filtered out</li> <li> <code>read_file</code> to open the files that actually matter: manifests, entry points, CI</li> </ul> <p>It works within a step and file budget, and the only way out is <code>finish</code>, which has to return both documents. No half-finished audits.</p> <h2> Two providers, one prompt </h2> <p>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.</p> <p>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.</p> <h2> Stack </h2> <ul> <li>React 19, Vite and TypeScript on Firebase Hosting</li> <li>The official Anthropic SDK in browser mode, with strict tool schemas and a cached system prompt</li> <li>Gemini through REST function calling</li> </ul> <h2> Why I made it </h2> <p>Write down the first day on a codebase once, so no one, human or agent, has to rediscover it.</p> <p>Full write-up: <a href="https://ibraryunus.com/work/groundwork/" rel="noopener noreferrer">ibraryunus.com/work/groundwork</a></p> ai agents claude github