Merge pull request #119 from nold-ai/feature/speckit-03-change-proposal-bridge

Add Speckit change proposal bridge

Author: djm81

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 project sync bridge --adapter ado --mode export-only \
+specfact 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 project sync bridge --adapter ado --mode export-only \
+specfact 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 project sync bridge --adapter ado --mode export-only \
 
 ```bash
 # Import work items AND export proposals
-specfact project sync bridge --adapter ado --bidirectional \
+specfact sync bridge --adapter ado --bidirectional \
   --ado-org your-org \
   --ado-project your-project \
   --repo /path/to/openspec-repo
@@ -454,7 +454,7 @@ specfact project sync bridge --adapter ado --bidirectional \
 
 ```bash
 # Import specific work items into bundle
-specfact project sync bridge --adapter ado --mode bidirectional \
+specfact sync bridge --adapter ado --mode bidirectional \
   --ado-org your-org \
   --ado-project your-project \
   --bundle main \
@@ -466,7 +466,7 @@ specfact project sync bridge --adapter ado --mode bidirectional \
 
 ```bash
 # Update existing work item with latest proposal content
-specfact project sync bridge --adapter ado --mode export-only \
+specfact 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 project sync bridge --adapter ado --mode export-only \
 
 ```bash
 # Detect code changes and add progress comments
-specfact project sync bridge --adapter ado --mode export-only \
+specfact sync bridge --adapter ado --mode export-only \
   --ado-org your-org \
   --ado-project your-project \
   --track-code-changes \
@@ -490,7 +490,7 @@ specfact project sync bridge --adapter ado --mode export-only \
 
 ```bash
 # Export from bundle to ADO (uses stored lossless content)
-specfact project sync bridge --adapter ado --mode export-only \
+specfact 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 project sync bridge --adapter github --mode export-only \
+specfact 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 project sync bridge --adapter github --mode export-only \
+specfact 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 project sync bridge --adapter github --mode export-only \
+specfact 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 project sync bridge --adapter github --mode export-only \
+specfact sync bridge --adapter github --mode export-only \
   --repo-owner your-org \
   --repo-name your-repo \
   --change-ids add-code-change-tracking \

docs/bundles/backlog/refinement.md

@@ -555,7 +555,7 @@ The most common workflow is to refine backlog items and then sync them to extern
 **Workflow**: `backlog ceremony refinement` → `sync bridge`
 
 1. **Refine Backlog Items**: Use `specfact backlog ceremony refinement` to standardize backlog items with templates
-2. **Sync to External Tools**: Use `specfact project sync bridge` to sync refined items back to backlog tools (GitHub, ADO, etc.)
+2. **Sync to External Tools**: Use `specfact sync bridge` to sync refined items back to backlog tools (GitHub, ADO, etc.)
 
 ```bash
 # Complete command chaining workflow
@@ -567,7 +567,7 @@ specfact backlog ceremony refinement github \
   --state open
 
 # 2. Sync refined items to external tool (same or different adapter)
-specfact project sync bridge --adapter github \
+specfact sync bridge --adapter github \
   --repo-owner my-org --repo-name my-repo \
   --backlog-ids 123,456 \
   --mode export-only
@@ -578,7 +578,7 @@ specfact backlog ceremony refinement github \
   --write \
   --labels feature
 
-specfact project sync bridge --adapter ado \
+specfact sync bridge --adapter ado \
   --ado-org my-org --ado-project my-project \
   --backlog-ids 123,456 \
   --mode export-only
@@ -614,12 +614,12 @@ When syncing backlog items between different adapters (e.g., GitHub ↔ ADO), Sp
 
 ```bash
 # 1. Import closed GitHub issues into bundle (state "closed" is preserved)
-specfact project sync bridge --adapter github --mode bidirectional \
+specfact sync bridge --adapter github --mode bidirectional \
   --repo-owner nold-ai --repo-name specfact-cli \
   --backlog-ids 110,122
 
 # 2. Export to ADO (state is automatically mapped: closed → Closed)
-specfact project sync bridge --adapter ado --mode export-only \
+specfact sync bridge --adapter ado --mode export-only \
   --ado-org dominikusnold --ado-project "SpecFact CLI" \
   --bundle cross-sync-test --change-ids add-ado-backlog-adapter,add-template-driven-backlog-refinement
 
@@ -646,14 +646,14 @@ specfact project sync bridge --adapter ado --mode export-only \
 
 Backlog refinement works seamlessly with the [DevOps Adapter Integration](/integrations/devops-adapter-overview/):
 
-1. **Import Backlog Items**: Use `specfact project sync bridge` to import backlog items as OpenSpec proposals
+1. **Import Backlog Items**: Use `specfact sync bridge` to import backlog items as OpenSpec proposals
 2. **Refine Items**: Use `specfact backlog ceremony refinement` to standardize imported items
-3. **Export Refined Items**: Use `specfact project sync bridge` to export refined proposals back to backlog tools
+3. **Export Refined Items**: Use `specfact sync bridge` to export refined proposals back to backlog tools
 
 ```bash
 # Complete workflow
 # 1. Import GitHub issues as OpenSpec proposals
