# Repo-Docs

A documentation system for AI-agent-built repositories that keeps walkthroughs, concept pages, evidence pages and sync rules updated alongside the code as agents change it.

Repo-Docs is a project-documentation tool built for repositories where AI coding agents write much of the code. It turns each real development run into walkthroughs, concept pages and reference material that live beside the source, instead of leaving the reasoning behind a change stranded in chat history.

Its loop checks understanding after every user request or agent change, then conservatively updates only the README, walkthroughs, change log, modules, glossary, references and agent instruction files, such as AGENTS.md or CLAUDE.md, that would otherwise mislead the next reader. It produces artifacts such as a one-real-run walkthrough that follows a single behavior from entry to output through the current source.

Website: https://yurunchen.github.io/repo-docs-skills/