Address CodeRabbit review feedback

- Split changelog entries into proper Added/Changed sections
- Remove architect from "entirely new" agent list (it's a Plan replacement)
- Fix Node.js version requirement: 16.13+ or 18+, not just 18+
- Replace sudo npm install recommendation with nvm/npm-prefix advice

Author: AnExiledDev

.devcontainer/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## [Unreleased]
 
+### Added
+
+#### Documentation
+- **DevContainer CLI guide** — dedicated Getting Started page for terminal-only workflows without VS Code
+- **v2 Migration Guide** — path changes, automatic migration, manual steps, breaking changes, and troubleshooting
+- Documented 4 previously undocumented agents in agents.md: implementer, investigator, tester, documenter
+- Added missing git-workflow and prompt-snippets to configuration.md enabledPlugins example
+- Added CONFIG_SOURCE_DIR deprecation note in environment variables reference
+- Added cc-orc orchestrator command to first-session launch commands table
+- Tabbed client-specific instructions on the installation page
+- Dedicated port forwarding reference page covering VS Code auto-detect, devcontainer-bridge, and SSH tunneling
+
 ### Changed
 
 #### Performance
@@ -14,22 +26,14 @@
 - Dynamic port forwarding for all ports in VS Code — previously only port 7847 was statically forwarded; now all ports auto-forward with notification
 
 #### Documentation
-- Added **DevContainer CLI guide** — dedicated Getting Started page for terminal-only workflows without VS Code
-- Added **v2 Migration Guide** — path changes, automatic migration, manual steps, breaking changes, and troubleshooting
 - Updated **Port Forwarding reference** — VS Code dependency warning, devcontainer-bridge platform support matrix, CLI guide cross-link
 - Slimmed **Installation page** — moved troubleshooting to dedicated reference page, CLI details to new CLI guide
 - Full documentation review — accuracy, consistency, and completeness fixes across all 30+ pages
-- Documented 4 previously undocumented agents in agents.md: implementer, investigator, tester, documenter
 - Trimmed disabled ccms usage section from commands reference
 - Clarified codeforge-lsp plugin description (declarative config, not "no configuration")
 - Improved magic-docs agent explanation in agent-system plugin docs
 - Clarified plugin count as "13 local + 1 official" in reference index
-- Added missing git-workflow and prompt-snippets to configuration.md enabledPlugins example
-- Added CONFIG_SOURCE_DIR deprecation note in environment variables reference
-- Added cc-orc orchestrator command to first-session launch commands table
 - Updated prerequisites and installation docs to support all DevContainer clients (VS Code, CLI, JetBrains Gateway, DevPod, Codespaces)
-- Added tabbed client-specific instructions on the installation page
-- Added dedicated port forwarding reference page covering VS Code auto-detect, devcontainer-bridge, and SSH tunneling
 - **Ported `.devcontainer/docs/` to docs site** — migrated content from 5 legacy reference docs into the Starlight documentation site:
   - New **Keybindings** page (Customization) — VS Code/Claude Code shortcut conflicts and resolution options
   - New **Troubleshooting** page (Reference) — 12+ problem/solution entries for build, auth, plugins, and performance issues

docs/src/content/docs/features/agents.md

@@ -30,7 +30,7 @@ CodeForge **entirely replaces** all six built-in agents with enhanced custom spe
 
 The redirect is fully transparent — you can use either the built-in name or the custom name interchangeably. Asking Claude to "explore the codebase" triggers the same enhanced explorer agent whether the system selects the `Explore` type or the `explorer` type.
 
-Beyond the six replacements, CodeForge adds **15 entirely new specialists** that have no built-in equivalent: architect, debug-logs, dependency-analyst, doc-writer, documenter, git-archaeologist, implementer, investigator, migrator, perf-profiler, refactorer, researcher, security-auditor, spec-writer, tester, and test-writer. These are available only in CodeForge.
+Beyond the six replacements, CodeForge adds **15 entirely new specialists** that have no built-in equivalent: debug-logs, dependency-analyst, doc-writer, documenter, git-archaeologist, implementer, investigator, migrator, perf-profiler, refactorer, researcher, security-auditor, spec-writer, tester, and test-writer. These are available only in CodeForge.
 
 :::tip[Why This Matters]
 The redirect happens at the hook level, not the prompt level. This means the upgrade is enforced — not suggested. Even if Claude's internal routing tries to use a stock Explore agent, the hook intercepts the call and swaps in the enhanced explorer before any code executes. The result is a strictly better agent every time, with zero user effort.

docs/src/content/docs/getting-started/devcontainer-cli.md

@@ -13,7 +13,7 @@ The DevContainer CLI lets you build and run CodeForge containers without VS Code
 npm install -g @devcontainers/cli
 ```
 
-Requires Node.js 18+. Verify the installation with `devcontainer --version`.
+Requires Node.js 16.13+ or 18+ (when installing via npm). Verify the installation with `devcontainer --version`.
 
 ## Build and Start
 

docs/src/content/docs/reference/troubleshooting.md

@@ -13,7 +13,7 @@ Solutions for common issues with the CodeForge devcontainer. If your problem isn
 
 - **Node.js not installed** — the installer requires Node.js 18+ and npm. Run `node --version` to check; install from [nodejs.org](https://nodejs.org/) if missing.
 - **Network issues** — npm needs to reach the registry. Check your connection or try `npm config set registry https://registry.npmjs.org/`.
-- **Permission errors** — on some systems, global npm installs need `sudo`. Try `npx --yes codeforge-dev` or install globally with `sudo npm install -g codeforge-dev`.
+- **Permission errors** — prefer `npx --yes codeforge-dev` to avoid global install permission issues. If you need global installs, configure your npm prefix or use a Node version manager (e.g., nvm) instead of `sudo`.
 
 **Problem: VS Code doesn't show "Reopen in Container".**