-specfact project sync bridge --adapter github --mode bidirectional \
+specfact sync bridge --adapter github --mode bidirectional \
   --repo-owner my-org --repo-name my-repo \
   --backlog-ids 123,456
 
@@ -662,7 +662,7 @@ specfact backlog ceremony refinement github --bundle my-project --auto-bundle \
   --search "is:open"
 
 # 3. Export refined proposals back to GitHub
-specfact project sync bridge --adapter github --mode export-only \
+specfact sync bridge --adapter github --mode export-only \
   --bundle my-project --change-ids <refined-change-id>
 ```
 
@@ -937,11 +937,11 @@ If adapter search methods are not available:
 # "Note: GitHub issue fetching requires adapter.search_issues() implementation"
 ```
 
-**Workaround**: Use `specfact project sync bridge` to import backlog items first, then refine:
+**Workaround**: Use `specfact sync bridge` to import backlog items first, then refine:
 
 ```bash
 # 1. Import backlog items
-specfact project sync bridge --adapter github --mode bidirectional \
+specfact sync bridge --adapter github --mode bidirectional \
   --backlog-ids 123,456
 
 # 2. Refine imported items from bundle

docs/bundles/govern/patch.md

@@ -38,5 +38,5 @@ specfact govern patch apply changes.patch --write --yes
 
 ## Related
 
-- [Govern enforce](enforce/)
-- [Govern bundle overview](overview/)
+- [Govern enforce](/bundles/govern/enforce/)
+- [Govern bundle overview](/bundles/govern/overview/)

docs/getting-started/first-steps.md

@@ -22,7 +22,7 @@ Use the current mounted entrypoints instead:
 When you need exact syntax, verify against live help in the current release, for example:
 
 ```bash
-specfact project sync bridge --help
+specfact sync bridge --help
 specfact code repro --help
 specfact code validate sidecar --help
 specfact spec validate --help

docs/getting-started/installation.md

@@ -280,12 +280,12 @@ Convert an existing GitHub Spec-Kit project:
 
 ```bash
 # Start a one-time import
-specfact project sync bridge \
+specfact sync bridge \
   --adapter speckit \
   --repo ./my-speckit-project
 
 # Ongoing bidirectional sync (after migration)
-specfact project sync bridge --adapter speckit --bundle <bundle-name> --repo . --bidirectional --watch
+specfact sync bridge --adapter speckit --bundle <bundle-name> --repo . --bidirectional --watch
 ```
 
 **Bidirectional Sync:**
@@ -294,13 +294,13 @@ Keep Spec-Kit and SpecFact artifacts synchronized:
 
 ```bash
 # One-time sync
-specfact project sync bridge --adapter speckit --bundle <bundle-name> --repo . --bidirectional
+specfact sync bridge --adapter speckit --bundle <bundle-name> --repo . --bidirectional
 
 # Continuous watch mode
-specfact project sync bridge --adapter speckit --bundle <bundle-name> --repo . --bidirectional --watch
+specfact sync bridge --adapter speckit --bundle <bundle-name> --repo . --bidirectional --watch
 ```
 
-**Note**: SpecFact CLI uses a plugin-based adapter registry pattern. All adapters (Spec-Kit, OpenSpec, GitHub, etc.) are registered in `AdapterRegistry` and accessed via `specfact project sync bridge --adapter <adapter-name>`, making the architecture extensible for future tool integrations.
+**Note**: SpecFact CLI uses a plugin-based adapter registry pattern. All adapters (Spec-Kit, OpenSpec, GitHub, etc.) are registered in `AdapterRegistry` and accessed via `specfact sync bridge --adapter <adapter-name>`, making the architecture extensible for future tool integrations.
 
 ### For Brownfield Projects
 
@@ -383,7 +383,7 @@ specfact project sync repository --repo . --watch
 - **IDE integration**: Use `specfact init` to set up slash commands in IDE (requires pip install)
 - **Slash commands**: Use the IDE templates generated for your checkout and keep them aligned with the mounted CLI surface
 - **Global flags**: Place `--no-banner` before the command: `specfact --no-banner <command>`
