docs: rewrite README as honest Team Engineering comparison - #23
Merged
Merged
Conversation
Replace SubAgent DAG marketing with what v2 actually ships: a department tree, Discuss/Assign, and the session mount forest. Compare Codex / Claude Code / Cursor without hype, and list verified gaps including LSP and Git. Co-authored-by: Suddenness <wangyuahn@users.noreply.github.com>
wangyuahn
marked this pull request as ready for review
September 12, 2026 15:20
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Please review, Bob. This is a documentation rewrite only: what Nori is now (Team Engineering), how that compares to Codex / Claude Code / Cursor, and what we still lack.
Primary reading:
Related Issue
No GitHub issue. Suddenness asked to rewrite the docs so a comparison with Codex, Claude Code, and similar tools is fair, Team Engineering is described as it exists in code, and unfinished surfaces (especially LSP and Git) are not sold as finished.
Problem
The root README still marketed SubAgent DAG orchestration and treated Team as an add-on.
CHANGELOG.mdv2.0.0-pre.0already removed the temporarySubAgentpath. VitePress landing copy still said SubAgent and Team coexist. Anyone comparing Nori to Codex or Claude Code would get a product that is not in the tree.What changed
README.mdandREADME.zh-CN.mdin Bob's three-part structure: (1) what Nori is now — mount forest + Discuss/Assign, not the deleted SubAgent DAG; (2) comparison vs Codex / Claude Code, with a short Cursor column; (3) honest gaps, including LSP and Git as a rough shell (毛坯房), plus items verified in code (TUI test debt, dual-write hire, Kimi naming leftovers, Map peer/service edges in localStorage only,nori.yamlnot a DAG scheduler, filesystem sandbox planned, docs lag).CHANGELOG.mdv2.0.0-pre.0andpackages/agent-coreTeam/session-mount code. Did not resurrect SubAgent DAG marketing.CHANGELOG.mdso older SubAgent/DAG sections read as historical./subagentrows) or added banners pointing at the README. Did not rewrite the whole site;docs/en/customization/agents.mdis explicitly marked stale.No runtime or test changes. Docs-only: no changeset.
Checklist
gen-changesetsskill, or this PR needs no changeset. (docs-only — no package bump)gen-docsskill, or this PR needs no doc update. (this PR is the doc update)