<div align="center">
<img src="site/assets/logo.png" width="86" alt="Repo-Docs logo" />
<h1>Repo-Docs: Keep up with the code your agents write.</h1>
<p><strong>An evidence atlas for agent-built code.</strong></p>
<p>
Vibe coding makes code move faster than memory. Repo-Docs turns each real
run into walkthroughs, concepts, references, and sync rules that live beside
the source.
</p>
<p>
<a href="http://xhslink.com/o/9M27ebWDaD3">
<img alt="RedNote(小红书)" src="https://img.shields.io/badge/RedNote(%E5%B0%8F%E7%BA%A2%E4%B9%A6)-Post-ff2442?style=for-the-badge&labelColor=555" />
</a>
<a href="https://yurunchen.github.io/repo-docs-skills/">
<img alt="Project homepage" src="https://img.shields.io/badge/Project%20Page-Online-27a36f?style=for-the-badge&labelColor=555" />
</a>
</p>
</div>
<p align="center">
<a href="README_CN.md">Chinese README</a> |
<a href="skills/repo-docs/SKILL.md">Skill contract</a> |
<a href="https://yurunchen.github.io/repo-docs-skills/">Project homepage</a> |
<a href="#install-in-30-seconds">Install</a>
</p>
<p align="center">
<a href="#why-this-exists-now"><strong>Why now</strong></a> |
<a href="#the-repo-docs-loop"><strong>The loop</strong></a> |
<a href="#what-it-builds"><strong>Artifacts</strong></a> |
<a href="#quality-bar"><strong>Quality bar</strong></a>
</p>
<p align="center">
<img
src="site/assets/main.png"
alt="Repo-Docs main preview"
width="900"
/>
</p>
<p align="center">
<em>Understand the repo before you memorize paths.</em>
</p>
The Problem
<table>
<tr>
<td width="50%" valign="top">
<h3>Agent-built repos often feel like this</h3>
<ul>
<li>Code changed quickly, but the reason stayed in chat.</li>
<li>Files exist, yet no one can explain the real behavior path.</li>
<li>README, source, tests, and agent memory drift apart.</li>
<li>The next agent starts by rediscovering the same context