-- **Bridge adapter sync**: Use `project sync bridge --adapter <adapter-name>` for external tool integration (Spec-Kit, OpenSpec, GitHub, etc.)
+- **Bridge adapter sync**: Use `sync bridge --adapter <adapter-name>` for external tool integration (Spec-Kit, OpenSpec, GitHub, etc.)
 - **Repository sync**: Use `project sync repository` for code change tracking
 - **Semgrep (optional)**: Install `pip install semgrep` for async pattern detection in `specfact code repro`
 

docs/getting-started/tutorial-daily-standup-sprint-review.md

@@ -213,6 +213,6 @@ supported. Use it with the **`specfact.backlog-daily`** slash prompt for interac
 
 ## Related Documentation
 
-- **[Agile/Scrum Workflows](../guides/agile-scrum-workflows.md)** — Daily standup, iteration/sprint, unassigned items, blockers-first
+- **[Agile/Scrum Workflows](/guides/agile-scrum-workflows/)** — Daily standup, iteration/sprint, unassigned items, blockers-first
 - **[DevOps Adapter Integration](/integrations/devops-adapter-overview/)** — Project backlog context (`.nold-ai/specfact-backlog.yaml`), env vars, **Git fallback (auto-detect from clone)** for GitHub and Azure DevOps
 - **[Backlog Refinement Guide](/bundles/backlog/refinement/)** — Template-driven refinement (complementary to daily standup)

docs/guides/README.md

@@ -29,14 +29,14 @@ Practical module-owned guides for official bundles, adapters, publishing, and wo
 
 - **[IDE Integration](ide-integration.md)** - Set up slash commands in your IDE
 - **[CoPilot Mode](copilot-mode.md)** - Using `--mode copilot` on CLI commands
-- **[DevOps Adapter Integration](/integrations/devops-adapter-overview/)** - Integrate with GitHub Issues, Azure DevOps, Linear, Jira for backlog tracking
-- **[Backlog Refinement](/bundles/backlog/refinement/)** - AI-assisted template-driven refinement with filtering and DoR checks
+- **[DevOps Adapter Integration](integrations/devops-adapter-overview/)** - Integrate with GitHub Issues, Azure DevOps, Linear, Jira for backlog tracking
+- **[Backlog Refinement](bundles/backlog/refinement/)** - AI-assisted template-driven refinement with filtering and DoR checks
 - **[Specmatic Integration](specmatic-integration.md)** - API contract testing with Specmatic
 - **[Troubleshooting](troubleshooting.md)** - Common issues and solutions
 - **[Installing Modules](installing-modules.md)** - Install, list, show, search, enable/disable, uninstall, and upgrade modules
 - **[Module Marketplace](module-marketplace.md)** - Discovery priority, trust vs origin semantics, and security model
-- **[Custom registries](/authoring/custom-registries/)** - Add, list, remove registries; trust levels and priority
-- **[Publishing modules](/authoring/publishing-modules/)** - Package, sign, and publish modules to a registry
+- **[Custom registries](authoring/custom-registries/)** - Add, list, remove registries; trust levels and priority
+- **[Publishing modules](authoring/publishing-modules/)** - Package, sign, and publish modules to a registry
 - **[Module Signing and Key Rotation](module-signing-and-key-rotation.md)** - Public key placement, signing workflow, CI verification, rotation, and revocation runbook
 - **[Competitive Analysis](competitive-analysis.md)** - How SpecFact compares to other tools
 - **[Operational Modes](../reference/modes.md)** - CI/CD vs CoPilot modes

docs/guides/ai-ide-workflow.md

@@ -40,7 +40,7 @@ Examples:
 ```bash
 specfact backlog ceremony refinement github --preview --labels feature
 specfact code review run src --scope changed --no-tests
-specfact project sync bridge --adapter github --mode export-only --repo . --bundle legacy-api
+specfact sync bridge --adapter github --mode export-only --repo . --bundle legacy-api
 ```
 
 These commands are the source of truth. The IDE should support them, not replace them.

docs/guides/brownfield-examples.md

@@ -27,7 +27,7 @@ Use this when backlog items must be refined before the modernization work is syn
 ```bash
 specfact backlog ceremony refinement github --preview --labels feature
 specfact backlog verify-readiness --adapter github --project-id owner/repo --target-items 123
-specfact project sync bridge --adapter github --mode export-only --repo . --bundle legacy-api
+specfact sync bridge --adapter github --mode export-only --repo . --bundle legacy-api
 ```
 
 Outcome: backlog items are standardized before they drive bundle changes.