[Bugfix] Align module docs with current CLI surface

docs/adapters/azuredevops.md

@@ -64,7 +64,7 @@ The adapter automatically derives work item type from your project's process tem
 You can override with `--ado-work-item-type`:
 
 ```bash
-specfact sync bridge --adapter ado --mode export-only \
+specfact project sync bridge --adapter ado --mode export-only \
   --ado-org your-org \
   --ado-project your-project \
   --ado-work-item-type "Bug" \
@@ -434,7 +434,7 @@ This handles cases where:
 
 ```bash
 # Export OpenSpec change proposals to Azure DevOps work items
-specfact sync bridge --adapter ado --mode export-only \
+specfact project sync bridge --adapter ado --mode export-only \
   --ado-org your-org \
   --ado-project your-project \
   --repo /path/to/openspec-repo
@@ -444,7 +444,7 @@ specfact sync bridge --adapter ado --mode export-only \
 
 ```bash
 # Import work items AND export proposals
-specfact sync bridge --adapter ado --bidirectional \
+specfact project sync bridge --adapter ado --bidirectional \
   --ado-org your-org \
   --ado-project your-project \
   --repo /path/to/openspec-repo
@@ -454,7 +454,7 @@ specfact sync bridge --adapter ado --bidirectional \
 
 ```bash
 # Import specific work items into bundle
-specfact sync bridge --adapter ado --mode bidirectional \
+specfact project sync bridge --adapter ado --mode bidirectional \
   --ado-org your-org \
   --ado-project your-project \
   --bundle main \
@@ -466,7 +466,7 @@ specfact sync bridge --adapter ado --mode bidirectional \
 
 ```bash
 # Update existing work item with latest proposal content
-specfact sync bridge --adapter ado --mode export-only \
+specfact project sync bridge --adapter ado --mode export-only \
   --ado-org your-org \
   --ado-project your-project \
   --change-ids add-feature-x \
@@ -478,7 +478,7 @@ specfact sync bridge --adapter ado --mode export-only \
 
 ```bash
 # Detect code changes and add progress comments
-specfact sync bridge --adapter ado --mode export-only \
+specfact project sync bridge --adapter ado --mode export-only \
   --ado-org your-org \
   --ado-project your-project \
   --track-code-changes \
@@ -490,7 +490,7 @@ specfact sync bridge --adapter ado --mode export-only \
 
 ```bash
 # Export from bundle to ADO (uses stored lossless content)
-specfact sync bridge --adapter ado --mode export-only \
+specfact project sync bridge --adapter ado --mode export-only \
   --ado-org your-org \
   --ado-project your-project \
   --bundle main \

docs/adapters/github.md

@@ -334,14 +334,14 @@ To create a GitHub issue from an OpenSpec change and have the issue number/URL w
 
 ```bash
 # Export one or more changes; creates issues and updates proposal.md Source Tracking
-specfact sync bridge --adapter github --mode export-only \
+specfact project sync bridge --adapter github --mode export-only \
   --repo . \
   --repo-owner nold-ai \
   --repo-name specfact-cli \
   --change-ids <change-id>
 
 # Example: export backlog-scrum-05-summarize-markdown-output
-specfact sync bridge --adapter github --mode export-only \
+specfact project sync bridge --adapter github --mode export-only \
   --repo . \
   --repo-owner nold-ai \
   --repo-name specfact-cli \
@@ -362,15 +362,15 @@ When you improve comment logic or branch detection, use `--include-archived` to
 
 ```bash
 # Update all archived proposals with new comment logic
-specfact sync bridge --adapter github --mode export-only \
+specfact project sync bridge --adapter github --mode export-only \
   --repo-owner your-org \
   --repo-name your-repo \
   --include-archived \
   --update-existing \
   --repo /path/to/openspec-repo
 
 # Update specific archived proposal
-specfact sync bridge --adapter github --mode export-only \
+specfact project sync bridge --adapter github --mode export-only \
   --repo-owner your-org \
   --repo-name your-repo \
   --change-ids add-code-change-tracking \

docs/getting-started/README.md

@@ -25,7 +25,7 @@ SpecFact runs on a lifecycle-managed module system.
 
 ```bash
 # CLI-only mode (works with uvx, no installation needed)
-uvx specfact-cli@latest code import my-project --repo .
+uvx specfact-cli@latest code import --repo . my-project
 
 # Interactive AI Assistant mode (requires pip install + specfact init)
 # See First Steps guide for IDE integration setup
@@ -34,21 +34,21 @@ uvx specfact-cli@latest code import my-project --repo .
 **For New Projects**:
 
 ```bash
-# CLI-only mode (bundle name as positional argument)
-uvx specfact-cli@latest plan init my-project --interactive
-
-# Interactive AI Assistant mode (recommended for better results)
-# Requires: pip install specfact-cli && specfact init
+# Install a project-oriented bundle first, then inspect the mounted workflow surface
+specfact module install nold-ai/specfact-project
+specfact project --help
 ```
 
 **Note**: Interactive AI Assistant mode provides better feature detection and semantic understanding, but requires `pip install specfact-cli` and IDE setup. CLI-only mode works immediately with `uvx` but may show 0 features for simple test cases.
 
 ### Migration Note (0.40.0)
 
-Flat root commands were removed. Use grouped command forms:
+Flat root commands were removed. Use the mounted grouped command forms:
 
-- `specfact validate ...` -> `specfact validate sidecar ...`
-- `specfact plan ...` (old flat shim) -> `specfact plan ...` (project bundle commands)
+- `specfact validate ...` -> `specfact code validate ...`
+- `specfact code repro ...` -> `specfact code repro ...`
+- `specfact sync ...` -> `specfact project sync ...`
+- `specfact govern enforce ...` -> `specfact govern enforce ...`
 - `specfact policy ...` -> `specfact backlog policy ...`
 
 First-run bundle selection examples: