A new contributor had nothing to start from: the README covers using
CodeGraph, and the build and test rules live in AGENTS.md, written for
agents. CONTRIBUTING.md now covers building from source, testing a change,
preparing a pull request and what happens to it. docs/README.md indexes the
guides and design notes, and the README links to both.
Every relative link and heading anchor was checked against main.
Reimplements PR 1931 by @mixxer. Also folds in the fork-and-upstream setup,
`npm run cli`, `npm run test:watch` and the version rule from PR 306 by
@marcelovani, and the commit format, the single-test command, the bug-report
list and the `/add-lang` pointer from PR 665 by @ymstar.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
