Summary: The repo's three most-read launch files (README, CONTRIBUTING, CHANGELOG) have accuracy gaps that make ADE look half-maintained and dead-end a first-time contributor.
CHANGELOG staleness:
README launch accuracy:
CONTRIBUTING dev setup broken:
Verification confidence: High — git tag | sort -V confirms v1.1.12; CHANGELOG head/link-ref and README links read directly; Droid traced to registry/UI; Windows traced to required-asset gates; dev.cjs confirmed not to launch the runtime. Jargon item is medium (subjective branding).
Summary: The repo's three most-read launch files (README, CONTRIBUTING, CHANGELOG) have accuracy gaps that make ADE look half-maintained and dead-end a first-time contributor.
CHANGELOG staleness:
## [1.0.16] - 2026-04-11(CHANGELOG.md:10) while latest tag is v1.1.12; missing 1.0.17-1.0.19 + the whole 1.1.x series (all exist as tags +/changelog/v1.1.x.mdx). The## [1.0.16]heading has no matching compare link (link-ref block:131-134defines only 1.0.13/1.0.2/1.0.1/1.0.0). Fix: regenerate through v1.1.12; rebuild the link-ref block so every heading has a compare link.README.md:19(badge) and:228(footer) hardcode.../docs/changelog/v1.1.0. Fix: point both at a stable changelog index/latest. Add a CI guard that fails when the top CHANGELOG version (and README link) lags the latest git tag. (Correctade-app.devdomain here — version-pinning drift, not the ADE-43 domain bug.)README launch accuracy:
README.md:36,:58-59market only 'Claude Code, Codex, Cursor, opencode' yet Factory Droid is first-class (modelRegistry.ts:97;ProvidersSection.tsx:74-77,:847-862; 161 source files). Add Droid; ideally generate the list.README.md:9,:106-110are macOS-only, yetrelease-core.ymlhas abuild-win-releasejob (:178) and publish HARD-REQUIRES Windows assets (:439,:441). Add a Windows subsection / update the subtitle (or label experimental).README.md:36'lane-scoped' and:45alt="Parallel worktrees"referencinglanes.png; public site uses 'Worktrees'. Replace user-facing 'lane' with 'worktree' in the top prose; keep literalade lanes …commands.CONTRIBUTING dev setup broken:
CONTRIBUTING.md:6-11(cd apps/desktop→npm install→npm run dev) starts no ADE runtime —dev.cjs:301-303only spawns Vite+tsup+Electron, neverade serve/ADE_DEV_RUNTIME_SOCKET_PATH/buildsapps/ade-cli. Fix: document the root flownpm run setupthen rootnpm run dev(perREADME.md:131,143-157,apps/desktop/README.md:8); drop the stalecd apps/desktopinstructions.Verification confidence: High —
git tag | sort -Vconfirms v1.1.12; CHANGELOG head/link-ref and README links read directly; Droid traced to registry/UI; Windows traced to required-asset gates;dev.cjsconfirmed not to launch the runtime. Jargon item is medium (subjective branding).