docs(contributing): Project Structure omits major packages (mcp, scan, delegate, llmloop, pathutil, …)
Author: ErebuzzzCreated Sep 18, 2026Updated Sep 18, 2026
Summary
CONTRIBUTING.md "Project Structure" is stale compared to the current internal/ layout on main. New contributors get an incomplete mental model of entrypoints and package ownership.
What CONTRIBUTING currently lists under internal/
agent, config, diff, llm, model, session, tool, telemetry, viewer
Source: https://github.com/alibaba/open-code-review/blob/main/CONTRIBUTING.md
Packages present on main but missing from that tree
delegate, gitcmd, llmloop, mcp, pathutil, release, scan, stdout, suggestdiff
(Verified via public internal/ directory listing on main.)
Proposed fix
- Refresh the Project Structure tree in
CONTRIBUTING.mdto matchmain - Keep short one-line purpose comments for each package
- Sync i18n CONTRIBUTING copies if maintainers want parity (
docs/i18n/CONTRIBUTING.*.md)
AI disclosure
Assisted by passive static analysis tooling; structure checked against public source. I reviewed the evidence myself.
Request
Please assign this issue to me (@Erebuzzz) before I implement so we avoid duplicate work. Happy to open a focused docs/ PR after assignment.
Source: alibaba/open-code-review